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 задаёт типизированные вопросы о проделанной работе и записывает структурированные ответы, по которым может маршрутизировать 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 проверяет обязательные параметры каждого типизированного действия при старте запуска и отклоняет ветвь, указывающую на неизвестное действие.