Příklad
{
"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." }
]
}
}
} Pole
| Pole | Typ | Význam |
|---|---|---|
requires.interfaces | seznam řetězců | Schopnosti, které role potřebuje, například mail nebo ledger. Udělují se při přijetí; každá operace podmíněná schválením zůstává položkou ke schválení. Viz Schopnosti a schvalování. |
requires.plugins | seznam řetězců | Pluginy instalované se zaměstnancem. Použijte jen tehdy, když role na jednom pluginu skutečně závisí; přednost dejte schopnosti. |
requires.tools | seznam řetězců | Nástroje načtené do relace zaměstnance od jeho prvního tahu. Schvalování se tím nikdy neobchází. |
skills | seznam řetězců | Dovednosti z obchodu k instalaci a použití: @org/skills/name, volitelně s @version, nebo kód SKIL-. Dovednosti ve vlastní složce skills/ balíčku žádný záznam nepotřebují. |
inputs | list | Otázky, na které vlastník odpoví při přijetí. Viz Vstupy. |
memory | object | Jak se uchovávají konverzace a paměť. Viz Persona a paměť. |
subscribes | seznam řetězců | Oblasti firemních faktů, které zaměstnanec při jejich změně znovu načte, například finance.ar.*. |
ceiling | map | Operace na "approval". Tato operace se u tohoto zaměstnance vždy zeptá vlastníka. Žádná jiná hodnota se nepřijímá. |
workflows | map | Název pracovního postupu na pracovní postup. Viz Pracovní postupy. |
tools | list | Nástroje HTTP obsluhované sidecarem aplikace. Viz Nástroje sidecaru. |
scopes | map | Pojmenované skupiny tools, skills a plugins. Když je rozsah aktivní, jeho plugins se zaměstnanci popíšou. |
Vstupy
Vstup je otázka, na kterou vlastník odpovídá při najímání. Odpovědi se zaměstnanci zobrazí v části „Configured Inputs“ a vyplní zástupné symboly {{key}} ve spouštěčích sledování a složek.
{
"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"
} | Pole | Výchozí | Význam |
|---|---|---|
key | povinné | Název používaný v zástupných symbolech. Jako náhrada se přijímá name. |
label | z key | Otázka zobrazená vlastníkovi. |
type | text | text, textarea, number, select, checkbox nebo radio. |
required | false | Označuje otázku, na kterou vlastník musí odpovědět. |
default | žádná | Předvyplněná odpověď. Není povolena u otázky na peníze. |
placeholder, description | žádná | Text nápovědy. |
options | žádná | Pro select a radio: objekty {value, label} nebo prosté řetězce. |
id | žádná | Stálý název faktu s tečkami, například finance.ap.invoice_mailbox, aby ho mohli sdílet i další zaměstnanci. |
scope | company | company: sdílený firemní fakt. seat: jen pro toto přijetí. |
missing | žádná | Co zaměstnanec dělá, dokud otázka není zodpovězená. |
money | false | Označuje peněžní částku. Otázka na peníze nemůže mít výchozí hodnotu. |
Nástroje sidecaru
Aplikace se sidecarem zpřístupňuje svému zaměstnanci koncové body HTTP jako nástroje. Nebo každou položku registruje jako app__<app>__<name> a volání posílá sidecaru na method a path. Viz Sidecar aplikace.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Pracovní postupy
Každý klíč v workflows pojmenovává jeden pracovní postup; název je jeho identifikátor. Úplný formát najdete v částech Pracovní postupy, Spouštěče a Aktivity.