Tích hợp Tác nhân AI

Kiến trúc hai lớp

Các nền tảng lưu trữ GIF truyền thống chỉ phục vụ hình ảnh — các blob nhị phân mà tác nhân AI không thể diễn giải. AgentGIF giải quyết điều này bằng cách đính kèm lớp máy vào mỗi GIF:

Một tác nhân AI có thể nhìn vào trang GIF và hiểu chính xác những lệnh nào đã được chạy, đầu ra là gì và mỗi bước mất bao lâu — tất cả mà không cần OCR hay thị giác máy tính.

Endpoint .md

Thêm .md vào bất kỳ URL AgentGIF nào để nhận phản hồi text/markdown được tối ưu hóa cho LLM. Đây là cách nhanh nhất để tác nhân AI hiểu những gì có trên trang.

# 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

Phản hồi là tài liệu Markdown có cấu trúc với tiêu đề, mô tả, metadata và các liên kết liên quan. Content-Type: text/markdown; charset=utf-8.

Mỗi trang trên AgentGIF đều hỗ trợ hậu tố .md — không có ngõ cụt cho các tác nhân.

Tệp 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/

Định dạng phản hồi:

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

Mỗi sự kiện là một tuple: [timestamp_seconds, event_type, data]

• "o" — output (văn bản được ghi vào terminal)
• "i" — input (tổ hợp phím, nếu được ghi)

Phân tích tệp cast để trích xuất các lệnh đã chạy chính xác, đầu ra và thông tin thời gian. Header env cho bạn biết shell và loại terminal.

Bản ghi chép

Đối với các trường hợp sử dụng đơn giản hơn, endpoint bản ghi chép trả về văn bản thuần với các mã ANSI đã được xóa:

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

Phản hồi:

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

Bản ghi chép lý tưởng cho việc lập chỉ mục tìm kiếm, nhúng vào cửa sổ ngữ cảnh LLM và trích xuất nội dung nhanh.

JSON API có cấu trúc

REST API trả về đầy đủ metadata cho mỗi 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.

Đối với các thao tác hàng loạt, sử dụng endpoint danh sách và tìm kiếm:

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

Khám phá & Thu thập

Tác nhân AI có thể khám phá GIF qua nhiều kênh:

Tệp robots.txt cho phép tất cả trình thu thập — AgentGIF chào đón tác nhân AI.

Trường hợp sử dụng cho Tác nhân AI

Tạo tài liệu

Một tác nhân AI có thể tìm kiếm GIF theo tên công cụ, truy xuất tệp cast và tự động tạo tài liệu với các demo được nhúng:

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

Tập hợp hướng dẫn

Các tác nhân có thể duyệt bộ sưu tập GIF liên quan và tập hợp các hướng dẫn từng bước với thứ tự và ngữ cảnh chính xác.

Hỗ trợ đánh giá code

Khi một PR có kèm demo GIF, tác nhân AI có thể tải tệp cast, phân tích các lệnh và xác minh chúng khớp với mô tả PR.

Khám phá công cụ CLI

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