Ensimmäinen työnkulku
Lisää workflows-kartta tiedostoon agent.json. Jokainen avain nimeää työnkulun; jokaisella arvolla on laukaisin ja toiminnot.
{
"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." }
]
}
}
} Tämä työnkulku suoritetaan arkipäivisin klo 08:00 botin paikallista aikaa. Työntekijä suorittaa toiminnon omalla persoonallaan, taidoillaan ja yhteyksillään.
Työnkulun kentät
| Kenttä | Merkitys |
|---|---|
trigger | Pakollinen. Milloin työnkulku suoritetaan. Katso Laukaisimet. |
description | Mitä varten työnkulku on. |
activities | Vaiheet. Katso Toiminnot. |
connections | Reunat {from, to, label}, jotka tekevät toiminnoista graafin. __trigger__ on alku ja __emit__ loppu. |
emit | Tapahtumat, jotka tämä työnkulku ilmoittaa valmistuessaan: lista tai yksi pilkuin eroteltu merkkijono. Katso Tapahtumat. |
inputs | Arvot, jotka välitetään jokaiselle suoritukselle. |
budget | {total_per_run, cost_estimate}. Graafisuorituksessa total_per_run rajoittaa tulostetokeneita; muuten molemmat ovat arvioita. |
case | Tekee työnkulusta yhden pitkäkestoisen tapauksen henkilöä tai asiaa kohden. Katso Tapaukset. |
Työnkulku, jolla on laukaisin mutta ei toimintoja, on kelvollinen. Tarkkailu ilman toimintoja vain välittää tapahtumansa muille työnkuluille.
Miten suoritus etenee
Ilman connections-kenttää toiminnot suoritetaan järjestyksessä, ja työntekijä tekee jokaisen. Kunkin toiminnon tulos välitetään seuraavalle. Toiminto, jolla ei ole tulostetta, päättää suorituksen.
connections-kentän kanssa toiminnot muodostavat graafin. Haarat suoritetaan rinnakkain, ja kuusi toimintotyyppiä toimii ilman mallia: condition, loop, wait, http, command ja decide. Käytä graafia, kun reitityksen on oltava tarkka.
{
"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"]
} Mitä suoritus saa
Työntekijällä on aina persoonansa ja omistajan vastaukset sen inputs-kysymyksiin. Suoritus saa lisäksi nämä arvot laukaisimesta riippuen.
| Syöte | Mukana, kun |
|---|---|
_event_source, _event_payload, _event_origin | Tapahtumalaukaisin laukesi. Vähintään 8 kt:n hyötykuormat lyhennetään skalaarikenttiinsä, ja sähköpostin otsakkeet ja liiteviittaukset säilytetään. |
_watch_payload | Tarkkailu- tai kansiolaukaisin laukesi. Yksi rivi tarkkailijan tulostetta tai kansiolle {files}. |
inputs | Aina. Työnkulun omat inputs-arvot. |
Tapaukset
Osa työstä kestää päiviä: liidi, joka vaatii seurantaa, pyyntö, joka odottaa asiakirjoja. Lisää case, niin työnkulku pitää yhden avoimen tapauksen henkilöä tai asiaa kohden sen sijaan, että aloittaisi joka kerta alusta.
| Kenttä | Merkitys |
|---|---|
key | Pakollinen. Pilkuin erotellut pisteelliset polut laukaisimen tietoihin, jotka tunnistavat kohteen, esimerkiksi contactEmail,email,phone. |
type | Tapauksen laji, esimerkiksi lead. Saman tyypin työnkulut jakavat tapaukset. Oletuksena työnkulun nimi. |
default_wait | Kuinka kauan odotetaan, kun vuoro ei nimeä odotusta: 3d, 12h, 45m. Oletus kolme päivää. |
Tapauksen jokaisen vuoron on päätyttävä yhteen JSON-objektiin, eikä sen jälkeen saa tulla mitään. result on liiketoiminnan tila; next käskee moottoria tekemään wait tai close. Määräaika on RFC 3339 -muodossa tai suhteellinen aikaväli. Kaikki muu on virheellinen vuoro.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Rajat ja palautuminen
- Kukin toiminto voi käyttää enintään 50 mallin vuoroa, ellei
params.maxIterationsmäärää toisin. - Graafissa yksi toiminto voi suorittua enintään 10 000 kertaa suoritusta kohden.
- Omistajan työntekijälle asettama kulukatto pysäyttää suorituksen, kun se saavutetaan. Toiminnon
token_budgeton arvio. - Uudelleenkäynnistyksen keskeyttämä suoritus merkitään keskeytyneeksi ja jatketaan kerran.
- Työntekijä voi päättää suorituksen aikaisin
exit-työkalulla.
Suorita ja hallitse työnkulkuja
Omistaja voi suorittaa minkä tahansa työnkulun käsin. Työntekijät hallitsevat työnkulkuja työkaluilla run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled ja muilla työnkulkutyökaluilla, jotka on lueteltu sivulla Avustajat ja tiimit.