Beispiel
{
"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." }
]
}
}
} Felder
| Feld | Typ | Bedeutung |
|---|---|---|
requires.interfaces | Liste von Strings | Fähigkeiten, die die Rolle braucht, etwa mail oder ledger. Werden beim Einstellen erteilt; jede freigabepflichtige Operation bleibt ein Freigabe-Eintrag. Siehe Fähigkeiten und Freigaben. |
requires.plugins | Liste von Strings | Plugins, die mit dem Mitarbeiter installiert werden. Nur verwenden, wenn die Rolle wirklich von einem Plugin abhängt; eine Fähigkeit ist vorzuziehen. |
requires.tools | Liste von Strings | Tools, die ab der ersten Runde in die Sitzung des Mitarbeiters geladen werden. Das umgeht nie eine Freigabe. |
skills | Liste von Strings | Marktplatz-Skills zum Installieren und Nutzen: @org/skills/name, optional @version, oder ein SKIL--Code. Skills im eigenen Ordner skills/ des Pakets brauchen keinen Eintrag. |
inputs | list | Fragen, die der Inhaber beim Einstellen beantwortet. Siehe Eingaben. |
memory | object | Wie Gespräche und Gedächtnis geführt werden. Siehe Persona und Gedächtnis. |
subscribes | Liste von Strings | Bereiche mit Unternehmensfakten, die der Mitarbeiter bei Änderungen erneut liest, etwa finance.ar.*. |
ceiling | map | Operation zu "approval". Diese Operation fragt bei diesem Mitarbeiter immer den Inhaber. Kein anderer Wert wird akzeptiert. |
workflows | map | Workflow-Name zu Workflow. Siehe Workflows. |
tools | list | HTTP-Tools, die vom Sidecar einer App bereitgestellt werden. Siehe Sidecar-Tools. |
scopes | map | Benannte Gruppen von tools, skills und plugins. Die plugins eines Bereichs werden dem Mitarbeiter beschrieben, wenn dieser Bereich aktiv ist. |
Eingaben
Ein Input ist eine Frage, die der Inhaber bei der Einstellung beantwortet. Die Antworten erscheinen für den Mitarbeiter unter „Configured Inputs“ und füllen {{key}}-Platzhalter in Watch- und Ordner-Triggern.
{
"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"
} | Feld | Standard | Bedeutung |
|---|---|---|
key | erforderlich | Name, der in Platzhaltern verwendet wird. name wird als Ausweichlösung akzeptiert. |
label | aus key | Die Frage, die dem Inhaber angezeigt wird. |
type | text | text, textarea, number, select, checkbox oder radio. |
required | false | Kennzeichnet die Frage als eine, die der Inhaber beantworten muss. |
default | keiner | Vorausgefüllte Antwort. Bei einer Geldfrage nicht erlaubt. |
placeholder, description | keiner | Hilfetext. |
options | keiner | Für select und radio: {value, label}-Objekte oder einfache Strings. |
id | keiner | Ein stabiler Name in Punktnotation für den Fakt, etwa finance.ap.invoice_mailbox, damit andere Mitarbeiter ihn teilen können. |
scope | company | company: ein gemeinsamer Unternehmensfakt. seat: nur diese Einstellung. |
missing | keiner | Was der Mitarbeiter tut, solange die Frage unbeantwortet ist. |
money | false | Kennzeichnet einen Geldbetrag. Eine Geldfrage darf keinen Standardwert haben. |
Sidecar-Tools
Eine App mit Sidecar stellt ihrem Mitarbeiter HTTP-Endpunkte als Tools bereit. Nebo registriert jeden Eintrag als app__<app>__<name> und schickt Aufrufe an den Sidecar unter method und path. Siehe 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
Jeder Schlüssel unter workflows benennt einen Workflow; der Name ist seine Kennung. Das vollständige Format findest du unter Workflows, Trigger und Aktivitäten.