NeboAI
NeboAI
Începe

Fluxuri de lucru

Un flux de lucru este o muncă pe care un angajat o face fără să i se ceară: un rezumat de dimineață, un răspuns la fiecare mesaj nou, un raport săptămânal. Fiecare flux de lucru asociază un declanșator cu activitățile pe care le îndeplinește angajatul. Fluxurile de lucru se află în agent.json al angajatului, așa că se mută împreună cu rolul.

Un prim flux de lucru

Adaugă o hartă workflows în agent.json. Fiecare cheie numește un flux de lucru; fiecare valoare are un declanșator și activități.

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

Acest flux de lucru rulează la 08:00 în zilele lucrătoare, după ora locală a botului. Angajatul îndeplinește activitatea cu propria persona, propriile abilități și propriile conexiuni.

Câmpurile fluxului de lucru

CâmpSemnificație
triggerObligatoriu. Când rulează fluxul de lucru. Vezi Declanșatoare.
descriptionLa ce servește fluxul de lucru.
activitiesPașii. Vezi Activități.
connectionsMuchii {from, to, label} care transformă activitățile într-un graf. __trigger__ este începutul, iar __emit__ sfârșitul.
emitEvenimentele pe care acest flux de lucru le anunță când se termină: o listă sau un șir separat prin virgule. Vezi Evenimente.
inputsValori transmise fiecărei rulări.
budget{total_per_run, cost_estimate}. Într-o rulare de tip graf, total_per_run limitează tokenurile de ieșire; altfel, ambele sunt estimări.
caseTransformă fluxul de lucru într-un singur caz de lungă durată pentru fiecare persoană sau lucru. Vezi Cazuri.

Un flux de lucru cu un declanșator și fără activități este valid. Un watch fără activități doar transmite evenimentele sale către alte fluxuri de lucru.

Cum se execută o rulare

Fără connections, activitățile rulează în ordine, iar angajatul o îndeplinește pe fiecare. Rezultatul fiecărei activități este transmis următoarei. O activitate fără rezultat încheie rularea.

Cu connections, activitățile formează un graf. Ramurile rulează în paralel, iar șase tipuri de activități rulează fără model: condition, loop, wait, http, command și decide. Folosește un graf când direcționarea trebuie să fie exactă.

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

Ce primește o rulare

Angajatul are întotdeauna persona sa și răspunsurile proprietarului la întrebările din inputs. O rulare primește și aceste valori, în funcție de declanșator.

IntrarePrezent când
_event_source, _event_payload, _event_originS-a declanșat un eveniment. Conținuturile de 8 KB sau mai mari sunt scurtate la câmpurile lor scalare, păstrând antetele e-mailurilor și referințele la atașamente.
_watch_payloadS-a declanșat un watch sau un folder. O linie din rezultatul observatorului sau {files} pentru un folder.
inputsÎntotdeauna. Valorile inputs proprii ale fluxului de lucru.

Cazuri

Unele munci se întind pe mai multe zile: un client potențial care are nevoie de reveniri, o cerere care așteaptă documente. Adaugă case, iar fluxul de lucru păstrează un caz deschis pentru fiecare persoană sau lucru, în loc să înceapă de la zero de fiecare dată.

CâmpSemnificație
keyObligatoriu. Căi cu puncte, separate prin virgule, în datele declanșatorului, care identifică subiectul, de exemplu contactEmail,email,phone.
typeTipul de caz, de exemplu lead. Fluxurile de lucru cu același tip împart cazurile. Implicit este numele fluxului de lucru.
default_waitCât se așteaptă când o tură nu specifică o așteptare: 3d, 12h, 45m. Implicit trei zile.

Fiecare tură a unui caz trebuie să se încheie cu un singur obiect JSON și nimic după el. result este starea de business; next îi spune motorului să facă wait sau close. Un termen limită este în format RFC 3339 sau un interval relativ. Orice altceva este o tură invalidă.

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

Limite și recuperare

  • Fiecare activitate poate folosi până la 50 de ture de model, dacă params.maxIterations nu specifică altfel.
  • Într-un graf, o activitate poate rula de cel mult 10.000 de ori într-o rulare.
  • Limita de cheltuieli setată de proprietar pentru angajat oprește o rulare când este atinsă. token_budget al unei activități este o estimare.
  • O rulare întreruptă de o repornire este marcată ca întreruptă și reluată o singură dată.
  • Angajatul poate încheia o rulare mai devreme cu instrumentul exit.

Rulează și administrează fluxurile de lucru

Proprietarul poate rula manual orice flux de lucru. Angajații administrează fluxurile de lucru cu run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled și celelalte instrumente pentru fluxuri de lucru listate pe pagina Ajutoare și echipe.