Integrasi Agen AI

Arsitektur Dua Lapis

Platform hosting GIF tradisional menyajikan gambar — blob biner yang tidak dapat diinterpretasikan oleh agen AI. AgentGIF mengatasi ini dengan melampirkan lapisan mesin ke setiap GIF:

Agen AI dapat melihat halaman GIF dan memahami persis perintah apa yang dijalankan, apa outputnya, dan berapa lama setiap langkah memerlukan waktu — semuanya tanpa OCR atau computer vision.

Endpoint .md

Tambahkan .md ke URL AgentGIF mana pun untuk mendapatkan respons text/markdown yang dioptimalkan untuk LLM. Ini adalah cara tercepat bagi agen AI untuk memahami isi halaman.

# GIF detail page
curl https://agentgif.com/@agentgif/docker-compose/.md

# Tag page
curl https://agentgif.com/explore/tags/git/.md

# Guide page
curl https://agentgif.com/guides/how-to-record-terminal-gif/.md

# Search results
curl https://agentgif.com/search/.md

Responsnya adalah dokumen Markdown terstruktur dengan judul, deskripsi, metadata, dan tautan yang relevan. Content-Type: text/markdown; charset=utf-8.

Setiap halaman di AgentGIF mendukung sufiks .md — tidak ada jalan buntu bagi agen.

File Cast (Asciinema v2)

The cast file is the richest machine layer. It's an asciinema v2 recording — a JSON header followed by timestamped terminal events:

GET /api/v1/gifs/{id}/cast/

Format respons:

{"version": 2, "width": 120, "height": 40, "timestamp": 1710000000, "env": {"SHELL": "/bin/zsh", "TERM": "xterm-256color"}}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]
[3.1, "o", "Container db-1   Started\r\n"]

Setiap event adalah tuple: [timestamp_seconds, event_type, data]

• "o" — output (teks yang ditulis ke terminal)
• "i" — input (penekanan tombol, jika direkam)

Urai file cast untuk mengekstrak perintah yang dijalankan, outputnya, dan informasi waktu. Header env memberi tahu Anda jenis shell dan terminal.

Transkrip

Untuk kasus penggunaan yang lebih sederhana, endpoint transkrip mengembalikan teks biasa dengan kode ANSI dihapus:

GET /api/v1/gifs/{id}/transcript/

Respons:

$ docker compose up -d
Creating network...
Container app-1  Started
Container db-1   Started

Transkrip ideal untuk pengindeksan pencarian, penyematan dalam jendela konteks LLM, dan ekstraksi konten cepat.

API JSON Terstruktur

REST API mengembalikan metadata lengkap untuk setiap GIF:

GET /api/v1/gifs/{id}/

This includes title, command, tags, shell, theme, file dimensions, embed codes, and download URLs — everything an agent needs to understand and reference the GIF. See the full API reference.

Untuk operasi massal, gunakan endpoint daftar dan pencarian:

# Find all GIFs about Docker
GET /api/v1/search/?q=docker

# Browse by tag
GET /api/v1/tags/kubernetes/gifs/

# Featured GIFs (curated quality)
GET /api/v1/featured/

llms.txt

The /llms.txt file provides a site-level summary optimized for AI crawlers. It describes what AgentGIF is, lists all API endpoints, and explains how to discover and consume content.

This follows the llms.txt convention — a lightweight alternative to sitemaps for AI agents that want to understand a site's structure quickly.

Penemuan & Crawling

Agen AI dapat menemukan GIF melalui beberapa saluran:

robots.txt mengizinkan semua crawler — AgentGIF menyambut agen AI.

Kasus Penggunaan untuk Agen AI

Pembuatan Dokumentasi

Agen AI dapat mencari GIF berdasarkan nama alat, mengambil file cast, dan secara otomatis menghasilkan dokumentasi dengan demo yang disematkan:

# Find a demo for "git rebase"
curl -s "https://agentgif.com/api/v1/search/?q=git+rebase" | jq '.results[0]'

# Get the cast file for step-by-step extraction
curl -s "https://agentgif.com/api/v1/gifs/xK9mQ2pL/cast/"

Penyusunan Tutorial

Agen dapat menelusuri koleksi GIF terkait dan menyusun tutorial langkah demi langkah dengan urutan dan konteks yang benar.

Bantuan Tinjauan Kode

Ketika PR menyertakan demo GIF, agen AI dapat mengambil file cast, mengurai perintah, dan memverifikasi bahwa perintah tersebut sesuai dengan deskripsi PR.

Penemuan Alat CLI

The tools directory catalogs CLI tools with associated GIF demos. Agents can browse tools by category and find real-world usage examples.