Un prim flux de lucru
Adaugă o hartă workflows în agent.json. Fiecare cheie numește un flux de lucru; fiecare valoare are un declanșator și activități.
{
"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." }
]
}
}
} Acest flux de lucru rulează la 08:00 în zilele lucrătoare, după ora locală a botului. Angajatul îndeplinește activitatea cu propria persona, propriile abilități și propriile conexiuni.
Câmpurile fluxului de lucru
| Câmp | Semnificație |
|---|---|
trigger | Obligatoriu. Când rulează fluxul de lucru. Vezi Declanșatoare. |
description | La ce servește fluxul de lucru. |
activities | Pașii. Vezi Activități. |
connections | Muchii {from, to, label} care transformă activitățile într-un graf. __trigger__ este începutul, iar __emit__ sfârșitul. |
emit | Evenimentele pe care acest flux de lucru le anunță când se termină: o listă sau un șir separat prin virgule. Vezi Evenimente. |
inputs | Valori transmise fiecărei rulări. |
budget | {total_per_run, cost_estimate}. Într-o rulare de tip graf, total_per_run limitează tokenurile de ieșire; altfel, ambele sunt estimări. |
case | Transformă fluxul de lucru într-un singur caz de lungă durată pentru fiecare persoană sau lucru. Vezi Cazuri. |
Un flux de lucru cu un declanșator și fără activități este valid. Un watch fără activități doar transmite evenimentele sale către alte fluxuri de lucru.
Cum se execută o rulare
Fără connections, activitățile rulează în ordine, iar angajatul o îndeplinește pe fiecare. Rezultatul fiecărei activități este transmis următoarei. O activitate fără rezultat încheie rularea.
Cu connections, activitățile formează un graf. Ramurile rulează în paralel, iar șase tipuri de activități rulează fără model: condition, loop, wait, http, command și decide. Folosește un graf când direcționarea trebuie să fie exactă.
{
"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"]
} Ce primește o rulare
Angajatul are întotdeauna persona sa și răspunsurile proprietarului la întrebările din inputs. O rulare primește și aceste valori, în funcție de declanșator.
| Intrare | Prezent când |
|---|---|
_event_source, _event_payload, _event_origin | S-a declanșat un eveniment. Conținuturile de 8 KB sau mai mari sunt scurtate la câmpurile lor scalare, păstrând antetele e-mailurilor și referințele la atașamente. |
_watch_payload | S-a declanșat un watch sau un folder. O linie din rezultatul observatorului sau {files} pentru un folder. |
inputs | Întotdeauna. Valorile inputs proprii ale fluxului de lucru. |
Cazuri
Unele munci se întind pe mai multe zile: un client potențial care are nevoie de reveniri, o cerere care așteaptă documente. Adaugă case, iar fluxul de lucru păstrează un caz deschis pentru fiecare persoană sau lucru, în loc să înceapă de la zero de fiecare dată.
| Câmp | Semnificație |
|---|---|
key | Obligatoriu. Căi cu puncte, separate prin virgule, în datele declanșatorului, care identifică subiectul, de exemplu contactEmail,email,phone. |
type | Tipul de caz, de exemplu lead. Fluxurile de lucru cu același tip împart cazurile. Implicit este numele fluxului de lucru. |
default_wait | Cât se așteaptă când o tură nu specifică o așteptare: 3d, 12h, 45m. Implicit trei zile. |
Fiecare tură a unui caz trebuie să se încheie cu un singur obiect JSON și nimic după el. result este starea de business; next îi spune motorului să facă wait sau close. Un termen limită este în format RFC 3339 sau un interval relativ. Orice altceva este o tură invalidă.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Limite și recuperare
- Fiecare activitate poate folosi până la 50 de ture de model, dacă
params.maxIterationsnu specifică altfel. - Într-un graf, o activitate poate rula de cel mult 10.000 de ori într-o rulare.
- Limita de cheltuieli setată de proprietar pentru angajat oprește o rulare când este atinsă.
token_budgetal unei activități este o estimare. - O rulare întreruptă de o repornire este marcată ca întreruptă și reluată o singură dată.
- Angajatul poate încheia o rulare mai devreme cu instrumentul
exit.
Rulează și administrează fluxurile de lucru
Proprietarul poate rula manual orice flux de lucru. Angajații administrează fluxurile de lucru cu run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled și celelalte instrumente pentru fluxuri de lucru listate pe pagina Ajutoare și echipe.