Приклад
{
"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 | HTTP-інструменти, які надає супровідний процес застосунку. Див. «Інструменти супровідного процесу». |
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 | Позначає грошову суму. Грошове запитання не може мати значення за замовчуванням. |
Інструменти супровідного процесу
Застосунок із супровідним процесом надає своєму співробітникові HTTP-ендпоінти як інструменти. Nebo реєструє кожен запис як app__<app>__<name> і надсилає виклики до супровідного процесу за method і path. Див. Супровідний процес застосунку.
"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 називає один робочий процес; назва є його ідентифікатором. Повний формат описано в розділах Робочі процеси, Тригери і Дії.