Перший робочий процес
Додайте словник 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 та інших інструментів робочих процесів, перелічених на сторінці Помічники й команди.