Paket
Ajanları taşınabilir arşivler olarak dışa aktarın, paylaşın ve yükleyin.
Ne işe yarar
Bir ajan, klasör ağacı, yapılandırması, bilgisi ve iş akışları; bir bildirim (manifest), katkıda bulunanlar listesi ve kaynak kaydı ile birlikte tek bir .agentpkg ZIP arşivinde serileştirilir. Bir paketi yüklemek üç adımlı bir akışı takip eder: Planla (sıfır yazma ile incele), İncele (özeti doğrula), Uygula (TOCTOU güvenlik kontrolü ile yaz). Üç dağıtım modu sunulur: doğrudan bir dosyaya aktarma, süresi dolan bir paylaşım belirtecine sahip özel devir bağlantıları ve doğrulanmış kavram kanıtlama örnek çalıştırmalarını içeren küratörlü bir vitrin galerisi.
Neden önemlidir
Taşıyamadığınız bir ajan, size ait olmayan bir ajandır. Taşınabilir arşivler, bir ajanın bilgisini geride bırakmadan hesaplar, araçlar ve modeller arasında geçiş yapabileceği anlamına gelir; uygulamadan-önce-planla adımı ise yüklemenin bir yan etki değil, bir karar olduğu anlamına gelir.
Nasıl çalışır
Dahili UUID'ler serileştirme sırasında uuidv5 ile yeniden oluşturulur, böylece bir paket kaynaktan gelen hiçbir hesap, kiracı (tenant) veya klasör tanımlayıcısı taşımaz.
TOCTOU güvenliği ile üç adımlı kurulum
Planla adımı sıfır yazma ile inceler, İncele adımı bir özeti doğrular, Uygula adımı yazmadan önce özeti tekrar kontrol eder. İnceleme ve uygulama arasında değişen bir paket reddedilir.
Vitrin, doğrulanmış örnek çalıştırmaları taşır
Vitrin galerisindeki bir iş akışı, birinin yüklemeden önce nasıl çalıştığını izleyebilmesi için gizlenmiş gerçek bir çalıştırma içerir ve doğrulama, görüntüleme sırasında kontrol edilir.
Bir paketin içinde ne var?
Sorular
- Klasör ağacı, her bir yaprak belge, .context ve .agent yapılandırma dosyaları, iş akışları ve katkıda bulunan ile kaynak meta verilerini içeren bir bildirim (manifest). Kimlik bilgileri, yerleştirmeler (embeddings) veya doğrulama durumu bulunmaz.
- Bir paketi farklı bir hesaptaki biriyle paylaşabilir miyim?
- Evet. Özel bir devir bağlantısı, süresi dolan bir paylaşım belirteci taşır. Alıcı, bunu aynı planla-incele-uygula akışı üzerinden kendi hesabına yükler.
- Bellek
The rest of the bag
Yalnızca sayfaları değil, yanıtları da filtreleyen belge başına izinler.
İlke çözümlemesi hız için oturum başına önbelleğe alınır; bir izin değişikliği, işlemdeki her istekte anında değil, önbellek geçersiz kılındığında geçerli olur.
Her klasör ve her uç belge (leaf document) bir erişim ilkesi taşır: genel, oturum açmış veya sahip onaylı. Bu ilkeler, bir ajanın yanıt vermeden önce neleri alabileceğini filtreleyen oturum başına bir zarfa dönüştürülür. Bir yetenek kaydı, kiracı başına tüm özellikleri kısıtlar ve kritik erişim kontrolleri hata durumunda erişimi kapatır (fail-closed).
Dokümanlar
Ajanın okuduğu bir klasör ağacı ve uyduğu bir yapılandırma dosyası.
Veri çıkarma işlemi PDF'leri, e-tabloları ve dökümleri kapsar. Egzotik ikili (binary) formatlar ayrıştırılmaz.
Ajanların neyi neden yaptığına dair kalıcı bir günlük.
Süreç içi (in-process) olay veri yolu, dağıtık bir aracı değil, tek düğümlü bir yayıcıdır. Ajanlar arası kalıcı kayıt ise ayrı bir Postgres görev günlüğüdür.
Ajanlar arası çalışma; yeniden başlatmalardan etkilenmeyen ve yeniden oynatılabilen bir Postgres günlüğünde görevler, olaylar, bağlantılar ve artefaktlar olarak kaydedilir. Türü belirlenmiş bir süreç içi veri yolu, bir düğüm içindeki abonelere yaklaşık doksan tür alan (domain) olayı taşır. Bunlar birlikte size bir zaman çizelgesi sunar: ne istendi, kime devredildi, ne döndü ve nerede takıldı.
That was step 6 of 6: a reply leaves, and the trail stays. Varıştan yeniden oynatılabilir bir kayda kadar tüm yol budur.