NeboAI
NeboAI
Magsimula

Mga Aktibidad

Ang activity ay isang hakbang ng workflow. Karamihan sa mga activity ay isinasagawa ng empleyado: sinasabi mo ang layunin at ginagawa nito ang trabaho gamit ang mga skill at koneksyon nito. Anim na uri ang tumatakbo nang walang model, kaya nananatiling eksakto ang pag-route at timing.

Mga field

{
  "id": "draft-reply",
  "label": "Draft the reply",
  "intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
  "skills": ["reply-drafting"],
  "requires_tools": ["mail_message_send"],
  "on_error": { "retry": 1, "fallback": "notify_owner" }
}
FieldDefaultKahulugan
idkailanganNatatangi sa loob ng workflow. Ginagamit sa connections at sa mga data path.
typecustomIsang hakbang ng empleyado, o isa sa condition, loop, wait, http, command, decide.
intentwalaKung ano ang dapat magawa ng empleyado. Kailangan ng hakbang ng empleyado ang intent o steps.
steps[]Sunud-sunod na instruction, kapag hindi sapat ang isang pangungusap.
labelwalaPangalang ipinapakita sa may-ari.
skills[]Mga skill na gagamitin. Ini-install kasama ng empleyado ang mga marketplace skill na nakalista rito.
tools[]Kapag nakatakda, ang tanging mga tool na magagamit ng hakbang.
requires_tools[]Mga tool na dapat magtagumpay para maituring na tapos ang hakbang.
cmds[]Mga plugin command na pinangalanan para sa hakbang.
mcps[]Mga MCP server na pinangalanan para sa hakbang.
modelwalaIsang model id para sa hakbang na ito.
paramswalaMga parameter para sa mga typed activity, at maxIterations para sa mga hakbang ng empleyado.
min_iterationswalaPinakakaunting model turn bago puwedeng matapos ang hakbang.
token_budgetwala{max}. Tantiya.
on_error{retry: 1, fallback: notify_owner}Mga retry, saka ang fallback. Tinatapos ang run ng anumang pagpalya pagkatapos ng mga retry.

Mga hakbang ng empleyado

Tumatakbo ang hakbang ng empleyado bilang isang turn ng empleyado: umiiral ang persona, memory at mga koneksyon nito, at puwede itong gumamit ng hanggang 50 model turn, o params.maxIterations. Ipinapasa ang mga resulta ng mga naunang hakbang bilang mga block na [Activity 'id' result]. Ang hakbang na nagtatapos sa workflow na may listahang emit ay sinasabihang tawagin ang emit_event gamit ang mga event na iyon. Laging available ang tool na exit para tapusin ang run.

Ang data context

Nagbabasa ang mga typed activity ng mga value ayon sa dotted path mula sa iisang object: hawak ng inputs ang mga input ng run, hawak ng nodes.<id> ang output ng bawat natapos na activity (pina-parse bilang JSON kapag JSON ito), at hawak ng item ang kasalukuyang item sa loob ng loop. Ang path na walang unahan ay tumitingin sa inputs, saka sa nodes.

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

Kailangan ang params.expression. May label na True at False ang mga palabas na koneksyon nito. Pinipili ng params.mode kung paano ito binabasa:

ModeExpression
expressionAng default. path op value gamit ang ==, !=, >=, <=, > o <, pinaghahambing bilang numero kapag numero ang magkabilang panig; o isang path lang, true kapag truthy ang value nito.
existsIsang path; true kapag truthy na value ang kinalalabasan nito.
containspath contains text, o text na itinutugma sa naunang output.
regexIsang pattern na itinutugma sa naunang output.

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

Ang params.source ay ang path ng isang listahan. Ang koneksyong may label na Each item ay papunta sa body, na tumatakbo nang isang beses bawat item nang nakatakda ang item; ang may label na Done ay tumatakbo pagkatapos ng lahat ng item. Sabay-sabay na nagsisimula ang mga iteration maliban kung itatakda mo ang concurrency. Tinatanggap din ang maxIterations at batchSize.

"connections": [
  { "from": "__trigger__", "to": "fetch" },
  { "from": "fetch", "to": "each-invoice" },
  { "from": "each-invoice", "to": "check", "label": "Each item" },
  { "from": "each-invoice", "to": "report", "label": "Done" }
]

wait, http at command

{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } }
UriKailanganGawi
waitparams.durationHumihinto nang isang tagal sa s, m o h. Walang wait-until; para ituloy sa isang event, mag-trigger ng ikalawang workflow dito.
httpparams.urlGinagawa ang request. Opsyonal ang method, headers at body.
commandparams.commandNagpapatakbo ng shell command. Ang stdout nito ang output ng activity.

decide

Nagtatanong ang decide activity ng mga typed na tanong tungkol sa trabaho sa ngayon at nire-record ang mga structured na sagot na mapag-uugatan ng route ng isang condition.

{
  "id": "triage",
  "type": "decide",
  "params": {
    "questions": {
      "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
      "refund": { "type": "noul", "instructions": "The customer is asking for money back." }
    },
    "default": { "urgency": "normal", "refund": false }
  }
}
Uri ng tanongcriteriaSagot
choiceObject ng opsyon papunta sa description, 2 hanggang 255 opsyon.choice, confidence at probabilities.
scoreListahan ng 2 hanggang 10 nakaayos na antas.score mula 0 (unang antas) pataas, at confidence.
noulWala.noul, ang probabilidad na totoo ang pahayag.

Mag-route batay sa sagot gamit ang condition, gaya ng nodes.triage.urgency.score >= 1.5. Ibinibigay ng params.default ang ligtas na sagot para sa bawat tanong kapag walang maipapasyang desisyon; may confidence na 0 ang sagot na default. Ang tanong na walang default ay walang sagot, kaya dumadaan sa False na edge ang mga condition dito.

Mga error

Itinatakda ng on_error.retry kung ilang beses ire-retry ang pumalyang activity; 1 ang default. Pagkatapos ng huling retry, natatapos ang run, at sa default na fallback na notify_owner, sinasabihan ang may-ari. Sinusuri ng Nebo ang mga kailangang parameter ng bawat typed activity kapag nagsimula ang run, at tinatanggihan ang branch na tumuturo sa hindi kilalang activity.