NeboAI
NeboAI
Kezdés

Munkafolyamatok

A munkafolyamat olyan munka, amelyet egy munkatárs kérés nélkül végez: reggeli összefoglaló, válasz minden új üzenetre, heti jelentés. Minden munkafolyamat egy indítót párosít azokkal a tevékenységekkel, amelyeket a munkatárs elvégez. A munkafolyamatok a munkatárs agent.json fájljában élnek, így a szereppel együtt utaznak.

Az első munkafolyamat

Adjon hozzá egy workflows leképezést az agent.json fájlhoz. Minden kulcs egy munkafolyamatot nevez meg; minden érték egy indítót és tevékenységeket tartalmaz.

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

Ez a munkafolyamat hétköznapokon 08:00-kor fut, a bot helyi ideje szerint. A munkatárs a saját személyiségével, készségeivel és kapcsolataival végzi el a tevékenységet.

Munkafolyamat-mezők

MezőJelentés
triggerKötelező. Mikor fut a munkafolyamat. Lásd: Indítók.
descriptionMire szolgál a munkafolyamat.
activitiesA lépések. Lásd: Tevékenységek.
connections{from, to, label} élek, amelyek gráffá teszik a tevékenységeket. A __trigger__ a kezdet, az __emit__ a vég.
emitEsemények, amelyeket ez a munkafolyamat a befejezésekor bejelent: lista vagy egy vesszővel elválasztott karakterlánc. Lásd: Események.
inputsMinden futásnak átadott értékek.
budget{total_per_run, cost_estimate}. Gráfos futásban a total_per_run korlátozza a kimeneti tokeneket; egyébként mindkettő becslés.
caseA munkafolyamatot személyenként vagy dolgonként egy hosszan futó üggyé teszi. Lásd: Ügyek.

Az indítóval rendelkező, de tevékenységek nélküli munkafolyamat érvényes. A tevékenységek nélküli figyelés csak továbbítja az eseményeit más munkafolyamatoknak.

Hogyan fut le egy futás

connections nélkül a tevékenységek sorban futnak, és mindegyiket a munkatárs végzi el. Minden tevékenység eredménye a következőhöz kerül. Egy kimenet nélküli tevékenység befejezi a futást.

connections megadásával a tevékenységek gráfot alkotnak. Az ágak párhuzamosan futnak, és hat tevékenységtípus a modell nélkül fut: condition, loop, wait, http, command és decide. Használjon gráfot, ha az irányításnak pontosnak kell lennie.

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

Mit kap egy futás

A munkatárs mindig rendelkezik a saját személyiségével és a tulajdonos válaszaival az inputs kérdéseire. Egy futás az indítójától függően ezeket az értékeket is megkapja.

BemenetMikor van jelen
_event_source, _event_payload, _event_originEgy eseményindító aktiválódott. A 8 KB-os vagy nagyobb adattartalmak a skaláris mezőikre rövidülnek, az e-mail-fejlécek és a mellékletekre mutató hivatkozások megmaradnak.
_watch_payloadEgy figyelő vagy mappaindító aktiválódott. A figyelő kimenetének egy sora, illetve mappánál {files}.
inputsMindig. A munkafolyamat saját inputs értékei.

Ügyek

Egyes munkák napokig tartanak: egy érdeklődő, akit utána kell követni, egy dokumentumokra váró kérés. Adja hozzá a case mezőt, és a munkafolyamat személyenként vagy dolgonként egy nyitott ügyet tart fenn ahelyett, hogy minden alkalommal elölről kezdené.

MezőJelentés
keyKötelező. Vesszővel elválasztott, pontokkal tagolt útvonalak az indító adataiban, amelyek azonosítják az alanyt, például contactEmail,email,phone.
typeAz ügy fajtája, például lead. Az azonos típusú munkafolyamatok közösen használják az ügyeket. Alapértéke a munkafolyamat neve.
default_waitMennyi ideig várjon, ha egy kör nem ad meg várakozást: 3d, 12h, 45m. Alapérték három nap.

Egy ügy minden körének egyetlen JSON-objektummal kell végződnie, utána semmivel. A result az üzleti állapot; a next megmondja a motornak, hogy wait vagy close. A határidő RFC 3339 formátumú vagy relatív időtartam. Minden más érvénytelen kör.

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

Korlátok és helyreállítás

  • Minden tevékenység legfeljebb 50 modellkört használhat, hacsak a params.maxIterations mást nem ír elő.
  • Egy gráfban egy tevékenység egy futás alatt legfeljebb 10 000-szer futhat.
  • A tulajdonos által a munkatársra beállított költési korlát elérésekor leállítja a futást. Egy tevékenység token_budget értéke becslés.
  • Az újraindítás miatt megszakadt futás megszakítottként jelölődik meg, és egyszer folytatódik.
  • A munkatárs az exit eszközzel korábban is befejezheti a futást.

Munkafolyamatok futtatása és kezelése

A tulajdonos bármely munkafolyamatot kézzel is futtathatja. A munkatársak a run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled és a Segítők és csapatok oldalon felsorolt többi munkafolyamat-eszközzel kezelik a munkafolyamatokat.