NeboAI
NeboAI
Începe

Activități

O activitate este un pas al unui flux de lucru. Cele mai multe activități sunt îndeplinite de angajat: tu spui intenția, iar el face munca cu abilitățile și conexiunile sale. Șase tipuri rulează fără model, astfel încât direcționarea și sincronizarea rămân exacte.

Câmpuri

{
  "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" }
}
CâmpImplicitSemnificație
idobligatoriuUnic în cadrul fluxului de lucru. Folosit în connections și în căile de date.
typecustomUn pas al angajatului sau unul dintre condition, loop, wait, http, command, decide.
intentniciunaCe ar trebui să realizeze angajatul. Un pas al angajatului are nevoie de intent sau steps.
steps[]Instrucțiuni ordonate, când o singură propoziție nu este suficientă.
labelniciunaNumele afișat proprietarului.
skills[]Abilitățile de folosit. Abilitățile din magazin listate aici sunt instalate odată cu angajatul.
tools[]Când este setat, singurele instrumente pe care pasul le poate folosi.
requires_tools[]Instrumente care trebuie să reușească pentru ca pasul să fie considerat încheiat.
cmds[]Comenzi de plugin numite pentru pas.
mcps[]Servere MCP numite pentru pas.
modelniciunaUn id de model pentru acest pas.
paramsniciunaParametri pentru activitățile tipizate și maxIterations pentru pașii angajatului.
min_iterationsniciunaNumărul minim de ture de model înainte ca pasul să se poată încheia.
token_budgetniciuna{max}. O estimare.
on_error{retry: 1, fallback: notify_owner}Reîncercări, apoi varianta de rezervă. Orice eșec după reîncercări încheie rularea.

Pașii angajatului

Un pas al angajatului rulează ca o tură a angajatului: se aplică persona, memoria și conexiunile sale și poate folosi până la 50 de ture de model sau params.maxIterations. Rezultatele pașilor anteriori sunt transmise ca blocuri [Activity 'id' result]. Pasului care încheie un flux de lucru cu o listă emit i se spune să apeleze emit_event cu acele evenimente. Instrumentul exit este întotdeauna disponibil pentru a încheia rularea.

Contextul de date

Activitățile tipizate citesc valori după căi cu puncte dintr-un singur obiect: inputs conține intrările rulării, nodes.<id> conține rezultatul fiecărei activități încheiate (interpretat ca JSON când este JSON), iar item conține elementul curent din interiorul unei bucle. O cale simplă caută în inputs, apoi în nodes.

condition

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

params.expression este obligatoriu. Conexiunile de ieșire sunt etichetate True și False. params.mode alege cum este interpretată:

ModExpresie
expressionImplicit. path op value cu ==, !=, >=, <=, > sau <, comparate ca numere când ambele părți sunt numere; sau o cale simplă, adevărată când valoarea ei este considerată adevărată.
existsO cale; adevărată când se rezolvă la o valoare considerată adevărată.
containspath contains text sau text simplu căutat în rezultatul anterior.
regexUn model căutat în rezultatul anterior.

loop

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

params.source este calea unei liste. Conexiunea etichetată Each item duce la corp, care rulează o dată pentru fiecare element cu item setat; cea etichetată Done rulează după toate elementele. Iterațiile pornesc împreună, dacă nu setezi concurrency. Sunt acceptate și maxIterations și 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 și 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" } }
TipObligatoriuComportament
waitparams.durationFace o pauză pe un interval în s, m sau h. Nu există așteptare până la un moment anume; ca să reiei la un eveniment, declanșează un al doilea flux de lucru pe acel eveniment.
httpparams.urlFace cererea. method, headers și body sunt opționale.
commandparams.commandRulează o comandă de shell. Stdout-ul ei este rezultatul activității.

decide

O activitate decide pune întrebări tipizate despre munca făcută până acum și înregistrează răspunsuri structurate după care o condiție poate direcționa.

{
  "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 }
  }
}
Tipul întrebăriicriteriaRăspuns
choiceObiect de tip opțiune către descriere, între 2 și 255 de opțiuni.choice, confidence și probabilities.
scoreListă de 2 până la 10 niveluri ordonate.score de la 0 (primul nivel) în sus și confidence.
noulNiciunul.noul, probabilitatea ca afirmația să fie adevărată.

Direcționează după un răspuns cu o condiție, de exemplu nodes.triage.urgency.score >= 1.5. params.default dă răspunsul sigur pentru fiecare întrebare când nu se poate lua o decizie; un răspuns implicit are încrederea 0. O întrebare fără valoare implicită nu primește niciun răspuns, așa că condițiile bazate pe ea iau muchia False.

Erori

on_error.retry setează de câte ori este reîncercată o activitate eșuată; valoarea implicită este 1. După ultima reîncercare, rularea se încheie, iar cu fallback implicit notify_owner proprietarul este anunțat. Nebo verifică parametrii obligatorii ai fiecărei activități tipizate la pornirea rulării și respinge o ramură care trimite la o activitate necunoscută.