En første arbeidsflyt
Legg til et workflows-kart i agent.json. Hver nøkkel navngir en arbeidsflyt; hver verdi har en utløser og aktiviteter.
{
"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." }
]
}
}
} Denne arbeidsflyten kjører kl. 08:00 på hverdager, i botens lokale tid. Den ansatte utfører aktiviteten med sin egen persona, sine ferdigheter og tilkoblinger.
Felt for arbeidsflyter
| Felt | Betydning |
|---|---|
trigger | Obligatorisk. Når arbeidsflyten kjører. Se Utløsere. |
description | Hva arbeidsflyten er til for. |
activities | Trinnene. Se Aktiviteter. |
connections | Kanter {from, to, label} som gjør aktivitetene til en graf. __trigger__ er starten og __emit__ slutten. |
emit | Hendelser denne arbeidsflyten kunngjør når den er ferdig: en liste, eller én kommaseparert streng. Se Hendelser. |
inputs | Verdier som sendes til hver kjøring. |
budget | {total_per_run, cost_estimate}. I en grafkjøring begrenser total_per_run utdatatokener; ellers er begge anslag. |
case | Gjør arbeidsflyten til én langvarig sak per person eller ting. Se Saker. |
En arbeidsflyt med en utløser og ingen aktiviteter er gyldig. En overvåking uten aktiviteter videresender bare hendelsene sine til andre arbeidsflyter.
Slik utføres en kjøring
Uten connections kjører aktivitetene i rekkefølge, og den ansatte utfører hver av dem. Resultatet av hver aktivitet sendes videre til den neste. En aktivitet uten utdata avslutter kjøringen.
Med connections danner aktivitetene en graf. Grener kjører parallelt, og seks aktivitetstyper kjører uten modellen: condition, loop, wait, http, command og decide. Bruk en graf når rutingen må være eksakt.
{
"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"]
} Hva en kjøring mottar
Den ansatte har alltid sin persona og eierens svar på inputs-spørsmålene sine. En kjøring mottar også disse verdiene, avhengig av utløseren.
| Inndata | Finnes når |
|---|---|
_event_source, _event_payload, _event_origin | En hendelsesutløser ble utløst. Nyttelaster på 8 KB eller mer forkortes til de skalare feltene, der e-posthoder og vedleggsreferanser beholdes. |
_watch_payload | En overvåkings- eller mappeutløser ble utløst. Én linje av overvåkerens utdata, eller {files} for en mappe. |
inputs | Alltid. Arbeidsflytens egne inputs-verdier. |
Saker
Noe arbeid strekker seg over flere dager: et potensielt kundeemne som trenger oppfølging, en forespørsel som venter på dokumenter. Legg til case, så holder arbeidsflyten én åpen sak per person eller ting i stedet for å starte på nytt hver gang.
| Felt | Betydning |
|---|---|
key | Obligatorisk. Kommaseparerte punktstier inn i utløserdataene som identifiserer emnet, for eksempel contactEmail,email,phone. |
type | Typen sak, for eksempel lead. Arbeidsflyter med samme type deler saker. Standard er navnet på arbeidsflyten. |
default_wait | Hvor lenge det skal ventes når en tur ikke oppgir noen ventetid: 3d, 12h, 45m. Standard tre dager. |
Hver tur i en sak må avsluttes med ett JSON-objekt og ingenting etter det. result er forretningstilstanden; next ber motoren om å wait eller close. En frist er RFC 3339 eller et relativt tidsrom. Alt annet er en ugyldig tur.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Grenser og gjenoppretting
- Hver aktivitet kan bruke opptil 50 modellturer, med mindre
params.maxIterationssier noe annet. - I en graf kan én aktivitet kjøre maks 10 000 ganger i en kjøring.
- Eierens utgiftstak for den ansatte stopper en kjøring når det er nådd. En aktivitets
token_budgeter et anslag. - En kjøring som avbrytes av en omstart, merkes som avbrutt og gjenopptas én gang.
- Den ansatte kan avslutte en kjøring tidlig med verktøyet
exit.
Kjør og administrer arbeidsflyter
Eieren kan kjøre hvilken som helst arbeidsflyt manuelt. Ansatte administrerer arbeidsflyter med run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled og de andre arbeidsflytverktøyene som står på Hjelpere og team.