NeboAI
NeboAI
Başlayın

agent.json referansı

agent.json, bir çalışanla ilgili düz metin olmayan her şeyi barındırır: gerektirdiği yetenekler, sahibine sorduğu sorular, belleğinin nasıl tutulduğu, hangi işlemlerin her zaman onay gerektirdiği ve çalıştırdığı iş akışları. Her alan isteğe bağlıdır.

Örnek

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

Alanlar

AlanTürAnlamı
requires.interfacesdize listesiRolün ihtiyaç duyduğu yetenekler, örneğin mail veya ledger. İşe alımda verilir; onaya bağlı her işlem bir onay öğesi olarak kalır. Bkz. Yetenekler ve Onaylar.
requires.pluginsdize listesiÇalışanla birlikte yüklenen eklentiler. Yalnızca rol gerçekten tek bir eklentiye bağlıysa kullanın; bir yeteneği tercih edin.
requires.toolsdize listesiÇalışanın oturumuna ilk turundan itibaren yüklenen araçlar. Bu asla onayı atlamaz.
skillsdize listesiYüklenip kullanılacak pazar yeri becerileri: @org/skills/name, isteğe bağlı olarak @version ya da bir SKIL- kodu. Paketin kendi skills/ klasöründeki beceriler için girdi gerekmez.
inputslistSahibin işe alımda yanıtladığı sorular. Bkz. Girdiler.
memoryobjectSohbetlerin ve belleğin nasıl tutulduğu. Bkz. Kişilik ve Bellek.
subscribesdize listesiDeğiştiklerinde çalışanın yeniden okuduğu şirket bilgisi alanları, örneğin finance.ar.*.
ceilingmapİşlemden "approval" değerine eşleme. Bu işlem, bu çalışan için her zaman sahibine sorulur. Başka bir değer kabul edilmez.
workflowsmapİş akışı adından iş akışına eşleme. Bkz. İş Akışları.
toolslistBir uygulamanın sidecar'ı tarafından sunulan HTTP araçları. Bkz. Sidecar araçları.
scopesmaptools, skills ve plugins için adlandırılmış gruplar. Bir kapsam etkinken o kapsamın plugins öğeleri çalışana tanıtılır.

Girdiler

Girdi, sahibin işe alım sırasında yanıtladığı bir sorudur. Yanıtlar çalışana "Configured Inputs" altında görünür ve izleme ile klasör tetikleyicilerindeki {{key}} yer tutucularını doldurur.

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
AlanVarsayılanAnlamı
keyzorunluYer tutucularda kullanılan ad. Yedek olarak name kabul edilir.
labelkey değerindenSahibine gösterilen soru.
typetexttext, textarea, number, select, checkbox veya radio.
requiredfalseSoruyu, sahibinin yanıtlaması gereken bir soru olarak işaretler.
defaultyokÖnceden doldurulmuş yanıt. Para sorusunda izin verilmez.
placeholder, descriptionyokYardım metni.
optionsyokselect ve radio için: {value, label} nesneleri veya düz dizeler.
idyokDiğer çalışanların da paylaşabilmesi için bilginin noktalı, sabit adı, örneğin finance.ap.invoice_mailbox.
scopecompanycompany: paylaşılan bir şirket bilgisi. seat: yalnızca bu işe alım.
missingyokSoru yanıtlanmamışken çalışanın ne yaptığı.
moneyfalseBir para tutarını işaretler. Bir para sorusunun varsayılanı olamaz.

Sidecar araçları

Sidecar'ı olan bir uygulama, HTTP uç noktalarını çalışanına araç olarak sunar. Nebo her girdiyi app__<app>__<name> olarak kaydeder ve çağrıları sidecar'a method ve path üzerinden gönderir. Bkz. Uygulama Sidecar'ı.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

İş Akışları

workflows altındaki her anahtar bir iş akışını adlandırır; ad, onun tanımlayıcısıdır. Tam biçim İş Akışları, Tetikleyiciler ve Etkinlikler sayfalarındadır.