AI Agent एकीकरण

दोहरी परत वास्तुकला

पारंपरिक GIF होस्टिंग प्लेटफॉर्म चित्र प्रदान करते हैं — बाइनरी blobs जिन्हें AI एजेंट व्याख्या नहीं कर सकते। AgentGIF इसे प्रत्येक GIF में एक मशीन परत जोड़कर हल करता है:

एक AI एजेंट GIF पेज देख सकता है और ठीक-ठीक समझ सकता है कि कौन से कमांड चलाए गए, आउटपुट क्या था, और प्रत्येक चरण में कितना समय लगा — OCR या कंप्यूटर विज़न के बिना।

.md Endpoints

LLM के लिए अनुकूलित text/markdown प्रतिक्रिया पाने के लिए किसी भी AgentGIF URL में .md जोड़ें। यह एक 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 प्रत्यय का समर्थन करता है — एजेंटों के लिए कोई बंद रास्ता नहीं है।

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

प्रत्येक इवेंट एक tuple है: [timestamp_seconds, event_type, data]

• "o" — आउटपुट (terminal पर लिखा गया पाठ)
• "i" — इनपुट (कीस्ट्रोक, यदि रिकॉर्ड किए गए)

चलाए गए सटीक कमांड, उनका आउटपुट और टाइमिंग जानकारी निकालने के लिए cast फ़ाइल पार्स करें। env header आपको shell और terminal प्रकार बताता है।

Transcript

सरल उपयोग के मामलों के लिए, transcript endpoint ANSI कोड हटाकर सादा पाठ लौटाता है:

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

प्रतिक्रिया:

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

Transcript खोज अनुक्रमण, LLM context windows में embed करने और त्वरित सामग्री निष्कर्षण के लिए आदर्श हैं।

संरचित 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.

बड़े पैमाने पर संचालन के लिए, सूची और खोज endpoints का उपयोग करें:

# 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 खोज सकते हैं:

robots.txt सभी क्रॉलर को अनुमति देता है — AgentGIF AI एजेंटों का स्वागत करता है।

AI एजेंटों के लिए उपयोग के मामले

दस्तावेज़ीकरण निर्माण

एक AI एजेंट टूल नाम से GIF खोज सकता है, cast फ़ाइल प्राप्त कर सकता है और embedded demo के साथ स्वचालित रूप से दस्तावेज़ीकरण बना सकता है:

# 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 demo शामिल होता है, तो एक AI एजेंट 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.