Isang unang workflow
Magdagdag ng workflows map sa agent.json. Pinapangalanan ng bawat key ang isang workflow; may trigger at mga activity ang bawat value.
{
"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." }
]
}
}
} Tumatakbo ang workflow na ito nang 08:00 tuwing weekday, sa lokal na oras ng bot. Isinasagawa ng empleyado ang activity gamit ang sarili nitong persona, mga skill at koneksyon.
Mga field ng workflow
| Field | Kahulugan |
|---|---|
trigger | Kailangan. Kung kailan tumatakbo ang workflow. Tingnan ang Triggers. |
description | Kung para saan ang workflow. |
activities | Ang mga hakbang. Tingnan ang Activities. |
connections | Mga edge na {from, to, label} na ginagawang graph ang mga activity. Ang __trigger__ ang simula at ang __emit__ ang dulo. |
emit | Mga event na inaanunsyo ng workflow na ito kapag natapos ito: isang listahan, o isang string na pinaghihiwalay ng kuwit. Tingnan ang Events. |
inputs | Mga value na ipinapasa sa bawat run. |
budget | {total_per_run, cost_estimate}. Sa graph run, nililimitahan ng total_per_run ang mga output token; kung hindi, tantiya lang ang dalawa. |
case | Ginagawang isang matagal na case ang workflow bawat tao o bagay. Tingnan ang Cases. |
Valid ang workflow na may trigger pero walang activity. Ang watch na walang activity ay nagpapasa lang ng mga event nito sa ibang workflow.
Paano isinasagawa ang isang run
Kapag walang connections, sunud-sunod na tumatakbo ang mga activity at ginagawa ng empleyado ang bawat isa. Ipinapasa sa susunod ang resulta ng bawat activity. Tinatapos ang run ng activity na walang output.
Kapag may connections, bumubuo ng graph ang mga activity. Sabay-sabay na tumatakbo ang mga branch, at anim na uri ng activity ang tumatakbo nang walang model: condition, loop, wait, http, command at decide. Gumamit ng graph kapag kailangang eksakto ang pag-route.
{
"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"]
} Ano ang natatanggap ng isang run
Laging nasa empleyado ang persona nito at ang mga sagot ng may-ari sa mga tanong sa inputs nito. Natatanggap din ng isang run ang mga value na ito, depende sa trigger nito.
| Input | Naroon kapag |
|---|---|
_event_source, _event_payload, _event_origin | Nag-fire ang isang event trigger. Ang mga payload na 8 KB pataas ay pinaiikli sa mga scalar field nila, at pinapanatili ang mga email header at reference sa attachment. |
_watch_payload | Nag-fire ang isang watch o folder trigger. Isang linya ng output ng watcher, o {files} para sa isang folder. |
inputs | Palagi. Ang sariling mga value ng inputs ng workflow. |
Mga case
May mga trabahong umaabot nang ilang araw: isang lead na kailangang i-follow up, isang request na naghihintay ng mga dokumento. Idagdag ang case at magpapanatili ang workflow ng isang bukas na case bawat tao o bagay sa halip na magsimula ulit sa bawat pagkakataon.
| Field | Kahulugan |
|---|---|
key | Kailangan. Mga dotted path na pinaghihiwalay ng kuwit papunta sa trigger data na tumutukoy sa paksa, gaya ng contactEmail,email,phone. |
type | Ang uri ng case, gaya ng lead. Pinagsasaluhan ng mga workflow na may parehong uri ang mga case. Default ay ang pangalan ng workflow. |
default_wait | Gaano katagal maghihintay kapag walang binanggit na paghihintay ang isang turn: 3d, 12h, 45m. Default ay tatlong araw. |
Bawat turn ng isang case ay dapat magtapos sa isang JSON object at wala nang kasunod. Ang result ang estado ng negosyo; sinasabihan ng next ang engine na mag-wait o mag-close. Ang deadline ay RFC 3339 o isang relative na tagal. Invalid na turn ang anumang iba pa.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Mga limit at pagbawi
- Bawat activity ay puwedeng gumamit ng hanggang 50 model turn, maliban kung iba ang sinasabi ng
params.maxIterations. - Sa isang graph, puwedeng tumakbo ang isang activity nang hanggang 10,000 beses sa isang run.
- Pinahihinto ng spending cap ng may-ari para sa empleyado ang isang run kapag naabot ito. Tantiya lang ang
token_budgetng isang activity. - Ang run na naputol dahil sa restart ay minamarkahang interrupted at itinutuloy nang isang beses.
- Puwedeng tapusin ng empleyado ang run nang mas maaga gamit ang tool na
exit.
Patakbuhin at pamahalaan ang mga workflow
Puwedeng patakbuhin ng may-ari ang kahit anong workflow nang mano-mano. Pinamamahalaan ng mga empleyado ang mga workflow gamit ang run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled at ang iba pang workflow tool na nakalista sa Helpers and Teams.