Dışa aktarma ve API
Agent'ları ve iş akışlarını dışarı taşıma, toplu işlemler, ücretli agent'lar ve programatik erişim.
Toplu İşlemler
Birden çok agent üzerinde tek seferde işlem yapmak için toplu işlem ucu vardır:
POST /api/v1/agents/bulk. İstek başına en fazla 100 agent; her agent için sonuç ayrı
döner, birinin başarısız olması diğerlerini durdurmaz.
| İşlem | Açıklama | Kredi |
|---|---|---|
remove_from_library |
Agent'ları Collection'dan çıkarır | Ücretsiz |
tag_add / tag_remove |
Etiket ekler / çıkarır | Ücretsiz |
regenerate_image |
Sigil görsellerini yeniden üretir | Agent başına 3 ⚡ (toplam tutar baştan kontrol edilir) |
Arayüz
Collection ekranında henüz çoklu seçim araç çubuğu yoktur; toplu işlemler bugün oturum açmış kullanıcı adına API üzerinden yapılır.
Dışa Aktarma Formatları
| Kaynak | Format | Nasıl |
|---|---|---|
| Agent | OpenClaw uyumlu SKILL.md |
GET /api/v1/agents/:id/skill.md |
| Legend workflow | İş akışı JSON (ad, düğümler, kenarlar) |
Legend menüsünde Export JSON dosyayı indirir |
SKILL.md ve prompt koruması
SKILL.md agent'ı OpenClaw gibi skill tabanlı araçlara taşır. Agent'ın sahibi
veya satın alanı tam prompt'u alır; diğer herkes aynı başlık bilgilerini (ad,
açıklama, model, meta veri) ama prompt yerine "satın alın" notu içeren bir sürüm
alır.
Ücretli Agent'lar & Deneme
Bir agent'ın fiyatı yalnız sahibi tarafından API ile belirlenir
(PUT /api/v1/agents/:id/price). Ücretli bir agent'ı kullanmak (Use) ve fork'lamak
satın alma gerektirir. Sunucuda agent başına bir kez kullanılabilen bir deneme belirteci
(POST /api/v1/agents/:id/trial) de bulunur. Web arayüzünde henüz satın alma veya
deneme ekranı yoktur. Krediler için Kredi Sistemi.
API Anahtarları
Platforma programatik erişim için kapsamlı (scoped) API anahtarları üretebilirsiniz: Settings → Developer → API Keys.
| Alan | Açıklama |
|---|---|
| Biçim | agst_ + 32 onaltılık karakter; listelerde yalnız agst_ + ilk 8 karakterlik önek görünür |
| Saklama | Anahtar bcrypt ile hash'lenir; ham değer yalnızca oluşturulurken bir kez gösterilir |
| Kapsam (scope) | Arayüzde seçilebilenler: read:agents, write:agents, execute:legend |
| Yönetim | Ad, son kullanım zamanı, iptal (revoke) |
Sunucu ayrıca Embassy çalıştırıcısının kullandığı read:assignments ve
submit:report kapsamlarını tanır → Embassy.
Anahtarı bir kez kopyalayın
Ham anahtar oluşturulurken yalnızca bir kez gösterilir; güvenli bir yere kaydedin. Sızarsa hemen iptal edin. Kimlik/yetki mimarisi için Backend.
Paylaşılabilir Public Sayfalar (SEO)
Flutter uygulaması <canvas>'a çizdiği için arama motorlarınca taranamaz. Bu yüzden
sunucu-render edilmiş, taranabilir public sayfalar sunulur:
| URL | İçerik |
|---|---|
/a/:id |
Agent'ın taranabilir sayfası — başlık, açıklama, Sigil görseli, istatistikler, Open Graph kartı, JSON-LD; "Open in Agent Tale" ile uygulamadaki /agent/:id'ye gider |
/agent/:id, /agent/:id/chat |
Uygulama adresleri; arama motoru botlarına sunucu-render sayfa döner (sohbet sayfasının kendi canonical'ı vardır), insanlar uygulamayı görür |
/u/:wallet |
Yayıncı profili — yayımlanan agent'lar /a/:id'ye linklenir |
/trending, /c/:category |
Trending ve kategori listeleri |
/sitemap.xml |
Public agent, sohbet ve profil URL'lerini listeleyen dinamik site haritası |
/robots.txt |
Tarama izni + sitemap işaretçisi |
Fork'ların görünen kimlikleri (ör. 12-3) tüm bu adreslerde çalışır.
Sosyal paylaşım
Bir agent'ı Slack/X/Discord'a yapıştırdığınızda /a/:id sayfasının Open Graph
kartı (görsel + başlık + açıklama) görünür. Paylaşım/canonical URL /a/:id'dir;
uygulama içi gezinme /agent/:id ile yapılır.