NeboAI
NeboAI
Začít

Pracovní postupy

Pracovní postup je práce, kterou zaměstnanec dělá, aniž by o to někdo požádal: ranní souhrn, odpověď na každou novou zprávu, týdenní zpráva. Každý pracovní postup spojuje spouštěč s činnostmi, které zaměstnanec provádí. Pracovní postupy jsou uložené v souboru agent.json zaměstnance, takže putují spolu s rolí.

První pracovní postup

Přidejte do agent.json mapu workflows. Každý klíč pojmenovává pracovní postup; každá hodnota má spouštěč a činnosti.

{
  "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 běží ve všední dny v 08:00 podle místního času bota. Zaměstnanec činnost provede se svou vlastní personou, dovednostmi a připojeními.

Pole pracovního postupu

PoleVýznam
triggerPovinné. Kdy pracovní postup běží. Viz Spouštěče.
descriptionK čemu pracovní postup slouží.
activitiesKroky. Viz Činnosti.
connectionsHrany {from, to, label}, které z činností vytvoří graf. __trigger__ je začátek a __emit__ konec.
emitUdálosti, které tento pracovní postup po dokončení ohlásí: seznam nebo jeden řetězec oddělený čárkami. Viz Události.
inputsHodnoty předávané každému běhu.
budget{total_per_run, cost_estimate}. V běhu grafu total_per_run omezuje výstupní tokeny; jinak jsou obě hodnoty jen odhady.
caseUdělá z pracovního postupu jeden dlouhodobý případ pro každou osobu nebo věc. Viz Případy.

Pracovní postup se spouštěčem a bez činností je platný. Sledování bez činností jen předává své události dalším pracovním postupům.

Jak běh probíhá

Bez connections běží činnosti postupně a každou z nich provádí zaměstnanec. Výsledek každé činnosti se předá další. Činnost bez výstupu běh ukončí.

S connections tvoří činnosti graf. Větve běží paralelně a šest typů činností běží bez modelu: condition, loop, wait, http, command a decide. Graf použijte, když musí být směrování přesné.

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

Co běh dostává

Zaměstnanec má vždy svou personu a odpovědi vlastníka na své otázky inputs. Běh navíc podle svého spouštěče dostává tyto hodnoty.

VstupKdy je k dispozici
_event_source, _event_payload, _event_originSpustil se spouštěč event. Datové části o velikosti 8 KB a více se zkrátí na skalární pole, přičemž hlavičky e-mailů a odkazy na přílohy zůstanou zachovány.
_watch_payloadSpustil se spouštěč watch nebo folder. Jeden řádek výstupu sledovače, nebo {files} u složky.
inputsVždy. Vlastní hodnoty inputs pracovního postupu.

Případy

Některá práce trvá dny: potenciální zákazník, který potřebuje navazující kontakt, žádost čekající na dokumenty. Přidejte case a pracovní postup bude pro každou osobu nebo věc udržovat jeden otevřený případ, místo aby pokaždé začínal od nuly.

PoleVýznam
keyPovinné. Tečkové cesty do dat spouštěče oddělené čárkami, které identifikují subjekt, například contactEmail,email,phone.
typeDruh případu, například lead. Pracovní postupy se stejným typem sdílejí případy. Výchozí hodnota je název pracovního postupu.
default_waitJak dlouho čekat, když tah neuvádí žádné čekání: 3d, 12h, 45m. Výchozí hodnota jsou tři dny.

Každý tah případu musí skončit jedním objektem JSON a za ním už nic. result je obchodní stav; next říká stroji, zda má wait, nebo close. Termín je ve formátu RFC 3339 nebo jako relativní doba. Cokoli jiného je neplatný tah.

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

Limity a obnovení

  • Každá činnost může zabrat až 50 tahů modelu, pokud params.maxIterations neurčuje jinak.
  • V grafu může jedna činnost během jednoho běhu proběhnout nejvýše 10 000krát.
  • Limit útraty, který vlastník zaměstnanci nastavil, běh po dosažení zastaví. token_budget činnosti je jen odhad.
  • Běh přerušený restartem se označí jako přerušený a jednou se obnoví.
  • Zaměstnanec může běh ukončit předčasně nástrojem exit.

Spouštění a správa pracovních postupů

Vlastník může libovolný pracovní postup spustit ručně. Zaměstnanci spravují pracovní postupy pomocí run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled a dalších nástrojů pro pracovní postupy uvedených na stránce Pomocníci a týmy.