Поля
{
"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 задаёт типизированные вопросы о проделанной работе и записывает структурированные ответы, по которым может маршрутизировать condition.
{
"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 — вероятность того, что утверждение верно. |
Маршрутизируйте по ответу с помощью condition, например nodes.triage.urgency.score >= 1.5. params.default задаёт безопасный ответ на каждый вопрос, когда решение принять невозможно; у ответа по умолчанию уверенность 0. Вопрос без значения по умолчанию остаётся без ответа, поэтому условия по нему идут по ребру False.
Ошибки
on_error.retry задаёт, сколько раз повторяется неудавшееся действие; по умолчанию 1. После последней попытки запуск завершается, и при запасном варианте по умолчанию fallback со значением notify_owner владелец получает уведомление. Nebo проверяет обязательные параметры каждого типизированного действия при старте запуска и отклоняет ветвь, указывающую на неизвестное действие.