Agent meta verileri
Her Pipelogic component'i, component.yml ve README.md ile birlikte makine tarafından okunabilir bir agent özeti sunar. Özet, bir agent'a veya bir operatöre, component'in hangi göreve uyduğunu, hangi şekilleri kabul ettiğini, bir çağıranın aksi takdirde karşılaşacağı sürprizleri ve çalışmadan önce hangi kuruluma ihtiyaç duyduğunu söyler. README.md insana yönelik anlatıyı, component.yml ise tipli katalog sözleşmesini taşır; agent özeti, bir modelin bir graf için bir component'i seçip seçmeyeceğine, nasıl bağlanacağına ve hangi runtime tuhaflıklarını beklemesi gerektiğine karar verirken tükettiği yapılandırılmış spesifikasyondur.
Özet, AGENT.yml — kanonik biçim — olarak yazılır veya makine tarafından üretilen yükleri çıkaran araçlar için serileştirilmiş aynı şema olan AGENT.json olarak sağlanır. Bir component biri ya da diğerini taşır; ikisi de mevcutsa yükleme reddedilir. Manifest sabit bir şemaya karşı ayrıştırılır, böylece component.yml içinde zaten yaşayan katalog gerçekleri — parametre anahtarları, port tipleri, etiketler, komşular, alternatifler — orada kalır ve asla özette duplike edilmez.
Bir manifest, bir schema_version, giriş → dönüşüm → çıkış biçiminde tek cümlelik bir summary, bir pick_when listesi, sınıflandırılmış behavior_notes ve isteğe bağlı required_setup ile outputs blokları bildirir. pick_when listesi her girdiyi, component'in mekaniği olarak değil çağırana yönelik bir karar (ikili görüntü karelerini bir webhook'a gönder) olarak ifade eder, tipli akışı açıklayan bir data_shape ve ön koşulu açıklayan isteğe bağlı bir constraint ile eşleştirir. behavior_notes her notu bir hard_constraint, silent_fallback, parameter_interaction, edge_case, state_lifetime veya ordering kuralı olarak sınıflandırır, böylece agent'lar yanıtladıkları soru için doğru olanları tarayabilir. {{type:Foo}}, {{component:bar}} ve {{param:baz}} biçimindeki şablonlar, yüzeyi yeniden adlandırmalarda tutarlı tutmak için render zamanında çözülür.
Tam alan referansı, behavior_notes taksonomisi, upload bayrağı ve NEYİN yazılmayacağına dair kurallar CLI'de yaşar:
ppl docs get component-api/agent-metadatappl docs get component-api/component-contractppl docs get file-api/file-typesppl docs get concepts/solutions