Sıkça Sorulan Sorular

Geliştirici GIF barındırma platformu AgentGIF hakkında sık sorulan sorular.

AgentGIF Nedir?

AgentGIF, çift katmanlı mimariye sahip bir geliştirici GIF barındırma platformudur. Her terminal demo GIF'i, makine tarafından okunabilir bir asciinema v2 cast dosyasıyla eşleştirilir, böylece hem insanlar hem de yapay zeka ajanları içeriği anlayabilir.

Bir insan animasyonlu bir terminal kaydı görür. Bir yapay zeka ajanı yapılandırılmış veri görür: komutlar, çıktı, zaman damgaları ve meta veri.

AgentGIF ücretsiz mi?

Evet. GIF yükleme, barındırma ve gömme tamamen ücretsizdir. REST API, kimlik doğrulaması gerektirmeden okuma işlemleri için ücretsizdir. Yazma işlemleri (yükleme, düzenleme, silme), ayarlar sayfanızdan alınan ücretsiz bir API anahtarı gerektirir.

Cast dosyası nedir?

Cast dosyası bir asciinema v2 kaydıdır. Satır 1'in terminal meta verileri içeren bir JSON başlığı olduğu, ardından zaman damgalı olay demetlerinin geldiği bir metin formatıdır:

{"version": 2, "width": 120, "height": 40}
[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"]

Her demet [timestamp_seconds, event_type, data] şeklindedir. Bu, yapay zeka ajanlarının OCR olmadan komutları, çıktıyı ve zamanlamayı çıkarmasını sağlar.

Bir GIF'i nasıl yüklerim?

İki seçenek:

  • Web: /upload/ adresine sürükleyip bırakın (GitHub girişi gerektirir)
  • CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI, 5 dilde mevcuttur: Python, Node.js, Go, Rust ve Ruby. Makine tarafından okunabilir katmanı eklemek için --cast demo.cast bayrağını kullanın.

README'me bir GIF'i nasıl gömerim?

GitHub README'leri için önerilen kalıp:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

ID yerine GIF'inizin 8 karakterli kimliğini yazın. 6 yöntemin tümü için gömme kılavuzunun tamamına bakın.

.md endpoint'i nedir?

LLM'ler için optimize edilmiş bir text/markdown yanıtı almak için herhangi bir AgentGIF URL'sine .md ekleyin. Her sayfa bunu destekler — GIF detayları, etiket listeleri, araç sayfaları, koleksiyonlar, kılavuzlar ve arama sonuçları.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

API anahtarına ihtiyacım var mı?

İşlemKimlik Doğrulaması Gerekli
Arama, listeleme, detay, cast, dökümHayır — tamamen açık
GIF yükle, düzenle, silEvet — X-API-Key başlığı
Koleksiyon oluştur/yönetEvet — X-API-Key başlığı

GitHub ile giriş yaptıktan sonra /settings/ adresinden ücretsiz bir API anahtarı alın.

Hangi terminal temaları mevcut?

AgentGIF, tüm 44 VHS terminal temasını destekler. Popüler seçenekler:

TemaStil
Catppuccin MochaPastel vurgulu sıcak koyu (varsayılan)
DraculaKoyu mor klasik
Tokyo NightMavi odaklı modern koyu
NordArktik mavi paleti
Solarized Dark/LightHassas renkler
GitHub Dark/LightGitHub'ın yerel temaları

Canlı önizlemelerle tüm temalara göz atın: Tema Galerisi.

Rozet servisi nedir?

AgentGIF, shields.io alternatifi olarak terminal temalı paket rozetleri sunar. Seçtiğiniz terminal tema renkleriyle oluşturulurlar.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Desteklenen sağlayıcılar: PyPI, npm, crates.io, GitHub. ?theme= ve ?style= parametreleriyle özelleştirin. Rozet oyun alanına bakın.

Yapay zeka ajanları GIF'leri nasıl okur?

Yapay zeka ajanları GIF içeriğine birden fazla kanal aracılığıyla erişebilir:

  • Cast dosyaları: GET /api/v1/gifs/{id}/cast/ — zaman damgalı tam asciinema v2 kaydı
  • Dökümler: GET /api/v1/gifs/{id}/transcript/ — temiz düz metin, ANSI kodları temizlenmiş
  • .md endpoint'leri: Markdown çıktısı için herhangi bir sayfa URL'sine .md ekleyin
  • JSON API: /api/v1/search/?q=docker — yapılandırılmış sonuçlarla tam metin arama
  • llms.txt: /llms.txt — yapay zeka tarayıcıları için site düzeyinde özet

Tam yapay zeka ajanı entegrasyon belgelerine bakın.

Hangi dosya formatları desteklenir?

FormatMaks BoyutAmaç
GIF10 MBBirincil görsel format — her yerde oynatılır
Cast (.cast)5 MBMakine tarafından okunabilir katman (yüklemede isteğe bağlı)
MP4Otomatik oluşturulanVerimli oynatma alternatifi

En iyi sonuçlar için GIF'leri 5 MB'ın altında tutun. Optimizasyon ipuçları için kayıt kılavuzuna bakın.

Bir terminal GIF'i nasıl kaydederim?

Betiklenmiş, yeniden üretilebilir kayıtlar için Charm tarafından geliştirilen VHS'yi öneriyoruz:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Tam adım adım talimatlar: Terminal GIF'i Nasıl Kaydedilir.

← Hakkında · Dokümantasyon · Kılavuzlar →