NeboAI
NeboAI
Почати

Дії

Дія — це один крок робочого процесу. Більшість дій виконує співробітник: ви вказуєте намір, а він виконує роботу своїми навичками й підключеннями. Шість типів працюють без моделі, тож маршрутизація й час залишаються точними.

Поля

{
  "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 і шляхах до даних.
typecustomКрок співробітника або один із 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Шлях; істина, коли він дає істинне значення.
containspath 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" } }
ТипОбов'язковеПоведінка
waitparams.durationРобить паузу на проміжок у s, m або h. Очікування до певного моменту немає; щоб продовжити за подією, запустіть на ній другий робочий процес.
httpparams.urlВиконує запит. method, headers і body необов'язкові.
commandparams.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 перевіряє обов'язкові параметри кожної типізованої дії на початку запуску й відхиляє гілку, що вказує на невідому дію.