Példa
{
"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." }
]
}
}
} Mezők
| Mező | Típus | Jelentés |
|---|---|---|
requires.interfaces | karakterláncok listája | A szerepkörhöz szükséges képességek, például mail vagy ledger. Felvételkor kerülnek megadásra; minden jóváhagyáshoz kötött művelet jóváhagyási tétel marad. Lásd: Képességek és jóváhagyások. |
requires.plugins | karakterláncok listája | A munkatárssal együtt telepített bővítmények. Csak akkor használja, ha a szerepkör tényleg egyetlen bővítménytől függ; inkább képességet adjon meg. |
requires.tools | karakterláncok listája | Eszközök, amelyek az első körtől betöltődnek a munkatárs munkamenetébe. Ez soha nem kerüli meg a jóváhagyást. |
skills | karakterláncok listája | Telepítendő és használandó piactéri készségek: @org/skills/name, opcionálisan @version, vagy egy SKIL- kód. A csomag saját skills/ mappájában lévő készségekhez nem kell bejegyzés. |
inputs | list | Kérdések, amelyekre a tulajdonos felvételkor válaszol. Lásd: Bemenetek. |
memory | object | Hogyan kezeli a beszélgetéseket és a memóriát. Lásd: Személyiség és memória. |
subscribes | karakterláncok listája | Céges ténykörök, amelyeket a munkatárs változáskor újraolvas, például finance.ar.*. |
ceiling | map | Művelet → "approval". Ennél a munkatársnál az adott művelet mindig megkérdezi a tulajdonost. Más érték nem fogadható el. |
workflows | map | Munkafolyamat neve → munkafolyamat. Lásd: Munkafolyamatok. |
tools | list | Egy alkalmazás sidecarja által kiszolgált HTTP-eszközök. Lásd: Sidecar-eszközök. |
scopes | map | A tools, skills és plugins elnevezett csoportjai. Egy hatókör plugins elemeit a munkatárs akkor kapja meg leírásként, amikor az a hatókör aktív. |
Bemenetek
A bemenet egy kérdés, amelyre a tulajdonos a felvételkor válaszol. A válaszok a munkatárs számára a „Configured Inputs” alatt jelennek meg, és kitöltik a {{key}} helyőrzőket a figyelő- és mappaindítókban.
{
"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"
} | Mező | Alapértelmezés | Jelentés |
|---|---|---|
key | kötelező | A helyőrzőkben használt név. Tartalékként a name is elfogadott. |
label | a key alapján | A tulajdonosnak megjelenített kérdés. |
type | text | text, textarea, number, select, checkbox vagy radio. |
required | false | Megjelöli a kérdést, amelyre a tulajdonosnak kötelező válaszolnia. |
default | nincs | Előre kitöltött válasz. Pénzösszegre vonatkozó kérdésnél nem engedélyezett. |
placeholder, description | nincs | Súgószöveg. |
options | nincs | A select és a radio esetén: {value, label} objektumok vagy egyszerű karakterláncok. |
id | nincs | Stabil, pontokkal tagolt név a ténynek, például finance.ap.invoice_mailbox, hogy más munkatársak is megoszthassák. |
scope | company | company: közös céges tény. seat: csak ez a felvétel. |
missing | nincs | Mit csinál a munkatárs, amíg a kérdés megválaszolatlan. |
money | false | Pénzösszeget jelöl. Egy pénzösszegre vonatkozó kérdésnek nem lehet alapértelmezett értéke. |
Sidecar-eszközök
A sidecarral rendelkező alkalmazás HTTP-végpontokat tesz elérhetővé eszközként a munkatársa számára. A Nebo minden bejegyzést app__<app>__<name> néven regisztrál, és a hívásokat a sidecarhoz küldi a method és a path szerint. Lásd: Alkalmazás-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" } } }
}
] Munkafolyamatok
A workflows alatti minden kulcs egy munkafolyamatot nevez meg; a név az azonosítója. A teljes formátumot lásd: Munkafolyamatok, Indítók és Tevékenységek.