Ö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
| Alan | Tür | Anlamı |
|---|---|---|
requires.interfaces | dize listesi | Rolü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.plugins | dize 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.tools | dize listesi | Çalışanın oturumuna ilk turundan itibaren yüklenen araçlar. Bu asla onayı atlamaz. |
skills | dize listesi | Yü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. |
inputs | list | Sahibin işe alımda yanıtladığı sorular. Bkz. Girdiler. |
memory | object | Sohbetlerin ve belleğin nasıl tutulduğu. Bkz. Kişilik ve Bellek. |
subscribes | dize listesi | Değiştiklerinde çalışanın yeniden okuduğu şirket bilgisi alanları, örneğin finance.ar.*. |
ceiling | map | İş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. |
workflows | map | İş akışı adından iş akışına eşleme. Bkz. İş Akışları. |
tools | list | Bir uygulamanın sidecar'ı tarafından sunulan HTTP araçları. Bkz. Sidecar araçları. |
scopes | map | tools, 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"
} | Alan | Varsayılan | Anlamı |
|---|---|---|
key | zorunlu | Yer tutucularda kullanılan ad. Yedek olarak name kabul edilir. |
label | key değerinden | Sahibine gösterilen soru. |
type | text | text, textarea, number, select, checkbox veya radio. |
required | false | Soruyu, sahibinin yanıtlaması gereken bir soru olarak işaretler. |
default | yok | Önceden doldurulmuş yanıt. Para sorusunda izin verilmez. |
placeholder, description | yok | Yardım metni. |
options | yok | select ve radio için: {value, label} nesneleri veya düz dizeler. |
id | yok | Diğer çalışanların da paylaşabilmesi için bilginin noktalı, sabit adı, örneğin finance.ap.invoice_mailbox. |
scope | company | company: paylaşılan bir şirket bilgisi. seat: yalnızca bu işe alım. |
missing | yok | Soru yanıtlanmamışken çalışanın ne yaptığı. |
money | false | Bir 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.