Eksempel
{
"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." }
]
}
}
} Felter
| Felt | Type | Betydning |
|---|---|---|
requires.interfaces | liste af strenge | Funktioner, rollen har brug for, f.eks. mail eller ledger. Gives ved ansættelsen; hver operation, der kræver godkendelse, forbliver et godkendelsespunkt. Se Funktioner og godkendelser. |
requires.plugins | liste af strenge | Plugins, der installeres sammen med medarbejderen. Brug det kun, når rollen virkelig afhænger af ét plugin; foretræk en funktion. |
requires.tools | liste af strenge | Værktøjer, der indlæses i medarbejderens session fra første tur. Det springer aldrig godkendelse over. |
skills | liste af strenge | Færdigheder fra markedspladsen, der skal installeres og bruges: @org/skills/name, eventuelt @version, eller en SKIL--kode. Færdigheder i pakkens egen skills/-mappe kræver ingen post. |
inputs | list | Spørgsmål, som ejeren besvarer ved ansættelsen. Se Input. |
memory | object | Hvordan samtaler og hukommelse holdes. Se Persona og hukommelse. |
subscribes | liste af strenge | Områder med virksomhedsfakta, som medarbejderen læser igen, når de ændres, f.eks. finance.ar.*. |
ceiling | map | Operation til "approval". Den operation spørger altid ejeren for denne medarbejder. Ingen anden værdi accepteres. |
workflows | map | Workflownavn til workflow. Se Workflows. |
tools | list | HTTP-værktøjer, der serveres af en apps sidecar. Se Sidecar-værktøjer. |
scopes | map | Navngivne grupper af tools, skills og plugins. Et scopes plugins beskrives for medarbejderen, når det scope er aktivt. |
Input
Et input er et spørgsmål, som ejeren besvarer ved ansættelsen. Svarene vises for medarbejderen under "Configured Inputs" og udfylder {{key}}-pladsholdere i overvågnings- og mappetriggere.
{
"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"
} | Felt | Standard | Betydning |
|---|---|---|
key | påkrævet | Navn, der bruges i pladsholdere. name accepteres som reserve. |
label | fra key | Spørgsmålet, der vises for ejeren. |
type | text | text, textarea, number, select, checkbox eller radio. |
required | false | Markerer spørgsmålet som et, ejeren skal besvare. |
default | ingen | Forudfyldt svar. Ikke tilladt på et pengespørgsmål. |
placeholder, description | ingen | Hjælpetekst. |
options | ingen | For select og radio: {value, label}-objekter eller almindelige strenge. |
id | ingen | Et stabilt navn med punktummer for faktummet, f.eks. finance.ap.invoice_mailbox, så andre medarbejdere kan dele det. |
scope | company | company: et fælles faktum for virksomheden. seat: kun denne ansættelse. |
missing | ingen | Hvad medarbejderen gør, mens spørgsmålet er ubesvaret. |
money | false | Markerer et pengebeløb. Et pengespørgsmål kan ikke have en standardværdi. |
Sidecar-værktøjer
En app med en sidecar eksponerer HTTP-endpoints for sin medarbejder som værktøjer. Nebo registrerer hver post som app__<app>__<name> og sender kald til sidecaren på method og path. Se App-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" } } }
}
] Workflows
Hver nøgle under workflows navngiver ét workflow; navnet er dets identifikator. Det fulde format findes under Workflows, Udløsere og Aktiviteter.