NeboAI
NeboAI
Začať

Pracovné postupy

Pracovný postup je práca, ktorú zamestnanec robí bez vyzvania: ranné zhrnutie, odpoveď na každú novú správu, týždenný report. Každý pracovný postup spája spúšťač s aktivitami, ktoré zamestnanec vykoná. Pracovné postupy sú uložené v agent.json zamestnanca, takže putujú spolu s rolou.

Prvý pracovný postup

Do agent.json pridajte mapu workflows. Každý kľúč pomenúva pracovný postup; každá hodnota má spúšťač a aktivity.

{
  "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." }
      ]
    }
  }
}

Tento pracovný postup beží v pracovné dni o 08:00 podľa miestneho času bota. Zamestnanec vykoná aktivitu so svojou vlastnou osobnosťou, zručnosťami a pripojeniami.

Polia pracovného postupu

PoleVýznam
triggerPovinné. Kedy pracovný postup beží. Pozrite Spúšťače.
descriptionNa čo pracovný postup slúži.
activitiesKroky. Pozrite Aktivity.
connectionsHrany {from, to, label}, ktoré z aktivít robia graf. __trigger__ je začiatok a __emit__ koniec.
emitUdalosti, ktoré tento pracovný postup oznámi po dokončení: zoznam alebo jeden reťazec oddelený čiarkami. Pozrite Udalosti.
inputsHodnoty odovzdané každému behu.
budget{total_per_run, cost_estimate}. Pri behu grafu total_per_run obmedzuje výstupné tokeny; inak sú obe hodnoty odhady.
caseZmení pracovný postup na jeden dlhodobý prípad pre každú osobu alebo vec. Pozrite Prípady.

Pracovný postup so spúšťačom a bez aktivít je platný. Sledovanie bez aktivít iba preposiela svoje udalosti iným pracovným postupom.

Ako prebieha beh

Bez connections bežia aktivity v poradí a každú z nich vykoná zamestnanec. Výsledok každej aktivity sa odovzdá ďalšej. Aktivita bez výstupu beh ukončí.

S connections tvoria aktivity graf. Vetvy bežia súbežne a šesť typov aktivít beží bez modelu: condition, loop, wait, http, command a decide. Graf použite, keď musí byť smerovanie presné.

{
  "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"]
}

Čo beh dostane

Zamestnanec má vždy svoju osobnosť a odpovede vlastníka na otázky v inputs. Beh dostane aj tieto hodnoty, podľa toho, aký má spúšťač.

VstupK dispozícii, keď
_event_source, _event_payload, _event_originSpustil sa spúšťač event. Obsah s veľkosťou 8 KB a viac sa skráti na skalárne polia, pričom hlavičky e-mailov a odkazy na prílohy sa zachovajú.
_watch_payloadSpustil sa spúšťač watch alebo folder. Jeden riadok výstupu sledovača alebo {files} pri priečinku.
inputsVždy. Vlastné hodnoty inputs pracovného postupu.

Prípady

Niektorá práca trvá dni: potenciálny zákazník, ktorý potrebuje opakované kontaktovanie, žiadosť čakajúca na dokumenty. Pridajte case a pracovný postup bude namiesto zakaždým nového začiatku udržiavať jeden otvorený prípad pre každú osobu alebo vec.

PoleVýznam
keyPovinné. Cesty s bodkami do údajov spúšťača, oddelené čiarkami, ktoré identifikujú subjekt, napríklad contactEmail,email,phone.
typeDruh prípadu, napríklad lead. Pracovné postupy s rovnakým typom zdieľajú prípady. Predvolene názov pracovného postupu.
default_waitAko dlho čakať, keď ťah neurčí čakanie: 3d, 12h, 45m. Predvolene tri dni.

Každý ťah prípadu musí skončiť jedným objektom JSON a nič za ním nesmie nasledovať. result je obchodný stav; next hovorí jadru, či má wait alebo close. Termín je vo formáte RFC 3339 alebo ako relatívny úsek. Čokoľvek iné je neplatný ťah.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Obmedzenia a obnova

  • Každá aktivita môže použiť najviac 50 ťahov modelu, pokiaľ params.maxIterations neurčuje inak.
  • V grafe sa jedna aktivita môže v jednom behu spustiť najviac 10 000-krát.
  • Limit výdavkov, ktorý vlastník pre zamestnanca nastavil, beh po dosiahnutí zastaví. token_budget aktivity je odhad.
  • Beh prerušený reštartom sa označí ako prerušený a raz sa obnoví.
  • Zamestnanec môže beh ukončiť skôr nástrojom exit.

Spúšťanie a správa pracovných postupov

Vlastník môže ktorýkoľvek pracovný postup spustiť ručne. Zamestnanci spravujú pracovné postupy pomocou run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled a ďalších nástrojov pracovných postupov uvedených na stránke Pomocníci a tímy.