Integração com Agente de IA

A Arquitetura de Camada Dupla

As plataformas tradicionais de hospedagem de GIF servem imagens — blobs binários que agentes de IA não conseguem interpretar. O AgentGIF resolve isso anexando uma camada de máquina a cada GIF:

Um agente de IA pode olhar para uma página de GIF e entender exatamente quais comandos foram executados, qual foi a saída e quanto tempo cada etapa levou — tudo sem OCR ou visão computacional.

Endpoints .md

Adicione .md a qualquer URL do AgentGIF para obter uma resposta text/markdown otimizada para LLMs. Esta é a maneira mais rápida para um agente de IA entender o que está em uma 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

A resposta é um documento Markdown estruturado com título, descrição, metadados e links relevantes. Content-Type: text/markdown; charset=utf-8.

Cada página no AgentGIF suporta o sufixo .md — não há becos sem saída para agentes.

Arquivos 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 resposta:

{"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 é uma tupla: [timestamp_seconds, event_type, data]

• "o" — saída (texto gravado no terminal)
• "i" — entrada (teclas pressionadas, se gravadas)

Analise o arquivo cast para extrair os comandos exatos executados, sua saída e informações de tempo. O cabeçalho env informa o shell e o tipo de terminal.

Transcrições

Para casos de uso mais simples, o endpoint de transcrição retorna texto simples com os códigos ANSI removidos:

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

Resposta:

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

As transcrições são ideais para indexação de pesquisa, incorporação em janelas de contexto de LLM e extração rápida de conteúdo.

API JSON Estruturada

A REST API retorna metadados 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 operações em massa, use os endpoints de listagem e pesquisa:

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

Descoberta e Rastreamento

Agentes de IA podem descobrir GIFs por múltiplos canais:

O robots.txt permite todos os crawlers — o AgentGIF dá boas-vindas a agentes de IA.

Casos de Uso para Agentes de IA

Geração de Documentação

Um agente de IA pode pesquisar GIFs pelo nome da ferramenta, recuperar o arquivo cast e gerar automaticamente documentação com demos incorporadas:

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

Montagem de Tutorial

Os agentes podem navegar por coleções de GIFs relacionados e montar tutoriais passo a passo com a ordem e o contexto corretos.

Assistência para Revisão de Código

Quando um PR inclui uma demo em GIF, um agente de IA pode buscar o arquivo cast, analisar os comandos e verificar se eles correspondem à descrição do PR.

Descoberta de Ferramentas CLI

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