Exempel
{
"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." }
]
}
}
} Fält
| Fält | Typ | Betydelse |
|---|---|---|
requires.interfaces | lista med strängar | Funktioner som rollen behöver, till exempel mail eller ledger. Beviljas vid anställningen; varje åtgärd som kräver godkännande förblir ett godkännandeärende. Se Funktioner och godkännanden. |
requires.plugins | lista med strängar | Plugins som installeras med medarbetaren. Använd bara när rollen verkligen är beroende av ett visst plugin; föredra en funktion. |
requires.tools | lista med strängar | Verktyg som läses in i medarbetarens session från första turen. Det kringgår aldrig godkännanden. |
skills | lista med strängar | Färdigheter från marknadsplatsen att installera och använda: @org/skills/name, eventuellt @version, eller en SKIL--kod. Färdigheter i paketets egen skills/-mapp behöver ingen post. |
inputs | list | Frågor som ägaren besvarar vid anställningen. Se Indata. |
memory | object | Hur konversationer och minne sparas. Se Persona och minne. |
subscribes | lista med strängar | Områden med företagsfakta som medarbetaren läser om när de ändras, till exempel finance.ar.*. |
ceiling | map | Åtgärd mappad till "approval". Den åtgärden frågar alltid ägaren för den här medarbetaren. Inget annat värde accepteras. |
workflows | map | Arbetsflödets namn mappat till arbetsflödet. Se Arbetsflöden. |
tools | list | HTTP-verktyg som serveras av en apps sidecar. Se Sidecar-verktyg. |
scopes | map | Namngivna grupper av tools, skills och plugins. Ett omfångs plugins beskrivs för medarbetaren när omfånget är aktivt. |
Indata
En indata är en fråga som ägaren svarar på vid anställningen. Svaren visas för medarbetaren under ”Configured Inputs” och fyller i platshållarna {{key}} i bevaknings- och mapputlösare.
{
"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"
} | Fält | Standard | Betydelse |
|---|---|---|
key | obligatoriskt | Namn som används i platshållare. name accepteras som reserv. |
label | från key | Frågan som visas för ägaren. |
type | text | text, textarea, number, select, checkbox eller radio. |
required | false | Markerar frågan som en som ägaren måste besvara. |
default | inget | Förifyllt svar. Inte tillåtet för en fråga om pengar. |
placeholder, description | inget | Hjälptext. |
options | inget | För select och radio: {value, label}-objekt eller vanliga strängar. |
id | inget | Ett stabilt namn med punkter för faktumet, till exempel finance.ap.invoice_mailbox, så att andra medarbetare kan dela det. |
scope | company | company: ett gemensamt faktum för företaget. seat: bara den här anställningen. |
missing | inget | Vad medarbetaren gör medan frågan är obesvarad. |
money | false | Markerar ett belopp. En fråga om pengar kan inte ha ett standardvärde. |
Sidecar-verktyg
En app med en sidecar exponerar HTTP-slutpunkter för sin medarbetare som verktyg. Nebo registrerar varje post som app__<app>__<name> och skickar anrop till sidecaren på method och 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" } } }
}
] Arbetsflöden
Varje nyckel under workflows namnger ett arbetsflöde; namnet är dess identifierare. Det fullständiga formatet finns under Arbetsflöden, Utlösare och Aktiviteter.