NeboAI
NeboAI
Magsimula

Mga Workflow

Ang workflow ay trabahong ginagawa ng empleyado nang hindi inuutusan: isang buod tuwing umaga, sagot sa bawat bagong mensahe, lingguhang report. Ipinapares ng bawat workflow ang isang trigger sa mga activity na isinasagawa ng empleyado. Nasa agent.json ng empleyado ang mga workflow, kaya kasama nila ang role saanman ito dalhin.

Isang unang workflow

Magdagdag ng workflows map sa agent.json. Pinapangalanan ng bawat key ang isang workflow; may trigger at mga activity ang bawat value.

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

Tumatakbo ang workflow na ito nang 08:00 tuwing weekday, sa lokal na oras ng bot. Isinasagawa ng empleyado ang activity gamit ang sarili nitong persona, mga skill at koneksyon.

Mga field ng workflow

FieldKahulugan
triggerKailangan. Kung kailan tumatakbo ang workflow. Tingnan ang Triggers.
descriptionKung para saan ang workflow.
activitiesAng mga hakbang. Tingnan ang Activities.
connectionsMga edge na {from, to, label} na ginagawang graph ang mga activity. Ang __trigger__ ang simula at ang __emit__ ang dulo.
emitMga event na inaanunsyo ng workflow na ito kapag natapos ito: isang listahan, o isang string na pinaghihiwalay ng kuwit. Tingnan ang Events.
inputsMga value na ipinapasa sa bawat run.
budget{total_per_run, cost_estimate}. Sa graph run, nililimitahan ng total_per_run ang mga output token; kung hindi, tantiya lang ang dalawa.
caseGinagawang isang matagal na case ang workflow bawat tao o bagay. Tingnan ang Cases.

Valid ang workflow na may trigger pero walang activity. Ang watch na walang activity ay nagpapasa lang ng mga event nito sa ibang workflow.

Paano isinasagawa ang isang run

Kapag walang connections, sunud-sunod na tumatakbo ang mga activity at ginagawa ng empleyado ang bawat isa. Ipinapasa sa susunod ang resulta ng bawat activity. Tinatapos ang run ng activity na walang output.

Kapag may connections, bumubuo ng graph ang mga activity. Sabay-sabay na tumatakbo ang mga branch, at anim na uri ng activity ang tumatakbo nang walang model: condition, loop, wait, http, command at decide. Gumamit ng graph kapag kailangang eksakto ang pag-route.

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

Ano ang natatanggap ng isang run

Laging nasa empleyado ang persona nito at ang mga sagot ng may-ari sa mga tanong sa inputs nito. Natatanggap din ng isang run ang mga value na ito, depende sa trigger nito.

InputNaroon kapag
_event_source, _event_payload, _event_originNag-fire ang isang event trigger. Ang mga payload na 8 KB pataas ay pinaiikli sa mga scalar field nila, at pinapanatili ang mga email header at reference sa attachment.
_watch_payloadNag-fire ang isang watch o folder trigger. Isang linya ng output ng watcher, o {files} para sa isang folder.
inputsPalagi. Ang sariling mga value ng inputs ng workflow.

Mga case

May mga trabahong umaabot nang ilang araw: isang lead na kailangang i-follow up, isang request na naghihintay ng mga dokumento. Idagdag ang case at magpapanatili ang workflow ng isang bukas na case bawat tao o bagay sa halip na magsimula ulit sa bawat pagkakataon.

FieldKahulugan
keyKailangan. Mga dotted path na pinaghihiwalay ng kuwit papunta sa trigger data na tumutukoy sa paksa, gaya ng contactEmail,email,phone.
typeAng uri ng case, gaya ng lead. Pinagsasaluhan ng mga workflow na may parehong uri ang mga case. Default ay ang pangalan ng workflow.
default_waitGaano katagal maghihintay kapag walang binanggit na paghihintay ang isang turn: 3d, 12h, 45m. Default ay tatlong araw.

Bawat turn ng isang case ay dapat magtapos sa isang JSON object at wala nang kasunod. Ang result ang estado ng negosyo; sinasabihan ng next ang engine na mag-wait o mag-close. Ang deadline ay RFC 3339 o isang relative na tagal. Invalid na turn ang anumang iba pa.

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

Mga limit at pagbawi

  • Bawat activity ay puwedeng gumamit ng hanggang 50 model turn, maliban kung iba ang sinasabi ng params.maxIterations.
  • Sa isang graph, puwedeng tumakbo ang isang activity nang hanggang 10,000 beses sa isang run.
  • Pinahihinto ng spending cap ng may-ari para sa empleyado ang isang run kapag naabot ito. Tantiya lang ang token_budget ng isang activity.
  • Ang run na naputol dahil sa restart ay minamarkahang interrupted at itinutuloy nang isang beses.
  • Puwedeng tapusin ng empleyado ang run nang mas maaga gamit ang tool na exit.

Patakbuhin at pamahalaan ang mga workflow

Puwedeng patakbuhin ng may-ari ang kahit anong workflow nang mano-mano. Pinamamahalaan ng mga empleyado ang mga workflow gamit ang run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled at ang iba pang workflow tool na nakalista sa Helpers and Teams.