تكامل وكيل الذكاء الاصطناعي

بنية الطبقة المزدوجة

تقدم منصات استضافة GIF التقليدية صوراً — كتلاً ثنائية لا تستطيع وكلاء الذكاء الاصطناعي تفسيرها. يحل AgentGIF هذا بإرفاق طبقة آلية بكل تسجيل:

يمكن لوكيل الذكاء الاصطناعي النظر إلى صفحة GIF وفهم بالضبط ما هي الأوامر التي نُفِّذت، وما كانت المخرجات، وكم استغرقت كل خطوة — كل ذلك دون OCR أو رؤية حاسوبية.

نقاط نهاية .md

أضف .md إلى أي رابط AgentGIF للحصول على استجابة text/markdown محسّنة للنماذج اللغوية الكبيرة. هذه هي الطريقة الأسرع لوكيل الذكاء الاصطناعي لفهم محتوى الصفحة.

# 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 منظم يحتوي على عنوان ووصف وبيانات وصفية وروابط ذات صلة. نوع المحتوى: 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"]

كل حدث عبارة عن مجموعة ثلاثية: [timestamp_seconds, event_type, data]

• "o" — مخرجات (نص مكتوب على الطرفية)
• "i" — مدخلات (ضغطات المفاتيح، إذا سُجِّلت)

حلِّل ملف cast لاستخراج الأوامر التي نُفِّذت بالضبط ومخرجاتها ومعلومات التوقيت. تُخبرك ترويسة env بالشل ونوع الطرفية.

النصوص

في حالات الاستخدام الأبسط، تعيد نقطة نهاية النص نصاً عادياً مع حذف رموز ANSI:

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

الاستجابة:

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

النصوص مثالية لفهرسة البحث والتضمين في نوافذ سياق النماذج اللغوية الكبيرة واستخراج المحتوى بسرعة.

JSON API المنظمة

يعيد REST API بيانات وصفية كاملة لكل تسجيل:

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.

الاكتشاف والزحف

يمكن لوكلاء الذكاء الاصطناعي اكتشاف التسجيلات عبر قنوات متعددة:

يسمح robots.txt لجميع الزواحف — يرحّب AgentGIF بوكلاء الذكاء الاصطناعي.

حالات استخدام وكلاء الذكاء الاصطناعي

توليد التوثيق

يمكن لوكيل الذكاء الاصطناعي البحث عن تسجيلات باسم الأداة واسترداد ملف cast وتوليد توثيق تلقائياً مع عروض توضيحية مضمّنة:

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

تجميع الدروس التعليمية

يمكن للوكلاء تصفح مجموعات التسجيلات ذات الصلة وتجميع دروس تعليمية خطوة بخطوة بالترتيب الصحيح والسياق المناسب.

المساعدة في مراجعة الكود

عندما يتضمن PR عرضاً توضيحياً بصيغة GIF، يمكن لوكيل الذكاء الاصطناعي جلب ملف 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.