Esempio
{
"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." }
]
}
}
} Campi
| Campo | Tipo | Significato |
|---|---|---|
requires.interfaces | elenco di stringhe | Capability di cui il ruolo ha bisogno, come mail o ledger. Concesse all’assunzione; ogni operazione soggetta ad approvazione resta una voce da approvare. Vedi Capability e approvazioni. |
requires.plugins | elenco di stringhe | Plugin installati insieme al dipendente. Usalo solo quando il ruolo dipende davvero da un plugin; preferisci una capability. |
requires.tools | elenco di stringhe | Strumenti caricati nella sessione del dipendente fin dal primo turno. Questo non salta mai l’approvazione. |
skills | elenco di stringhe | Skill del marketplace da installare e usare: @org/skills/name, facoltativamente @version, oppure un codice SKIL-. Le skill nella cartella skills/ del pacchetto non hanno bisogno di una voce. |
inputs | list | Domande a cui il titolare risponde all’assunzione. Vedi Input. |
memory | object | Come vengono conservate conversazioni e memoria. Vedi Persona e memoria. |
subscribes | elenco di stringhe | Aree di informazioni aziendali che il dipendente rilegge quando cambiano, come finance.ar.*. |
ceiling | map | Dall’operazione a "approval". Per questo dipendente quell’operazione chiede sempre conferma al titolare. Nessun altro valore è accettato. |
workflows | map | Dal nome del flusso di lavoro al flusso di lavoro. Vedi Flussi di lavoro. |
tools | list | Strumenti HTTP serviti dal sidecar di un’app. Vedi Strumenti del sidecar. |
scopes | map | Gruppi con nome di tools, skills e plugins. I plugins di un ambito vengono descritti al dipendente quando quell’ambito è attivo. |
Input
Un input è una domanda a cui il proprietario risponde al momento dell’assunzione. Le risposte compaiono al dipendente sotto “Configured Inputs” e riempiono i segnaposto {{key}} nei trigger di monitoraggio e di cartella.
{
"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"
} | Campo | Predefinito | Significato |
|---|---|---|
key | obbligatorio | Nome usato nei segnaposto. In alternativa è accettato name. |
label | da key | La domanda mostrata al titolare. |
type | text | text, textarea, number, select, checkbox o radio. |
required | false | Indica che il titolare deve rispondere alla domanda. |
default | nessuno | Risposta precompilata. Non consentita per una domanda su un importo. |
placeholder, description | nessuno | Testo di aiuto. |
options | nessuno | Per select e radio: oggetti {value, label} o semplici stringhe. |
id | nessuno | Un nome stabile, con punti, per l’informazione, come finance.ap.invoice_mailbox, così che altri dipendenti possano condividerla. |
scope | company | company: un’informazione condivisa dell’azienda. seat: solo per questa assunzione. |
missing | nessuno | Cosa fa il dipendente finché la domanda non ha risposta. |
money | false | Indica un importo di denaro. Una domanda su un importo non può avere un valore predefinito. |
Strumenti del sidecar
Un’app con un sidecar espone endpoint HTTP al proprio dipendente come strumenti. Nebo registra ogni voce come app__<app>__<name> e invia le chiamate al sidecar su method e path. Vedi Sidecar delle app.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Flussi di lavoro
Ogni chiave sotto workflows indica un flusso di lavoro; il nome è il suo identificatore. Il formato completo è descritto in Flussi di lavoro, Trigger e Attività.