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." }
]
}
}
} Felt
| Felt | Type | Betydning |
|---|---|---|
requires.interfaces | liste med strenger | Funksjoner rollen trenger, som mail eller ledger. Gis ved ansettelse; hver operasjon som krever godkjenning, forblir et godkjenningselement. Se Funksjoner og godkjenninger. |
requires.plugins | liste med strenger | Tillegg som installeres sammen med den ansatte. Bruk bare når rollen virkelig er avhengig av ett tillegg; foretrekk en funksjon. |
requires.tools | liste med strenger | Verktøy som lastes inn i den ansattes økt fra første tur. Dette hopper aldri over godkjenning. |
skills | liste med strenger | Markedsplassferdigheter som skal installeres og brukes: @org/skills/name, eventuelt med @version, eller en SKIL--kode. Ferdigheter i pakkens egen skills/-mappe trenger ingen oppføring. |
inputs | list | Spørsmål eieren svarer på ved ansettelse. Se Inndata. |
memory | object | Hvordan samtaler og minne holdes. Se Persona og minne. |
subscribes | liste med strenger | Områder med bedriftsfakta den ansatte leser på nytt når de endres, for eksempel finance.ar.*. |
ceiling | map | Operasjon til "approval". Den operasjonen spør alltid eieren for denne ansatte. Ingen annen verdi godtas. |
workflows | map | Navn på arbeidsflyt til arbeidsflyt. Se Arbeidsflyter. |
tools | list | HTTP-verktøy servert av en apps sidecar. Se Sidecar-verktøy. |
scopes | map | Navngitte grupper av tools, skills og plugins. plugins i et omfang beskrives for den ansatte når omfanget er aktivt. |
Inndata
En inndata er et spørsmål eieren svarer på ved ansettelse. Svarene vises for den ansatte under «Configured Inputs» og fyller ut plassholderne {{key}} i overvåkings- og mappeutløsere.
{
"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åkrevd | Navnet som brukes i plassholdere. name godtas som reserve. |
label | fra key | Spørsmålet som vises for eieren. |
type | text | text, textarea, number, select, checkbox eller radio. |
required | false | Merker spørsmålet som et eieren må svare på. |
default | ingen | Forhåndsutfylt svar. Ikke tillatt på et pengespørsmål. |
placeholder, description | ingen | Hjelpetekst. |
options | ingen | For select og radio: {value, label}-objekter eller vanlige strenger. |
id | ingen | Et stabilt navn med punktum for faktumet, som finance.ap.invoice_mailbox, slik at andre ansatte kan dele det. |
scope | company | company: et delt bedriftsfaktum. seat: bare denne ansettelsen. |
missing | ingen | Hva den ansatte gjør mens spørsmålet er ubesvart. |
money | false | Merker et pengebeløp. Et pengespørsmål kan ikke ha en standardverdi. |
Sidecar-verktøy
En app med en sidecar eksponerer HTTP-endepunkter for sin ansatt som verktøy. Nebo registrerer hver oppføring som app__<app>__<name> og sender kall 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" } } }
}
] Arbeidsflyter
Hver nøkkel under workflows navngir én arbeidsflyt; navnet er identifikatoren. Hele formatet finner du under Arbeidsflyter, Utløsere og Aktiviteter.