En første arbejdsgang
Tilføj et workflows-kort til agent.json. Hver nøgle navngiver en arbejdsgang; hver værdi har en udlø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 arbejdsgang kører kl. 08:00 på hverdage i bottens lokale tid. Medarbejderen udfører aktiviteten med sin egen persona, sine færdigheder og forbindelser.
Felter i arbejdsgange
| Felt | Betydning |
|---|---|
trigger | Påkrævet. Hvornår arbejdsgangen kører. Se Udløsere. |
description | Hvad arbejdsgangen er til. |
activities | Trinnene. Se Aktiviteter. |
connections | Kanter {from, to, label}, der gør aktiviteterne til en graf. __trigger__ er starten og __emit__ slutningen. |
emit | Hændelser, som denne arbejdsgang annoncerer, når den er færdig: en liste eller én kommaadskilt streng. Se Hændelser. |
inputs | Værdier, der sendes til hver kørsel. |
budget | {total_per_run, cost_estimate}. I en grafkørsel sætter total_per_run loft over outputtokens; ellers er begge skøn. |
case | Gør arbejdsgangen til én langvarig sag pr. person eller ting. Se Sager. |
En arbejdsgang med en udløser og ingen aktiviteter er gyldig. En watch uden aktiviteter videresender kun sine hændelser til andre arbejdsgange.
Sådan afvikles en kørsel
Uden connections kører aktiviteterne i rækkefølge, og medarbejderen udfører hver enkelt. Hver aktivitets resultat sendes videre til den næste. En aktivitet uden output afslutter kørslen.
Med connections danner aktiviteterne en graf. Grene kører parallelt, og seks aktivitetstyper kører uden modellen: condition, loop, wait, http, command og decide. Brug en graf, når dirigeringen skal være præcis.
{
"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"]
} Hvad en kørsel modtager
Medarbejderen har altid sin persona og ejerens svar på sine inputs-spørgsmål. En kørsel modtager også disse værdier, afhængigt af dens udløser.
| Input | Til stede, når |
|---|---|
_event_source, _event_payload, _event_origin | En hændelsesudløser blev udløst. Indhold på 8 KB eller mere forkortes til de skalare felter, mens e-mailheadere og henvisninger til vedhæftede filer bevares. |
_watch_payload | En watch- eller mappeudløser blev udløst. Én linje af overvågerens output eller {files} for en mappe. |
inputs | Altid. Arbejdsgangens egne inputs-værdier. |
Sager
Noget arbejde strækker sig over dage: et lead, der kræver opfølgning, en anmodning, der venter på dokumenter. Tilføj case, så holder arbejdsgangen én åben sag pr. person eller ting i stedet for at starte forfra hver gang.
| Felt | Betydning |
|---|---|
key | Påkrævet. Kommaadskilte punktumstier ind i udløserdataene, der identificerer emnet, f.eks. contactEmail,email,phone. |
type | Sagstypen, f.eks. lead. Arbejdsgange med samme type deler sager. Er som standard arbejdsgangens navn. |
default_wait | Hvor længe der ventes, når en tur ikke angiver nogen ventetid: 3d, 12h, 45m. Standard tre dage. |
Hver tur i en sag skal slutte med ét JSON-objekt og intet efter det. result er forretningstilstanden; next fortæller motoren, at den skal wait eller close. En frist er RFC 3339 eller et relativt tidsrum. Alt andet er en ugyldig tur.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Grænser og gendannelse
- Hver aktivitet kan bruge op til 50 modelture, medmindre
params.maxIterationssiger noget andet. - I en graf kan én aktivitet højst køre 10.000 gange i en kørsel.
- Ejerens udgiftsloft for medarbejderen stopper en kørsel, når det nås. En aktivitets
token_budgeter et skøn. - En kørsel, der afbrydes af en genstart, markeres som afbrudt og genoptages én gang.
- Medarbejderen kan afslutte en kørsel tidligt med værktøjet
exit.
Kør og administrer arbejdsgange
Ejeren kan køre enhver arbejdsgang manuelt. Medarbejdere administrerer arbejdsgange med run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled og de andre arbejdsgangsværktøjer, der står på Hjælpere og teams.