NeboAI
NeboAI
Kòmanse

Aktivite

Yon aktivite se yon etap nan yon pwosesis travay. Pifò aktivite se anplwaye a ki fè yo: ou di entansyon an e li fè travay la ak konpetans li ak koneksyon li. Sis tip mache san modèl la, konsa wout ak lè yo rete egzak.

Chan

{
  "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" }
}
ChanPa defoSiyifikasyon
idobligatwaInik nan pwosesis travay la. Yo sèvi ak li nan connections ak chemen done yo.
typecustomYon etap anplwaye, oswa youn nan condition, loop, wait, http, command, decide.
intentokennSa anplwaye a dwe akonpli. Yon etap anplwaye bezwen intent oswa steps.
steps[]Enstriksyon an lòd, lè yon sèl fraz pa ase.
labelokennNon ki parèt devan pwopriyetè a.
skills[]Konpetans pou sèvi ak yo. Konpetans makètplas ki nan lis isit la enstale ansanm ak anplwaye a.
tools[]Lè li defini, sèl zouti etap la ka sèvi ak yo.
requires_tools[]Zouti ki dwe reyisi pou etap la konte kòm fini.
cmds[]Kòmand plugin yo nonmen pou etap la.
mcps[]Sèvè MCP yo nonmen pou etap la.
modelokennYon id modèl pou etap sa a.
paramsokennParamèt pou aktivite tipe yo, ak maxIterations pou etap anplwaye.
min_iterationsokennKantite minimòm tou modèl anvan etap la ka fini.
token_budgetokenn{max}. Yon estimasyon.
on_error{retry: 1, fallback: notify_owner}Nouvo esè, apre sa solisyon ranplasman an. Nenpòt echèk apre nouvo esè yo fini egzekisyon an.

Etap anplwaye

Yon etap anplwaye mache kòm yon tou anplwaye a: pèsonalite l, memwa l ak koneksyon l aplike, e li ka sèvi ak jiska 50 tou modèl, oswa params.maxIterations. Rezilta etap anvan yo pase kòm blòk [Activity 'id' result]. Etap ki fini yon pwosesis travay ak yon lis emit resevwa lòd pou rele emit_event ak evènman sa yo. Zouti exit la toujou disponib pou fini egzekisyon an.

Kontèks done a

Aktivite tipe yo li valè pa chemen ak pwen nan yon sèl objè: inputs kenbe antre egzekisyon an, nodes.<id> kenbe rezilta chak aktivite ki fini (analize kòm JSON lè li an JSON), e item kenbe eleman aktyèl la andedan yon bouk. Yon chemen san prefiks chèche nan inputs, apre sa nan nodes.

condition

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

params.expression obligatwa. Koneksyon k ap soti yo gen etikèt True ak False. params.mode chwazi kijan yo li l:

MòdEkspresyon
expressionPa defo. path op value ak ==, !=, >=, <=, > oswa <, yo konpare kòm chif lè toude bò se chif; oswa yon chemen san prefiks, vre lè valè li konsidere vre.
existsYon chemen; vre lè li bay yon valè ki konsidere vre.
containspath contains text, oswa tèks san prefiks yo konpare ak rezilta anvan an.
regexYon modèl yo konpare ak rezilta anvan an.

loop

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

params.source se chemen yon lis. Koneksyon ki gen etikèt Each item la mennen nan kò a, ki mache yon fwa pou chak eleman ak item defini; sa ki gen etikèt Done la mache apre tout eleman yo. Iterasyon yo kòmanse ansanm sòf si ou defini concurrency. Yo aksepte maxIterations ak batchSize tou.

"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 ak 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" } }
TipObligatwaKonpòtman
waitparams.durationPran yon poz pou yon dire an s, m oswa h. Pa gen tann-jiskaske; pou rekòmanse sou yon evènman, deklanche yon dezyèm pwosesis travay sou li.
httpparams.urlFè demann lan. method, headers ak body opsyonèl.
commandparams.commandLanse yon kòmand shell. Stdout li se rezilta aktivite a.

decide

Yon aktivite decide poze kesyon tipe sou travay ki fèt deja epi li anrejistre repons estriktire yon condition ka sèvi pou chwazi wout.

{
  "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 }
  }
}
Tip kesyoncriteriaRepons
choiceObjè opsyon vè deskripsyon, 2 a 255 opsyon.choice, confidence ak probabilities.
scoreLis 2 a 10 nivo an lòd.score soti 0 (premye nivo) monte, ak confidence.
noulOkenn.noul, pwobabilite deklarasyon an vre.

Chwazi wout sou yon repons avèk yon condition, tankou nodes.triage.urgency.score >= 1.5. params.default bay repons san danje pou chak kesyon lè pa ka gen desizyon; yon repons pa defo gen konfyans 0. Yon kesyon san valè pa defo pa jwenn repons, kidonk condition sou li pran branch False yo.

Erè

on_error.retry fikse konbyen fwa yo reeseye yon aktivite ki echwe; pa defo se 1. Apre dènye esè a egzekisyon an fini, e avèk fallback pa defo notify_owner la, yo avèti pwopriyetè a. Nebo verifye paramèt obligatwa chak aktivite tipe lè egzekisyon an kòmanse, e li rejte yon branch ki pwente sou yon aktivite li pa konnen.