Ett första arbetsflöde
Lägg till en workflows-mappning i agent.json. Varje nyckel namnger ett arbetsflöde; varje värde har en utlösare och 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." }
]
}
}
} Det här arbetsflödet körs kl. 08:00 på vardagar, i botens lokala tid. Medarbetaren utför aktiviteten med sin egen persona, sina färdigheter och anslutningar.
Fält för arbetsflöden
| Fält | Betydelse |
|---|---|
trigger | Obligatoriskt. När arbetsflödet körs. Se Utlösare. |
description | Vad arbetsflödet är till för. |
activities | Stegen. Se Aktiviteter. |
connections | Kanter {from, to, label} som gör aktiviteterna till en graf. __trigger__ är starten och __emit__ slutet. |
emit | Händelser som det här arbetsflödet meddelar när det är klart: en lista eller en kommaseparerad sträng. Se Händelser. |
inputs | Värden som skickas till varje körning. |
budget | {total_per_run, cost_estimate}. I en grafkörning begränsar total_per_run antalet utdatatoken; annars är båda uppskattningar. |
case | Gör arbetsflödet till ett långvarigt ärende per person eller sak. Se Ärenden. |
Ett arbetsflöde med en utlösare och inga aktiviteter är giltigt. En bevakning utan aktiviteter vidarebefordrar bara sina händelser till andra arbetsflöden.
Hur en körning genomförs
Utan connections körs aktiviteterna i ordning och medarbetaren utför var och en. Varje aktivitets resultat skickas vidare till nästa. En aktivitet utan utdata avslutar körningen.
Med connections bildar aktiviteterna en graf. Grenar körs parallellt, och sex aktivitetstyper körs utan modellen: condition, loop, wait, http, command och decide. Använd en graf när dirigeringen måste vara exakt.
{
"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"]
} Vad en körning får
Medarbetaren har alltid sin persona och ägarens svar på sina inputs-frågor. En körning får också de här värdena, beroende på dess utlösare.
| Indata | Finns när |
|---|---|
_event_source, _event_payload, _event_origin | En händelseutlösare har utlösts. Nyttolaster på 8 KB eller mer kortas till sina skalära fält, med e-posthuvuden och hänvisningar till bilagor kvar. |
_watch_payload | En bevaknings- eller mapputlösare har utlösts. En rad av bevakarens utdata, eller {files} för en mapp. |
inputs | Alltid. Arbetsflödets egna inputs-värden. |
Ärenden
En del arbete sträcker sig över flera dagar: en lead som behöver uppföljning, en förfrågan som väntar på dokument. Lägg till case så håller arbetsflödet ett öppet ärende per person eller sak i stället för att börja om från början varje gång.
| Fält | Betydelse |
|---|---|
key | Obligatoriskt. Kommaseparerade punktnotationssökvägar i utlösardata som identifierar ämnet, till exempel contactEmail,email,phone. |
type | Typen av ärende, till exempel lead. Arbetsflöden med samma typ delar ärenden. Standard är arbetsflödets namn. |
default_wait | Hur länge det ska väntas när en tur inte anger någon väntetid: 3d, 12h, 45m. Standard tre dagar. |
Varje tur i ett ärende måste sluta med ett JSON-objekt och ingenting efter det. result är affärsläget; next säger åt motorn att wait eller close. En tidsfrist är RFC 3339 eller ett relativt tidsspann. Allt annat är en ogiltig tur.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Gränser och återhämtning
- Varje aktivitet kan ta upp till 50 modellturer, om inte
params.maxIterationssäger något annat. - I en graf kan en aktivitet köras högst 10 000 gånger per körning.
- Ägarens utgiftstak för medarbetaren stoppar en körning när det nås. En aktivitets
token_budgetär en uppskattning. - En körning som avbryts av en omstart markeras som avbruten och återupptas en gång.
- Medarbetaren kan avsluta en körning i förtid med verktyget
exit.
Kör och hantera arbetsflöden
Ägaren kan köra vilket arbetsflöde som helst manuellt. Medarbetare hanterar arbetsflöden med run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled och de andra arbetsflödesverktygen som listas under Hjälpare och team.