Часто задаваемые вопросы

Что такое AgentGIF?

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

Человек видит анимированную запись терминала. ИИ-агент видит структурированные данные: команды, вывод, временные метки и метаданные.

AgentGIF бесплатный?

Да. Загрузка, хостинг и встраивание GIF полностью бесплатны. REST API бесплатен для операций чтения без аутентификации. Операции записи (загрузка, редактирование, удаление) требуют бесплатный API-ключ со страницы настроек.

Что такое cast-файл?

Cast-файл — это запись asciinema v2. Это текстовый формат, где строка 1 является JSON-заголовком с метаданными терминала, за которым следуют кортежи событий с временными метками:

{"version": 2, "width": 120, "height": 40}
[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"]

Каждый кортеж имеет вид [timestamp_seconds, event_type, data]. Это позволяет ИИ-агентам извлекать команды, вывод и тайминг без OCR.

Как загрузить GIF?

Два варианта:

• Веб: Перетащите на /upload/ (требуется вход через GitHub)
• CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI доступен для 5 языков: Python, Node.js, Go, Rust и Ruby. Включите флаг --cast demo.cast, чтобы прикрепить машиночитаемый уровень.

Как встроить GIF в мой README?

Рекомендуемый паттерн для GitHub README:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

Замените ID 8-символьным ID вашего GIF. Смотрите полное руководство по встраиванию для всех 6 методов.

Что такое эндпоинт .md?

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

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

Нужен ли мне API-ключ?

Получите бесплатный API-ключ на /settings/ после входа через GitHub.

Какие терминальные темы доступны?

AgentGIF поддерживает все 44 терминальные темы VHS. Популярные варианты:

Просматривайте все темы с живыми предпросмотрами: Галерея тем.

Что такое сервис бейджей?

AgentGIF предоставляет бейджи пакетов в терминальном стиле как альтернативу shields.io. Они отображаются с цветами выбранной вами терминальной темы.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Поддерживаемые провайдеры: PyPI, npm, crates.io, GitHub. Настройте с параметрами ?theme= и ?style=. Смотрите площадку для бейджей.

Как ИИ-агенты читают GIF?

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

• Cast-файлы: GET /api/v1/gifs/{id}/cast/ — полная запись asciinema v2 с временными метками
• Расшифровки: GET /api/v1/gifs/{id}/transcript/ — чистый обычный текст, ANSI-коды удалены
• эндпоинты .md: Добавьте .md к URL любой страницы для вывода Markdown
• JSON API: /api/v1/search/?q=docker — полнотекстовый поиск со структурированными результатами
• llms.txt: /llms.txt — сводка на уровне сайта для ИИ-краулеров

Смотрите полную документацию по интеграции ИИ-агентов.

Какие форматы файлов поддерживаются?

Для лучших результатов держите GIF в пределах 5 МБ. Смотрите руководство по записи для советов по оптимизации.

Как записать терминальный GIF?

Мы рекомендуем VHS от Charm для сценарных, воспроизводимых записей:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Полные пошаговые инструкции: Как записать терминальный GIF.