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 KB або більше скорочується до скалярних полів, із збереженням заголовків листів і посилань на вкладення.
_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 та інших інструментів робочих процесів, перелічених на сторінці Помічники й команди.