AI エージェント統合

AgentGIF はデュアルレイヤーアーキテクチャで構築されています: 人間向けの GIF、エージェント向けのキャスト。すべての GIF にはブラウザで再生されるビジュアルレイヤーと、AI エージェントが解析・検索・理解できる機械可読レイヤーがあります。

デュアルレイヤーアーキテクチャ

従来の GIF ホスティングプラットフォームは画像 — AI エージェントが解釈できないバイナリデータ — を提供します。AgentGIF はすべての GIF に マシンレイヤー を添付することでこれを解決します:

レイヤー形式対象用途
ビジュアルGIF / MP4人間ターミナルの動作を確認
マシンCast / Transcript / JSONAI エージェントコマンドを解析し、出力を理解し、ステップを抽出

AI エージェントは GIF ページを見て、どのコマンドが実行されたか、出力はどうだったか、各ステップにどれくらいかかったかを OCR やコンピュータビジョンなしで 正確に 理解できます。

.md エンドポイント

任意の AgentGIF URL に .md を追加すると、LLM 向けに最適化された text/markdown レスポンスを取得できます。これは AI エージェントがページの内容を理解するための最速の方法です。

# 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 サフィックスをサポートしています — エージェントにとって行き止まりはありません。

キャストファイル (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" — 入力 (キー入力、録画されている場合)

キャストファイルを解析して、実行された正確なコマンド、その出力、タイミング情報を抽出します。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.

発見とクロール

AI エージェントは複数のチャネルを通じて GIF を発見できます:

方法URL形式
サイトマップ/llms.txtプレーンテキストのサマリー
XML サイトマップ/sitemap.xml標準サイトマップ形式のすべての URL
RSS フィード/feed/RSS 2.0 形式の最新 GIF
Atom フィード/feed/atom/Atom 1.0 形式の最新 GIF
API リスト/api/v1/gifs/ページネーション付き JSON
検索/api/v1/search/?q=...全文検索 JSON
OpenAPI 仕様/api/openapi.jsonOpenAPI 3.1 スキーマ

robots.txt はすべてのクローラーを許可しています — AgentGIF は AI エージェントを歓迎します。

AI エージェントのユースケース

ドキュメント生成

AI エージェントはツール名で GIF を検索し、キャストファイルを取得して、埋め込みデモ付きのドキュメントを自動的に生成できます:

# 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 デモが含まれている場合、AI エージェントはキャストファイルを取得し、コマンドを解析して、PR の説明と一致するか確認できます。

CLI ツールの発見

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

← ドキュメントに戻る · AI エージェント可読 GIF ガイド →