Prvý pracovný postup
Do agent.json pridajte mapu workflows. Každý kľúč pomenúva pracovný postup; každá hodnota má spúšťač a aktivity.
{
"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." }
]
}
}
} Tento pracovný postup beží v pracovné dni o 08:00 podľa miestneho času bota. Zamestnanec vykoná aktivitu so svojou vlastnou osobnosťou, zručnosťami a pripojeniami.
Polia pracovného postupu
| Pole | Význam |
|---|---|
trigger | Povinné. Kedy pracovný postup beží. Pozrite Spúšťače. |
description | Na čo pracovný postup slúži. |
activities | Kroky. Pozrite Aktivity. |
connections | Hrany {from, to, label}, ktoré z aktivít robia graf. __trigger__ je začiatok a __emit__ koniec. |
emit | Udalosti, ktoré tento pracovný postup oznámi po dokončení: zoznam alebo jeden reťazec oddelený čiarkami. Pozrite Udalosti. |
inputs | Hodnoty odovzdané každému behu. |
budget | {total_per_run, cost_estimate}. Pri behu grafu total_per_run obmedzuje výstupné tokeny; inak sú obe hodnoty odhady. |
case | Zmení pracovný postup na jeden dlhodobý prípad pre každú osobu alebo vec. Pozrite Prípady. |
Pracovný postup so spúšťačom a bez aktivít je platný. Sledovanie bez aktivít iba preposiela svoje udalosti iným pracovným postupom.
Ako prebieha beh
Bez connections bežia aktivity v poradí a každú z nich vykoná zamestnanec. Výsledok každej aktivity sa odovzdá ďalšej. Aktivita bez výstupu beh ukončí.
S connections tvoria aktivity graf. Vetvy bežia súbežne a šesť typov aktivít beží bez modelu: condition, loop, wait, http, command a decide. Graf použite, keď musí byť smerovanie presné.
{
"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"]
} Čo beh dostane
Zamestnanec má vždy svoju osobnosť a odpovede vlastníka na otázky v inputs. Beh dostane aj tieto hodnoty, podľa toho, aký má spúšťač.
| Vstup | K dispozícii, keď |
|---|---|
_event_source, _event_payload, _event_origin | Spustil sa spúšťač event. Obsah s veľkosťou 8 KB a viac sa skráti na skalárne polia, pričom hlavičky e-mailov a odkazy na prílohy sa zachovajú. |
_watch_payload | Spustil sa spúšťač watch alebo folder. Jeden riadok výstupu sledovača alebo {files} pri priečinku. |
inputs | Vždy. Vlastné hodnoty inputs pracovného postupu. |
Prípady
Niektorá práca trvá dni: potenciálny zákazník, ktorý potrebuje opakované kontaktovanie, žiadosť čakajúca na dokumenty. Pridajte case a pracovný postup bude namiesto zakaždým nového začiatku udržiavať jeden otvorený prípad pre každú osobu alebo vec.
| Pole | Význam |
|---|---|
key | Povinné. Cesty s bodkami do údajov spúšťača, oddelené čiarkami, ktoré identifikujú subjekt, napríklad contactEmail,email,phone. |
type | Druh prípadu, napríklad lead. Pracovné postupy s rovnakým typom zdieľajú prípady. Predvolene názov pracovného postupu. |
default_wait | Ako dlho čakať, keď ťah neurčí čakanie: 3d, 12h, 45m. Predvolene tri dni. |
Každý ťah prípadu musí skončiť jedným objektom JSON a nič za ním nesmie nasledovať. result je obchodný stav; next hovorí jadru, či má wait alebo close. Termín je vo formáte RFC 3339 alebo ako relatívny úsek. Čokoľvek iné je neplatný ťah.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Obmedzenia a obnova
- Každá aktivita môže použiť najviac 50 ťahov modelu, pokiaľ
params.maxIterationsneurčuje inak. - V grafe sa jedna aktivita môže v jednom behu spustiť najviac 10 000-krát.
- Limit výdavkov, ktorý vlastník pre zamestnanca nastavil, beh po dosiahnutí zastaví.
token_budgetaktivity je odhad. - Beh prerušený reštartom sa označí ako prerušený a raz sa obnoví.
- Zamestnanec môže beh ukončiť skôr nástrojom
exit.
Spúšťanie a správa pracovných postupov
Vlastník môže ktorýkoľvek pracovný postup spustiť ručne. Zamestnanci spravujú pracovné postupy pomocou run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled a ďalších nástrojov pracovných postupov uvedených na stránke Pomocníci a tímy.