Az első munkafolyamat
Adjon hozzá egy workflows leképezést az agent.json fájlhoz. Minden kulcs egy munkafolyamatot nevez meg; minden érték egy indítót és tevékenységeket tartalmaz.
{
"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." }
]
}
}
} Ez a munkafolyamat hétköznapokon 08:00-kor fut, a bot helyi ideje szerint. A munkatárs a saját személyiségével, készségeivel és kapcsolataival végzi el a tevékenységet.
Munkafolyamat-mezők
| Mező | Jelentés |
|---|---|
trigger | Kötelező. Mikor fut a munkafolyamat. Lásd: Indítók. |
description | Mire szolgál a munkafolyamat. |
activities | A lépések. Lásd: Tevékenységek. |
connections | {from, to, label} élek, amelyek gráffá teszik a tevékenységeket. A __trigger__ a kezdet, az __emit__ a vég. |
emit | Események, amelyeket ez a munkafolyamat a befejezésekor bejelent: lista vagy egy vesszővel elválasztott karakterlánc. Lásd: Események. |
inputs | Minden futásnak átadott értékek. |
budget | {total_per_run, cost_estimate}. Gráfos futásban a total_per_run korlátozza a kimeneti tokeneket; egyébként mindkettő becslés. |
case | A munkafolyamatot személyenként vagy dolgonként egy hosszan futó üggyé teszi. Lásd: Ügyek. |
Az indítóval rendelkező, de tevékenységek nélküli munkafolyamat érvényes. A tevékenységek nélküli figyelés csak továbbítja az eseményeit más munkafolyamatoknak.
Hogyan fut le egy futás
connections nélkül a tevékenységek sorban futnak, és mindegyiket a munkatárs végzi el. Minden tevékenység eredménye a következőhöz kerül. Egy kimenet nélküli tevékenység befejezi a futást.
connections megadásával a tevékenységek gráfot alkotnak. Az ágak párhuzamosan futnak, és hat tevékenységtípus a modell nélkül fut: condition, loop, wait, http, command és decide. Használjon gráfot, ha az irányításnak pontosnak kell lennie.
{
"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"]
} Mit kap egy futás
A munkatárs mindig rendelkezik a saját személyiségével és a tulajdonos válaszaival az inputs kérdéseire. Egy futás az indítójától függően ezeket az értékeket is megkapja.
| Bemenet | Mikor van jelen |
|---|---|
_event_source, _event_payload, _event_origin | Egy eseményindító aktiválódott. A 8 KB-os vagy nagyobb adattartalmak a skaláris mezőikre rövidülnek, az e-mail-fejlécek és a mellékletekre mutató hivatkozások megmaradnak. |
_watch_payload | Egy figyelő vagy mappaindító aktiválódott. A figyelő kimenetének egy sora, illetve mappánál {files}. |
inputs | Mindig. A munkafolyamat saját inputs értékei. |
Ügyek
Egyes munkák napokig tartanak: egy érdeklődő, akit utána kell követni, egy dokumentumokra váró kérés. Adja hozzá a case mezőt, és a munkafolyamat személyenként vagy dolgonként egy nyitott ügyet tart fenn ahelyett, hogy minden alkalommal elölről kezdené.
| Mező | Jelentés |
|---|---|
key | Kötelező. Vesszővel elválasztott, pontokkal tagolt útvonalak az indító adataiban, amelyek azonosítják az alanyt, például contactEmail,email,phone. |
type | Az ügy fajtája, például lead. Az azonos típusú munkafolyamatok közösen használják az ügyeket. Alapértéke a munkafolyamat neve. |
default_wait | Mennyi ideig várjon, ha egy kör nem ad meg várakozást: 3d, 12h, 45m. Alapérték három nap. |
Egy ügy minden körének egyetlen JSON-objektummal kell végződnie, utána semmivel. A result az üzleti állapot; a next megmondja a motornak, hogy wait vagy close. A határidő RFC 3339 formátumú vagy relatív időtartam. Minden más érvénytelen kör.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Korlátok és helyreállítás
- Minden tevékenység legfeljebb 50 modellkört használhat, hacsak a
params.maxIterationsmást nem ír elő. - Egy gráfban egy tevékenység egy futás alatt legfeljebb 10 000-szer futhat.
- A tulajdonos által a munkatársra beállított költési korlát elérésekor leállítja a futást. Egy tevékenység
token_budgetértéke becslés. - Az újraindítás miatt megszakadt futás megszakítottként jelölődik meg, és egyszer folytatódik.
- A munkatárs az
exiteszközzel korábban is befejezheti a futást.
Munkafolyamatok futtatása és kezelése
A tulajdonos bármely munkafolyamatot kézzel is futtathatja. A munkatársak a run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled és a Segítők és csapatok oldalon felsorolt többi munkafolyamat-eszközzel kezelik a munkafolyamatokat.