První pracovní postup
Přidejte do agent.json mapu workflows. Každý klíč pojmenovává pracovní postup; každá hodnota má spouštěč a činnosti.
{
"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 běží ve všední dny v 08:00 podle místního času bota. Zaměstnanec činnost provede se svou vlastní personou, dovednostmi a připojeními.
Pole pracovního postupu
| Pole | Význam |
|---|---|
trigger | Povinné. Kdy pracovní postup běží. Viz Spouštěče. |
description | K čemu pracovní postup slouží. |
activities | Kroky. Viz Činnosti. |
connections | Hrany {from, to, label}, které z činností vytvoří graf. __trigger__ je začátek a __emit__ konec. |
emit | Události, které tento pracovní postup po dokončení ohlásí: seznam nebo jeden řetězec oddělený čárkami. Viz Události. |
inputs | Hodnoty předávané každému běhu. |
budget | {total_per_run, cost_estimate}. V běhu grafu total_per_run omezuje výstupní tokeny; jinak jsou obě hodnoty jen odhady. |
case | Udělá z pracovního postupu jeden dlouhodobý případ pro každou osobu nebo věc. Viz Případy. |
Pracovní postup se spouštěčem a bez činností je platný. Sledování bez činností jen předává své události dalším pracovním postupům.
Jak běh probíhá
Bez connections běží činnosti postupně a každou z nich provádí zaměstnanec. Výsledek každé činnosti se předá další. Činnost bez výstupu běh ukončí.
S connections tvoří činnosti graf. Větve běží paralelně a šest typů činností běží bez modelu: condition, loop, wait, http, command a decide. Graf použijte, když musí být směrování přesné.
{
"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"]
} Co běh dostává
Zaměstnanec má vždy svou personu a odpovědi vlastníka na své otázky inputs. Běh navíc podle svého spouštěče dostává tyto hodnoty.
| Vstup | Kdy je k dispozici |
|---|---|
_event_source, _event_payload, _event_origin | Spustil se spouštěč event. Datové části o velikosti 8 KB a více se zkrátí na skalární pole, přičemž hlavičky e-mailů a odkazy na přílohy zůstanou zachovány. |
_watch_payload | Spustil se spouštěč watch nebo folder. Jeden řádek výstupu sledovače, nebo {files} u složky. |
inputs | Vždy. Vlastní hodnoty inputs pracovního postupu. |
Případy
Některá práce trvá dny: potenciální zákazník, který potřebuje navazující kontakt, žádost čekající na dokumenty. Přidejte case a pracovní postup bude pro každou osobu nebo věc udržovat jeden otevřený případ, místo aby pokaždé začínal od nuly.
| Pole | Význam |
|---|---|
key | Povinné. Tečkové cesty do dat spouštěče oddělené čárkami, které identifikují subjekt, například contactEmail,email,phone. |
type | Druh případu, například lead. Pracovní postupy se stejným typem sdílejí případy. Výchozí hodnota je název pracovního postupu. |
default_wait | Jak dlouho čekat, když tah neuvádí žádné čekání: 3d, 12h, 45m. Výchozí hodnota jsou tři dny. |
Každý tah případu musí skončit jedním objektem JSON a za ním už nic. result je obchodní stav; next říká stroji, zda má wait, nebo close. Termín je ve formátu RFC 3339 nebo jako relativní doba. Cokoli jiného je neplatný tah.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Limity a obnovení
- Každá činnost může zabrat až 50 tahů modelu, pokud
params.maxIterationsneurčuje jinak. - V grafu může jedna činnost během jednoho běhu proběhnout nejvýše 10 000krát.
- Limit útraty, který vlastník zaměstnanci nastavil, běh po dosažení zastaví.
token_budgetčinnosti je jen odhad. - Běh přerušený restartem se označí jako přerušený a jednou se obnoví.
- Zaměstnanec může běh ukončit předčasně nástrojem
exit.
Spouštění a správa pracovních postupů
Vlastník může libovolný pracovní postup spustit ručně. Zaměstnanci spravují pracovní postupy pomocí run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled a dalších nástrojů pro pracovní postupy uvedených na stránce Pomocníci a týmy.