Интеграция с ИИ-агентами

Двухуровневая архитектура

Традиционные платформы хостинга GIF предоставляют изображения — двоичные данные, которые ИИ-агенты не могут интерпретировать. AgentGIF решает эту проблему, прикрепляя машиночитаемый уровень к каждому GIF:

ИИ-агент может просмотреть страницу GIF и понять точно, какие команды были выполнены, каков был вывод и сколько времени занял каждый шаг — всё это без OCR или компьютерного зрения.

.md Эндпоинты

Добавьте .md к любому URL AgentGIF, чтобы получить ответ text/markdown, оптимизированный для LLM. Это самый быстрый способ для ИИ-агента понять содержимое страницы.

# 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

Ответ представляет собой структурированный документ Markdown с заголовком, описанием, метаданными и соответствующими ссылками. Content-Type: text/markdown; charset=utf-8.

Каждая страница AgentGIF поддерживает суффикс .md — для агентов нет тупиков.

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/

Формат ответа:

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

Каждое событие является кортежем: [timestamp_seconds, event_type, data]

• "o" — вывод (текст, записанный в терминал)
• "i" — ввод (нажатия клавиш, если записаны)

Разберите cast-файл для извлечения точных выполненных команд, их вывода и информации о времени. Заголовок env сообщает оболочку и тип терминала.

Расшифровки

Для более простых случаев использования эндпоинт расшифровки возвращает обычный текст с удалёнными ANSI-кодами:

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

Ответ:

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

Расшифровки идеально подходят для индексации поиска, встраивания в контекстные окна LLM и быстрого извлечения контента.

Структурированный JSON API

REST API возвращает полные метаданные для каждого 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.

Для массовых операций используйте эндпоинты списка и поиска:

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

Обнаружение и сканирование

ИИ-агенты могут обнаруживать GIF через несколько каналов:

Файл robots.txt разрешает всем краулерам — AgentGIF приветствует ИИ-агентов.

Варианты использования для ИИ-агентов

Генерация документации

ИИ-агент может искать GIF по имени инструмента, получать cast-файл и автоматически генерировать документацию со встроенными демо:

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

Сборка обучающих материалов

Агенты могут просматривать коллекции связанных GIF и составлять пошаговые руководства с правильным порядком и контекстом.

Помощь в проверке кода

Когда PR содержит GIF-демо, ИИ-агент может получить cast-файл, разобрать команды и проверить, соответствуют ли они описанию PR.

Обнаружение CLI-инструментов

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