NeboAI
NeboAI
Начать

Рабочие процессы

Рабочий процесс — это работа, которую сотрудник выполняет без просьбы: утренняя сводка, ответ на каждое новое сообщение, еженедельный отчёт. Каждый рабочий процесс связывает триггер с действиями, которые выполняет сотрудник. Рабочие процессы хранятся в agent.json сотрудника, поэтому переходят вместе с ролью.

Первый рабочий процесс

Добавьте карту workflows в agent.json. Каждый ключ называет рабочий процесс; каждое значение содержит триггер и действия.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Этот рабочий процесс запускается в 08:00 по будням по местному времени бота. Сотрудник выполняет действие со своей личностью, навыками и подключениями.

Поля рабочего процесса

ПолеЗначение
triggerОбязательно. Когда запускается рабочий процесс. См. «Триггеры».
descriptionДля чего нужен рабочий процесс.
activitiesШаги. См. «Действия».
connectionsРёбра {from, to, label}, которые превращают действия в граф. __trigger__ — начало, а __emit__ — конец.
emitСобытия, которые объявляет этот рабочий процесс по завершении: список или одна строка через запятую. См. «События».
inputsЗначения, передаваемые в каждый запуск.
budget{total_per_run, cost_estimate}. В запуске-графе total_per_run ограничивает выходные токены; в остальных случаях оба значения — оценки.
caseПревращает рабочий процесс в один долгий кейс на каждого человека или объект. См. «Кейсы».

Рабочий процесс с триггером и без действий допустим. Наблюдение без действий лишь передаёт свои события другим рабочим процессам.

Как выполняется запуск

Без connections действия выполняются по порядку, и каждое выполняет сотрудник. Результат каждого действия передаётся следующему. Действие без вывода завершает запуск.

С connections действия образуют граф. Ветви выполняются параллельно, а шесть типов действий выполняются без модели: condition, loop, wait, http, command и decide. Используйте граф, когда маршрутизация должна быть точной.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Что получает запуск

У сотрудника всегда есть его личность и ответы владельца на вопросы из его inputs. Запуск также получает эти значения — в зависимости от триггера.

Входные данныеЕсть, когда
_event_source, _event_payload, _event_originСработал триггер события. Полезные данные размером 8 КБ и больше сокращаются до скалярных полей, при этом заголовки писем и ссылки на вложения сохраняются.
_watch_payloadСработал триггер наблюдения или папки. Одна строка вывода наблюдателя или {files} для папки.
inputsВсегда. Собственные значения inputs рабочего процесса.

Кейсы

Некоторая работа растягивается на дни: лид, которому нужны повторные контакты, запрос, ожидающий документов. Добавьте case, и рабочий процесс будет вести один открытый кейс на каждого человека или объект вместо того, чтобы каждый раз начинать заново.

ПолеЗначение
keyОбязательно. Пути через точку в данных триггера, перечисленные через запятую, которые определяют субъекта, например contactEmail,email,phone.
typeВид кейса, например lead. Рабочие процессы с одинаковым типом используют общие кейсы. По умолчанию — имя рабочего процесса.
default_waitСколько ждать, если ход не называет срок ожидания: 3d, 12h, 45m. По умолчанию три дня.

Каждый ход кейса должен заканчиваться одним JSON-объектом, и после него ничего не должно быть. result — это бизнес-состояние; next говорит движку wait или close. Крайний срок указывается в RFC 3339 или как относительный промежуток. Всё остальное — недопустимый ход.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Ограничения и восстановление

  • Каждое действие может занимать до 50 ходов модели, если params.maxIterations не задаёт иное.
  • В графе одно действие может выполниться в рамках запуска не более 10 000 раз.
  • Лимит расходов, который владелец установил для сотрудника, останавливает запуск при достижении. token_budget действия — это оценка.
  • Запуск, прерванный перезапуском, помечается как прерванный и возобновляется один раз.
  • Сотрудник может завершить запуск досрочно с помощью инструмента exit.

Запуск рабочих процессов и управление ими

Владелец может запустить любой рабочий процесс вручную. Сотрудники управляют рабочими процессами с помощью run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled и других инструментов рабочих процессов, перечисленных на странице Помощники и команды.