Yapay Zeka Ajanı Entegrasyonu

Çift Katmanlı Mimari

Geleneksel GIF barındırma platformları görüntüler sunar — yapay zeka ajanlarının yorumlayamadığı ikili veri yığınları. AgentGIF, her GIF'e bir makine katmanı ekleyerek bunu çözer:

Bir yapay zeka ajanı, bir GIF sayfasına bakarak hangi komutların çalıştırıldığını, çıktının ne olduğunu ve her adımın ne kadar sürdüğünü tam olarak anlayabilir — OCR veya bilgisayarlı görü gerektirmeden.

.md Endpoint'leri

LLM'ler için optimize edilmiş bir text/markdown yanıtı almak için herhangi bir AgentGIF URL'sine .md ekleyin. Bu, bir yapay zeka ajanının sayfadaki içeriği anlamasının en hızlı yoludur.

# 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

Yanıt; başlık, açıklama, meta veri ve ilgili bağlantılar içeren yapılandırılmış bir Markdown belgesidir. Content-Type: text/markdown; charset=utf-8.

AgentGIF'teki her sayfa .md sonekini destekler — ajanlar için çıkmaz yol yoktur.

Cast Dosyaları (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/

Yanıt formatı:

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

Her olay bir demettir: [timestamp_seconds, event_type, data]

• "o" — çıktı (terminale yazılan metin)
• "i" — girdi (kaydedildiyse tuş vuruşları)

Çalıştırılan komutları, çıktılarını ve zamanlama bilgilerini çıkarmak için cast dosyasını ayrıştırın. env başlığı kabuk ve terminal türünü belirtir.

Dökümler

Daha basit kullanım senaryoları için döküm endpoint'i ANSI kodları temizlenmiş düz metin döndürür:

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

Yanıt:

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

Dökümler, arama indeksleme, LLM bağlam pencerelerine yerleştirme ve hızlı içerik çıkarma için idealdir.

Yapılandırılmış JSON API

REST API her GIF için tam meta veri döndürür:

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.

Toplu işlemler için listeleme ve arama endpoint'lerini kullanın:

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

Keşif ve Tarama

Yapay zeka ajanları GIF'leri birden fazla kanal aracılığıyla keşfedebilir:

robots.txt tüm tarayıcılara izin verir — AgentGIF yapay zeka ajanlarını memnuniyetle karşılar.

Yapay Zeka Ajanları için Kullanım Senaryoları

Dokümantasyon Oluşturma

Bir yapay zeka ajanı araç adına göre GIF arayabilir, cast dosyasını alabilir ve gömülü demolarla otomatik olarak dokümantasyon oluşturabilir:

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

Eğitim Oluşturma

Ajanlar ilgili GIF koleksiyonlarına göz atabilir ve doğru sıralama ve bağlamla adım adım eğitimler oluşturabilir.

Kod İnceleme Yardımı

Bir PR GIF demosu içerdiğinde, bir yapay zeka ajanı cast dosyasını alabilir, komutları ayrıştırabilir ve PR açıklamasıyla eşleştiğini doğrulayabilir.

CLI Araç Keşfi

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