NeboAI
NeboAI
Aloita

Työnkulut

Työnkulku on työ, jonka työntekijä tekee pyytämättä: aamukooste, vastaus jokaiseen uuteen viestiin, viikkoraportti. Jokainen työnkulku yhdistää laukaisimen ja toiminnot, jotka työntekijä suorittaa. Työnkulut ovat työntekijän agent.json-tiedostossa, joten ne kulkevat roolin mukana.

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
triggerPakollinen. Milloin työnkulku suoritetaan. Katso Laukaisimet.
descriptionMitä varten työnkulku on.
activitiesVaiheet. Katso Toiminnot.
connectionsReunat {from, to, label}, jotka tekevät toiminnoista graafin. __trigger__ on alku ja __emit__ loppu.
emitTapahtumat, jotka tämä työnkulku ilmoittaa valmistuessaan: lista tai yksi pilkuin eroteltu merkkijono. Katso Tapahtumat.
inputsArvot, jotka välitetään jokaiselle suoritukselle.
budget{total_per_run, cost_estimate}. Graafisuorituksessa total_per_run rajoittaa tulostetokeneita; muuten molemmat ovat arvioita.
caseTekee 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öteMukana, kun
_event_source, _event_payload, _event_originTapahtumalaukaisin laukesi. Vähintään 8 kt:n hyötykuormat lyhennetään skalaarikenttiinsä, ja sähköpostin otsakkeet ja liiteviittaukset säilytetään.
_watch_payloadTarkkailu- tai kansiolaukaisin laukesi. Yksi rivi tarkkailijan tulostetta tai kansiolle {files}.
inputsAina. 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
keyPakollinen. Pilkuin erotellut pisteelliset polut laukaisimen tietoihin, jotka tunnistavat kohteen, esimerkiksi contactEmail,email,phone.
typeTapauksen laji, esimerkiksi lead. Saman tyypin työnkulut jakavat tapaukset. Oletuksena työnkulun nimi.
default_waitKuinka 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.maxIterations mää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_budget on 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.