Een eerste workflow
Voeg een workflows-map toe aan agent.json. Elke sleutel is de naam van een workflow; elke waarde heeft een trigger en activiteiten.
{
"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." }
]
}
}
} Deze workflow draait op werkdagen om 08:00, in de lokale tijd van de bot. De medewerker voert de activiteit uit met zijn eigen persona, skills en verbindingen.
Workflowvelden
| Veld | Betekenis |
|---|---|
trigger | Verplicht. Wanneer de workflow draait. Zie Triggers. |
description | Waarvoor de workflow dient. |
activities | De stappen. Zie Activiteiten. |
connections | Verbindingen {from, to, label} die van de activiteiten een graaf maken. __trigger__ is het begin en __emit__ het einde. |
emit | Events die deze workflow aankondigt wanneer hij klaar is: een lijst, of één string gescheiden door komma's. Zie Events. |
inputs | Waarden die aan elke uitvoering worden meegegeven. |
budget | {total_per_run, cost_estimate}. In een graafuitvoering begrenst total_per_run de uitvoertokens; anders zijn beide schattingen. |
case | Maakt van de workflow één langlopende case per persoon of ding. Zie Cases. |
Een workflow met een trigger en zonder activiteiten is geldig. Een watch zonder activiteiten geeft zijn events alleen door aan andere workflows.
Zo verloopt een uitvoering
Zonder connections draaien activiteiten op volgorde en voert de medewerker ze een voor een uit. Het resultaat van elke activiteit gaat naar de volgende. Een activiteit zonder uitvoer beëindigt de uitvoering.
Met connections vormen de activiteiten een graaf. Takken draaien parallel, en zes activiteitstypen draaien zonder het model: condition, loop, wait, http, command en decide. Gebruik een graaf als de routering exact moet zijn.
{
"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"]
} Wat een uitvoering ontvangt
De medewerker heeft altijd zijn persona en de antwoorden van de eigenaar op zijn inputs-vragen. Een uitvoering ontvangt ook deze waarden, afhankelijk van de trigger.
| Invoer | Aanwezig wanneer |
|---|---|
_event_source, _event_payload, _event_origin | Een eventtrigger is afgegaan. Payloads van 8 KB of meer worden ingekort tot hun scalaire velden, waarbij e-mailheaders en verwijzingen naar bijlagen behouden blijven. |
_watch_payload | Een watch- of maptrigger is afgegaan. Eén regel van de uitvoer van de watcher, of {files} voor een map. |
inputs | Altijd. De eigen inputs-waarden van de workflow. |
Cases
Sommig werk beslaat dagen: een lead die opvolging nodig heeft, een verzoek dat op documenten wacht. Voeg case toe, en de workflow houdt één open case per persoon of ding bij in plaats van elke keer opnieuw te beginnen.
| Veld | Betekenis |
|---|---|
key | Verplicht. Door komma's gescheiden paden met punten in de triggergegevens die het onderwerp identificeren, zoals contactEmail,email,phone. |
type | Het soort case, zoals lead. Workflows met hetzelfde type delen cases. Standaard de naam van de workflow. |
default_wait | Hoe lang er gewacht wordt als een beurt geen wachttijd noemt: 3d, 12h, 45m. Standaard drie dagen. |
Elke beurt van een case moet eindigen met één JSON-object en niets daarna. result is de bedrijfsstatus; next vertelt de engine te wait of te close. Een deadline is RFC 3339 of een relatieve tijdsduur. Al het andere is een ongeldige beurt.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Limieten en herstel
- Elke activiteit kan tot 50 modelbeurten duren, tenzij
params.maxIterationsiets anders zegt. - In een graaf kan één activiteit maximaal 10.000 keer draaien per uitvoering.
- Het uitgavenplafond dat de eigenaar voor de medewerker heeft ingesteld, stopt een uitvoering wanneer het is bereikt. Het
token_budgetvan een activiteit is een schatting. - Een uitvoering die door een herstart is onderbroken, wordt als onderbroken gemarkeerd en één keer hervat.
- De medewerker kan een uitvoering vroegtijdig beëindigen met de tool
exit.
Workflows uitvoeren en beheren
De eigenaar kan elke workflow handmatig uitvoeren. Medewerkers beheren workflows met run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled en de andere workflowtools die worden genoemd op Helpers en teams.