Мысал
{
"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." }
]
}
}
} Өрістер
| Өріс | Түрі | Мағынасы |
|---|---|---|
requires.interfaces | жолдар тізімі | Рөлге қажет мүмкіндіктер, мысалы, mail немесе ledger. Жұмысқа алу кезінде беріледі; мақұлдауды қажет ететін әр операция мақұлдау элементі болып қалады. «Мүмкіндіктер және мақұлдаулар» бөлімін қараңыз. |
requires.plugins | жолдар тізімі | Қызметкермен бірге орнатылатын плагиндер. Рөл шынымен бір плагинге тәуелді болғанда ғана пайдаланыңыз; мүмкіндікті таңдаған жөн. |
requires.tools | жолдар тізімі | Қызметкердің сеансына алғашқы жүрістен бастап жүктелетін құралдар. Бұл мақұлдауды ешқашан айналып өтпейді. |
skills | жолдар тізімі | Орнатылып, пайдаланылатын маркетплейс дағдылары: @org/skills/name, қажет болса @version, немесе SKIL- коды. Пакеттің өз skills/ қалтасындағы дағдыларға жазба қажет емес. |
inputs | list | Иесі жұмысқа алу кезінде жауап беретін сұрақтар. «Кіріс деректер» бөлімін қараңыз. |
memory | object | Әңгімелер мен жадының қалай сақталатыны. «Тұлға және жады» бөлімін қараңыз. |
subscribes | жолдар тізімі | Қызметкер өзгерген кезде қайта оқитын компания деректерінің салалары, мысалы, finance.ar.*. |
ceiling | map | Операция мен "approval". Бұл операция осы қызметкер үшін әрдайым иесінен сұрайды. Басқа мән қабылданбайды. |
workflows | map | Жұмыс үдерісінің атауы мен жұмыс үдерісі. «Жұмыс үдерістері» бөлімін қараңыз. |
tools | list | Қолданбаның sidecar-ы ұсынатын HTTP құралдары. «Sidecar құралдары» бөлімін қараңыз. |
scopes | map | tools, skills және plugins атаулы топтары. Аумақ белсенді болғанда оның plugins тізімі қызметкерге сипатталады. |
Кіріс деректер
Енгізу — иесі жалдау кезінде жауап беретін сұрақ. Жауаптар қызметкерге «Configured Inputs» бөлімінде көрінеді және бақылау мен қалта триггерлеріндегі {{key}} толтырғыштарын толтырады.
{
"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"
} | Өріс | Әдепкі | Мағынасы |
|---|---|---|
key | міндетті | Толтырғыштарда пайдаланылатын атау. Балама ретінде name қабылданады. |
label | key мәнінен | Иесіне көрсетілетін сұрақ. |
type | text | text, textarea, number, select, checkbox немесе radio. |
required | false | Сұрақты иесі міндетті түрде жауап беруі тиіс сұрақ ретінде белгілейді. |
default | жоқ | Алдын ала толтырылған жауап. Ақша сұрағында рұқсат етілмейді. |
placeholder, description | жоқ | Анықтама мәтіні. |
options | жоқ | select және radio үшін: {value, label} нысандары немесе қарапайым жолдар. |
id | жоқ | Деректің тұрақты, нүктелі атауы, мысалы, finance.ap.invoice_mailbox, сонда басқа қызметкерлер оны бөлісе алады. |
scope | company | company: компанияның ортақ дерегі. seat: тек осы қызметкер үшін. |
missing | жоқ | Сұраққа жауап берілмей тұрғанда қызметкер не істейді. |
money | false | Ақша сомасын белгілейді. Ақша сұрағының әдепкі мәні болмайды. |
Sidecar құралдары
Sidecar-ы бар қолданба HTTP соңғы нүктелерін өз қызметкеріне құралдар ретінде ұсынады. Nebo әр жазбаны app__<app>__<name> ретінде тіркейді және шақыруларды sidecar-ға method мен path бойынша жібереді. 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 астындағы әр кілт бір жұмыс үдерісін атайды; атауы — оның идентификаторы. Толық пішім Жұмыс үдерістері, Іске қосу шарттары және Әрекеттер беттерінде.