Integración con agentes de IA

La arquitectura de doble capa

Las plataformas tradicionales de alojamiento de GIFs sirven imágenes — blobs binarios que los agentes de IA no pueden interpretar. AgentGIF resuelve esto adjuntando una capa máquina a cada GIF:

Un agente de IA puede ver una página de GIF y entender exactamente qué comandos se ejecutaron, cuál fue la salida y cuánto tardó cada paso — todo sin OCR ni visión por computadora.

Endpoints .md

Añade .md a cualquier URL de AgentGIF para obtener una respuesta text/markdown optimizada para LLMs. Esta es la forma más rápida para que un agente de IA entienda qué hay en una página.

# 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

La respuesta es un documento Markdown estructurado con título, descripción, metadatos y enlaces relevantes. Content-Type: text/markdown; charset=utf-8.

Cada página de AgentGIF admite el sufijo .md — no hay callejones sin salida para los agentes.

Archivos 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/

Formato de respuesta:

{"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"]

Cada evento es una tupla: [timestamp_seconds, event_type, data]

• "o" — salida (texto escrito en el terminal)
• "i" — entrada (pulsaciones de teclas, si se grabó)

Analiza el archivo cast para extraer los comandos exactos ejecutados, su salida e información de temporización. La cabecera env indica el shell y el tipo de terminal.

Transcripciones

Para casos de uso más simples, el endpoint de transcripción devuelve texto plano con los códigos ANSI eliminados:

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

Respuesta:

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

Las transcripciones son ideales para indexación en búsqueda, incrustación en ventanas de contexto de LLM y extracción rápida de contenido.

API JSON estructurada

La API REST devuelve metadatos completos para cada 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.

Para operaciones masivas, usa los endpoints de listado y búsqueda:

# 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.

Descubrimiento y rastreo

Los agentes de IA pueden descubrir GIFs a través de múltiples canales:

El robots.txt permite todos los rastreadores — AgentGIF da la bienvenida a los agentes de IA.

Casos de uso para agentes de IA

Generación de documentación

Un agente de IA puede buscar GIFs por nombre de herramienta, recuperar el archivo cast y generar automáticamente documentación con demostraciones incrustadas:

# 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/"

Ensamblaje de tutoriales

Los agentes pueden navegar por colecciones de GIFs relacionados y ensamblar tutoriales paso a paso con el orden y contexto correctos.

Asistencia en revisión de código

Cuando un PR incluye una demostración en GIF, un agente de IA puede obtener el archivo cast, analizar los comandos y verificar que coincidan con la descripción del PR.

Descubrimiento de herramientas CLI

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