Intégration des agents IA

L'architecture double couche

Les plateformes d'hébergement GIF traditionnelles servent des images — des blobs binaires que les agents IA ne peuvent pas interpréter. AgentGIF résout ce problème en associant une couche machine à chaque GIF :

Un agent IA peut consulter une page GIF et comprendre exactement quelles commandes ont été exécutées, quelle était la sortie et combien de temps a pris chaque étape — le tout sans OCR ni vision par ordinateur.

Points d'accès .md

Ajoutez .md à n'importe quelle URL AgentGIF pour obtenir une réponse text/markdown optimisée pour les LLM. C'est le moyen le plus rapide pour un agent IA de comprendre le contenu d'une page.

# 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 réponse est un document Markdown structuré avec titre, description, métadonnées et liens pertinents. Content-Type : text/markdown; charset=utf-8.

Chaque page d'AgentGIF prend en charge le suffixe .md — il n'y a pas d'impasse pour les agents.

Fichiers 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 de réponse :

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

Chaque événement est un tuple : [timestamp_seconds, event_type, data]

• "o" — sortie (texte écrit dans le terminal)
• "i" — entrée (frappes clavier, si enregistrées)

Analysez le fichier cast pour extraire les commandes exactes exécutées, leur sortie et les informations de timing. L'en-tête env indique le shell et le type de terminal.

Transcriptions

Pour les cas d'utilisation plus simples, le point d'accès de transcription renvoie du texte brut sans codes ANSI :

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

Réponse :

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

Les transcriptions sont idéales pour l'indexation de recherche, l'intégration dans les fenêtres de contexte LLM et l'extraction rapide de contenu.

API JSON structurée

L'API REST renvoie les métadonnées complètes pour chaque 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.

Pour les opérations en masse, utilisez les points d'accès de liste et de recherche :

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

Découverte et exploration

Les agents IA peuvent découvrir des GIF via plusieurs canaux :

Le robots.txt autorise tous les robots — AgentGIF accueille les agents IA.

Cas d'utilisation pour les agents IA

Génération de documentation

Un agent IA peut rechercher des GIF par nom d'outil, récupérer le fichier cast et générer automatiquement de la documentation avec des démos intégrées :

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

Assemblage de tutoriels

Les agents peuvent parcourir des collections de GIF associés et assembler des tutoriels pas à pas avec le bon ordre et le contexte approprié.

Assistance à la revue de code

Quand une PR inclut une démo GIF, un agent IA peut récupérer le fichier cast, analyser les commandes et vérifier qu'elles correspondent à la description de la PR.

Découverte d'outils CLI

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