Voorbeeld
{
"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." }
]
}
}
} Velden
| Veld | Type | Betekenis |
|---|---|---|
requires.interfaces | lijst met strings | Capabilities die de functie nodig heeft, zoals mail of ledger. Toegekend bij het aannemen; elke bewerking waarvoor goedkeuring nodig is, blijft een goedkeuringsitem. Zie Capabilities en goedkeuringen. |
requires.plugins | lijst met strings | Plug-ins die met de medewerker worden geïnstalleerd. Gebruik dit alleen als de functie echt van één plug-in afhangt; geef de voorkeur aan een capability. |
requires.tools | lijst met strings | Tools die vanaf de eerste beurt in de sessie van de medewerker worden geladen. Dit omzeilt nooit een goedkeuring. |
skills | lijst met strings | Marktplaatsskills om te installeren en te gebruiken: @org/skills/name, optioneel @version, of een SKIL--code. Skills in de eigen map skills/ van het pakket hebben geen vermelding nodig. |
inputs | list | Vragen die de eigenaar bij het aannemen beantwoordt. Zie Invoer. |
memory | object | Hoe gesprekken en geheugen worden bewaard. Zie Persona en geheugen. |
subscribes | lijst met strings | Gebieden met bedrijfsfeiten die de medewerker opnieuw leest wanneer ze veranderen, zoals finance.ar.*. |
ceiling | map | Bewerking naar "approval". Voor deze medewerker vraagt die bewerking altijd de eigenaar om goedkeuring. Geen andere waarde wordt geaccepteerd. |
workflows | map | Workflownaam naar workflow. Zie Workflows. |
tools | list | HTTP-tools die worden geleverd door de sidecar van een app. Zie Sidecar-tools. |
scopes | map | Benoemde groepen van tools, skills en plugins. De plugins van een scope worden aan de medewerker beschreven wanneer die scope actief is. |
Invoer
Een invoer is een vraag die de eigenaar beantwoordt bij het aannemen. De antwoorden verschijnen voor de medewerker onder "Configured Inputs" en vullen de placeholders {{key}} in watch- en maptriggers.
{
"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"
} | Veld | Standaard | Betekenis |
|---|---|---|
key | verplicht | Naam die in placeholders wordt gebruikt. name wordt als alternatief geaccepteerd. |
label | uit key | De vraag die aan de eigenaar wordt getoond. |
type | text | text, textarea, number, select, checkbox of radio. |
required | false | Markeert de vraag als een vraag die de eigenaar moet beantwoorden. |
default | geen | Vooraf ingevuld antwoord. Niet toegestaan bij een geldvraag. |
placeholder, description | geen | Helptekst. |
options | geen | Voor select en radio: {value, label}-objecten of gewone strings. |
id | geen | Een vaste naam met punten voor het feit, zoals finance.ap.invoice_mailbox, zodat andere medewerkers het kunnen delen. |
scope | company | company: een gedeeld bedrijfsfeit. seat: alleen voor deze aanstelling. |
missing | geen | Wat de medewerker doet zolang de vraag niet is beantwoord. |
money | false | Markeert een geldbedrag. Een geldvraag kan geen standaardwaarde hebben. |
Sidecar-tools
Een app met een sidecar stelt HTTP-endpoints als tools beschikbaar aan zijn medewerker. Nebo registreert elke vermelding als app__<app>__<name> en stuurt aanroepen naar de sidecar op method en path. Zie 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
Elke sleutel onder workflows geeft één workflow een naam; de naam is zijn identificatie. Het volledige formaat staat op Workflows, Triggers en Activiteiten.