Exemplu
{
"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." }
]
}
}
} Câmpuri
| Câmp | Tip | Semnificație |
|---|---|---|
requires.interfaces | listă de șiruri | Capabilitățile de care are nevoie rolul, precum mail sau ledger. Acordate la angajare; fiecare operațiune care necesită aprobare rămâne un element de aprobat. Vezi Capabilități și aprobări. |
requires.plugins | listă de șiruri | Pluginuri instalate odată cu angajatul. Folosește doar când rolul depinde cu adevărat de un anumit plugin; preferă o capabilitate. |
requires.tools | listă de șiruri | Instrumente încărcate în sesiunea angajatului de la prima tură. Asta nu ocolește niciodată aprobarea. |
skills | listă de șiruri | Abilități din magazin de instalat și folosit: @org/skills/name, opțional @version, sau un cod SKIL-. Abilitățile din folderul skills/ al pachetului nu au nevoie de intrare. |
inputs | list | Întrebări la care proprietarul răspunde la angajare. Vezi Date de intrare. |
memory | object | Cum sunt păstrate conversațiile și memoria. Vezi Persona și memorie. |
subscribes | listă de șiruri | Domenii de informații ale companiei pe care angajatul le recitește când se schimbă, de exemplu finance.ar.*. |
ceiling | map | Operațiune asociată cu "approval". Pentru acest angajat, operațiunea respectivă îl întreabă întotdeauna pe proprietar. Nicio altă valoare nu e acceptată. |
workflows | map | Asociere între numele fluxului de lucru și fluxul de lucru. Vezi Fluxuri de lucru. |
tools | list | Instrumente HTTP servite de sidecarul unei aplicații. Vezi Instrumente sidecar. |
scopes | map | Grupuri cu nume de tools, skills și plugins. Pluginurile (plugins) unui domeniu îi sunt descrise angajatului când acel domeniu e activ. |
Date de intrare
Un câmp de intrare este o întrebare la care proprietarul răspunde când angajează. Răspunsurile îi apar angajatului la „Configured Inputs” și completează substituenții {{key}} din declanșatoarele de tip watch și folder.
{
"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"
} | Câmp | Implicit | Semnificație |
|---|---|---|
key | obligatoriu | Numele folosit în substituenți. name e acceptat ca alternativă. |
label | din key | Întrebarea afișată proprietarului. |
type | text | text, textarea, number, select, checkbox sau radio. |
required | false | Marchează întrebarea ca fiind una la care proprietarul trebuie să răspundă. |
default | niciunul | Răspuns precompletat. Nu e permis la o întrebare despre bani. |
placeholder, description | niciunul | Text de ajutor. |
options | niciunul | Pentru select și radio: obiecte {value, label} sau șiruri simple. |
id | niciunul | Un nume stabil, cu puncte, pentru informație, de exemplu finance.ap.invoice_mailbox, ca alți angajați să o poată folosi în comun. |
scope | company | company: o informație comună a companiei. seat: doar pentru această angajare. |
missing | niciunul | Ce face angajatul cât timp întrebarea nu are răspuns. |
money | false | Marchează o sumă de bani. O întrebare despre bani nu poate avea valoare implicită. |
Instrumente sidecar
O aplicație cu sidecar îi expune angajatului ei endpointuri HTTP ca instrumente. Nebo înregistrează fiecare intrare ca app__<app>__<name> și trimite apelurile către sidecar la method și path. Vezi Sidecar pentru aplicații.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Fluxuri de lucru
Fiecare cheie din workflows numește un flux de lucru; numele este identificatorul lui. Formatul complet e descris în Fluxuri de lucru, Declanșatoare și Activități.