Поля
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Поле | За замовчуванням | Значення |
|---|---|---|
id | обов'язкове | Унікальний у межах робочого процесу. Використовується в connections і шляхах до даних. |
type | custom | Крок співробітника або один із condition, loop, wait, http, command, decide. |
intent | немає | Чого має досягти співробітник. Крок співробітника потребує intent або steps. |
steps | [] | Упорядковані інструкції, коли одного речення недостатньо. |
label | немає | Назва, яку бачить власник. |
skills | [] | Навички, які слід використовувати. Перелічені тут навички з маркетплейсу встановлюються разом зі співробітником. |
tools | [] | Якщо задано, це єдині інструменти, які може використовувати крок. |
requires_tools | [] | Інструменти, які мають успішно виконатися, щоб крок вважався завершеним. |
cmds | [] | Команди плагінів, названі для кроку. |
mcps | [] | MCP-сервери, названі для кроку. |
model | немає | Id моделі для цього кроку. |
params | немає | Параметри для типізованих дій і maxIterations для кроків співробітника. |
min_iterations | немає | Мінімальна кількість ходів моделі, перш ніж крок може завершитися. |
token_budget | немає | {max}. Оцінка. |
on_error | {retry: 1, fallback: notify_owner} | Повторні спроби, потім запасний варіант. Будь-який збій після повторних спроб завершує запуск. |
Кроки співробітника
Крок співробітника виконується як хід співробітника: діють його персона, пам'ять і підключення, і він може використати до 50 ходів моделі або params.maxIterations. Результати попередніх кроків передаються як блоки [Activity 'id' result]. Кроку, який завершує робочий процес зі списком emit, вказують викликати emit_event із цими подіями. Інструмент exit завжди доступний, щоб завершити запуск.
Контекст даних
Типізовані дії читають значення за шляхом через крапку з одного об'єкта: inputs містить вхідні дані запуску, nodes.<id> — вивід кожної завершеної дії (розібраний як JSON, якщо це JSON), а item — поточний елемент усередині циклу. Шлях без префікса шукається в inputs, потім у nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression обов'язковий. Його вихідні з'єднання позначено True і False. params.mode визначає, як його читати:
| Режим | Вираз |
|---|---|
expression | За замовчуванням. path op value з ==, !=, >=, <=, > або <, порівнюється як числа, коли обидві сторони числа; або простий шлях, істина, коли його значення істинне. |
exists | Шлях; істина, коли він дає істинне значення. |
contains | path contains text або простий текст, що зіставляється з попереднім виводом. |
regex | Шаблон, який зіставляється з попереднім виводом. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source — шлях до списку. З'єднання з позначкою Each item веде до тіла, яке виконується один раз для кожного елемента із заданим item; з'єднання з позначкою Done виконується після всіх елементів. Ітерації стартують разом, якщо ви не задасте concurrency. Також приймаються maxIterations і batchSize.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http і command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Тип | Обов'язкове | Поведінка |
|---|---|---|
wait | params.duration | Робить паузу на проміжок у s, m або h. Очікування до певного моменту немає; щоб продовжити за подією, запустіть на ній другий робочий процес. |
http | params.url | Виконує запит. method, headers і body необов'язкові. |
command | params.command | Виконує команду оболонки. Її stdout — це вивід дії. |
decide
Дія decide ставить типізовані запитання про виконану роботу й записує структуровані відповіді, за якими може маршрутизувати умова.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Тип запитання | criteria | Відповідь |
|---|---|---|
choice | Об'єкт «варіант — опис», від 2 до 255 варіантів. | choice, confidence і probabilities. |
score | Список від 2 до 10 упорядкованих рівнів. | score від 0 (перший рівень) і вище та confidence. |
noul | Немає. | noul, ймовірність того, що твердження правдиве. |
Маршрутизуйте за відповіддю за допомогою умови, наприклад nodes.triage.urgency.score >= 1.5. params.default задає безпечну відповідь на кожне запитання, коли рішення ухвалити неможливо; відповідь за замовчуванням має впевненість 0. Запитання без значення за замовчуванням лишається без відповіді, тож умови щодо нього йдуть ребром False.
Помилки
on_error.retry задає, скільки разів повторюється невдала дія; за замовчуванням 1. Після останньої повторної спроби запуск завершується, і за типового fallback зі значенням notify_owner власник отримує повідомлення. Nebo перевіряє обов'язкові параметри кожної типізованої дії на початку запуску й відхиляє гілку, що вказує на невідому дію.