NeboAI
NeboAI
Kom igång

Arbetsflöden

Ett arbetsflöde är arbete som en medarbetare gör utan att någon ber om det: en morgonsammanfattning, ett svar på varje nytt meddelande, en veckorapport. Varje arbetsflöde kopplar en utlösare till de aktiviteter som medarbetaren utför. Arbetsflöden finns i medarbetarens agent.json, så de följer med rollen.

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ältBetydelse
triggerObligatoriskt. När arbetsflödet körs. Se Utlösare.
descriptionVad arbetsflödet är till för.
activitiesStegen. Se Aktiviteter.
connectionsKanter {from, to, label} som gör aktiviteterna till en graf. __trigger__ är starten och __emit__ slutet.
emitHändelser som det här arbetsflödet meddelar när det är klart: en lista eller en kommaseparerad sträng. Se Händelser.
inputsVä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.
caseGö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.

IndataFinns när
_event_source, _event_payload, _event_originEn 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_payloadEn bevaknings- eller mapputlösare har utlösts. En rad av bevakarens utdata, eller {files} för en mapp.
inputsAlltid. 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ältBetydelse
keyObligatoriskt. Kommaseparerade punktnotationssökvägar i utlösardata som identifierar ämnet, till exempel contactEmail,email,phone.
typeTypen av ärende, till exempel lead. Arbetsflöden med samma typ delar ärenden. Standard är arbetsflödets namn.
default_waitHur 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.maxIterations sä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.