NeboAI
NeboAI
Kom i gang

Arbeidsflyter

En arbeidsflyt er arbeid en ansatt gjør uten å bli bedt om det: et morgensammendrag, et svar på hver ny melding, en ukentlig rapport. Hver arbeidsflyt kobler en utløser med aktivitetene den ansatte utfører. Arbeidsflyter ligger i den ansattes agent.json, så de følger med rollen.

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

FeltBetydning
triggerObligatorisk. Når arbeidsflyten kjører. Se Utløsere.
descriptionHva arbeidsflyten er til for.
activitiesTrinnene. Se Aktiviteter.
connectionsKanter {from, to, label} som gjør aktivitetene til en graf. __trigger__ er starten og __emit__ slutten.
emitHendelser denne arbeidsflyten kunngjør når den er ferdig: en liste, eller én kommaseparert streng. Se Hendelser.
inputsVerdier 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.
caseGjø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.

InndataFinnes når
_event_source, _event_payload, _event_originEn hendelsesutløser ble utløst. Nyttelaster på 8 KB eller mer forkortes til de skalare feltene, der e-posthoder og vedleggsreferanser beholdes.
_watch_payloadEn overvåkings- eller mappeutløser ble utløst. Én linje av overvåkerens utdata, eller {files} for en mappe.
inputsAlltid. 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.

FeltBetydning
keyObligatorisk. Kommaseparerte punktstier inn i utløserdataene som identifiserer emnet, for eksempel contactEmail,email,phone.
typeTypen sak, for eksempel lead. Arbeidsflyter med samme type deler saker. Standard er navnet på arbeidsflyten.
default_waitHvor 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.maxIterations sier 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_budget er 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.