NeboAI
NeboAI
Kom i gang

Workflows

En arbejdsgang er arbejde, en medarbejder udfører uden at blive bedt om det: et morgenresumé, et svar på hver ny besked, en ugerapport. Hver arbejdsgang parrer en udløser med de aktiviteter, medarbejderen udfører. Arbejdsgange ligger i medarbejderens agent.json, så de følger med rollen.

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

FeltBetydning
triggerPåkrævet. Hvornår arbejdsgangen kører. Se Udløsere.
descriptionHvad arbejdsgangen er til.
activitiesTrinnene. Se Aktiviteter.
connectionsKanter {from, to, label}, der gør aktiviteterne til en graf. __trigger__ er starten og __emit__ slutningen.
emitHændelser, som denne arbejdsgang annoncerer, når den er færdig: en liste eller én kommaadskilt streng. Se Hændelser.
inputsVæ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.
caseGø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.

InputTil stede, når
_event_source, _event_payload, _event_originEn 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_payloadEn watch- eller mappeudløser blev udløst. Én linje af overvågerens output eller {files} for en mappe.
inputsAltid. 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.

FeltBetydning
keyPåkrævet. Kommaadskilte punktumstier ind i udløserdataene, der identificerer emnet, f.eks. contactEmail,email,phone.
typeSagstypen, f.eks. lead. Arbejdsgange med samme type deler sager. Er som standard arbejdsgangens navn.
default_waitHvor 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.maxIterations siger 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_budget er 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.