Prí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." }
]
}
}
} Polia
| Pole | Typ | Význam |
|---|---|---|
requires.interfaces | zoznam reťazcov | Schopnosti, ktoré rola potrebuje, napríklad mail alebo ledger. Udeľujú sa pri prijatí; každá operácia podliehajúca schváleniu zostáva položkou na schválenie. Pozri Schopnosti a schválenia. |
requires.plugins | zoznam reťazcov | Doplnky nainštalované spolu so zamestnancom. Použite len vtedy, keď rola naozaj závisí od jedného doplnku; uprednostnite schopnosť. |
requires.tools | zoznam reťazcov | Nástroje načítané do relácie zamestnanca od jeho prvého ťahu. Nikdy to neobchádza schválenie. |
skills | zoznam reťazcov | Zručnosti z obchodu na inštaláciu a použitie: @org/skills/name, voliteľne @version, alebo kód SKIL-. Zručnosti vo vlastnom priečinku skills/ balíka nepotrebujú záznam. |
inputs | list | Otázky, na ktoré vlastník odpovedá pri prijatí. Pozri Vstupy. |
memory | object | Ako sa uchovávajú konverzácie a pamäť. Pozri Persona a pamäť. |
subscribes | zoznam reťazcov | Oblasti firemných faktov, ktoré si zamestnanec znova prečíta, keď sa zmenia, napríklad finance.ar.*. |
ceiling | map | Operácia na "approval". Táto operácia sa pri tomto zamestnancovi vždy pýta vlastníka. Iná hodnota sa neprijíma. |
workflows | map | Názov pracovného postupu na pracovný postup. Pozri Pracovné postupy. |
tools | list | Nástroje HTTP poskytované sidecarom aplikácie. Pozri Nástroje sidecaru. |
scopes | map | Pomenované skupiny tools, skills a plugins. Doplnky plugins danej oblasti sa zamestnancovi opíšu, keď je táto oblasť aktívna. |
Vstupy
Vstup je otázka, na ktorú vlastník odpovedá pri prijímaní zamestnanca. Odpovede sa zamestnancovi zobrazia v časti „Configured Inputs“ a vypĺňajú zástupné symboly {{key}} v spúšťačoch sledovania a priečinkov.
{
"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 | Predvolené | Význam |
|---|---|---|
key | povinné | Názov používaný v zástupných symboloch. Ako náhrada sa prijíma aj name. |
label | z key | Otázka zobrazená vlastníkovi. |
type | text | text, textarea, number, select, checkbox alebo radio. |
required | false | Označí otázku ako takú, na ktorú musí vlastník odpovedať. |
default | žiadne | Vopred vyplnená odpoveď. Pri finančnej otázke nie je povolená. |
placeholder, description | žiadne | Text pomocníka. |
options | žiadne | Pre select a radio: objekty {value, label} alebo obyčajné reťazce. |
id | žiadne | Stály názov faktu s bodkami, napríklad finance.ap.invoice_mailbox, aby ho mohli zdieľať aj iní zamestnanci. |
scope | company | company: zdieľaný firemný fakt. seat: len pre toto prijatie. |
missing | žiadne | Čo zamestnanec robí, kým otázka nie je zodpovedaná. |
money | false | Označuje peňažnú sumu. Finančná otázka nemôže mať predvolenú hodnotu. |
Nástroje sidecaru
Aplikácia so sidecarom sprístupňuje svojmu zamestnancovi koncové body HTTP ako nástroje. Nebo zaregistruje každý záznam ako app__<app>__<name> a volania posiela do sidecaru na method a path. Pozri Sidecar aplikácie.
"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ý kľúč pod workflows pomenúva jeden pracovný postup; názov je jeho identifikátor. Úplný formát nájdete v častiach Pracovné postupy, Spúšťače a Aktivity.