NeboAI
NeboAI
Kezdés

Tevékenységek

A tevékenység egy munkafolyamat egy lépése. A legtöbb tevékenységet a munkatárs végzi el: Ön megadja a szándékot, ő pedig elvégzi a munkát a készségeivel és kapcsolataival. Hat típus a modell nélkül fut, így az irányítás és az időzítés pontos marad.

Mezők

{
  "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" }
}
MezőAlapértékJelentés
idkötelezőA munkafolyamaton belül egyedi. A connections részben és az adatútvonalakban használatos.
typecustomMunkatársi lépés, vagy a következők egyike: condition, loop, wait, http, command, decide.
intentnincsMit kell elérnie a munkatársnak. Egy munkatársi lépéshez intent vagy steps szükséges.
steps[]Sorrendbe rendezett utasítások, ha egy mondat nem elég.
labelnincsA tulajdonosnak megjelenített név.
skills[]Használandó készségek. Az itt felsorolt piactéri készségek a munkatárssal együtt települnek.
tools[]Ha meg van adva, csak ezeket az eszközöket használhatja a lépés.
requires_tools[]Eszközök, amelyeknek sikeresen le kell futniuk ahhoz, hogy a lépés elvégzettnek számítson.
cmds[]A lépéshez megnevezett bővítményparancsok.
mcps[]A lépéshez megnevezett MCP-szerverek.
modelnincsModellazonosító ehhez a lépéshez.
paramsnincsA típusos tevékenységek paraméterei, és munkatársi lépéseknél a maxIterations.
min_iterationsnincsA modellkörök minimális száma, mielőtt a lépés befejeződhet.
token_budgetnincs{max}. Becslés.
on_error{retry: 1, fallback: notify_owner}Újrapróbálkozások, majd a tartalék megoldás. Az újrapróbálkozások utáni bármely hiba befejezi a futást.

Munkatársi lépések

A munkatársi lépés a munkatárs egy köreként fut: érvényes rá a személyisége, a memóriája és a kapcsolatai, és legfeljebb 50 modellkört használhat, vagy a params.maxIterations értékét. A korábbi lépések eredményei [Activity 'id' result] blokkokként kerülnek átadásra. Az a lépés, amely egy emit listával fejez be egy munkafolyamatot, utasítást kap, hogy hívja meg az emit_event eszközt ezekkel az eseményekkel. Az exit eszköz mindig elérhető a futás befejezéséhez.

Az adatkörnyezet

A típusos tevékenységek pontokkal tagolt útvonalon olvasnak értékeket egyetlen objektumból: az inputs a futás bemeneteit tartalmazza, a nodes.<id> az egyes befejezett tevékenységek kimenetét (JSON-ként értelmezve, ha JSON), az item pedig a ciklus aktuális elemét. Egy előtag nélküli útvonal előbb az inputs, majd a nodes részben keres.

condition

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

A params.expression kötelező. A kimenő kapcsolatai True és False címkét kapnak. A params.mode határozza meg, hogyan értelmezi:

MódKifejezés
expressionAz alapértelmezett. path op value a ==, !=, >=, <=, > vagy < operátorral, számként összehasonlítva, ha mindkét oldal szám; vagy egy puszta útvonal, amely igaz, ha az értéke igaz értékű.
existsEgy útvonal; igaz, ha igaz értékűre oldódik fel.
containspath contains text, vagy az előző kimenetre illesztett puszta szöveg.
regexAz előző kimenetre illesztett minta.

loop

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

A params.source egy lista útvonala. Az Each item címkéjű kapcsolat a törzshöz vezet, amely elemenként egyszer fut le az item beállításával; a Done címkéjű az összes elem után fut. Az iterációk egyszerre indulnak, hacsak nem állítja be a concurrency értékét. A maxIterations és a batchSize is elfogadott.

"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 és 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" } }
TípusKötelezőViselkedés
waitparams.durationSzünetet tart s, m vagy h egységben megadott ideig. Nincs „várakozás eddig”; ha egy eseményre szeretne folytatni, indítson rá egy második munkafolyamatot.
httpparams.urlElküldi a kérést. A method, a headers és a body opcionális.
commandparams.commandShell-parancsot futtat. A stdout kimenete a tevékenység kimenete.

decide

A decide tevékenység típusos kérdéseket tesz fel az eddigi munkáról, és strukturált válaszokat rögzít, amelyek alapján egy condition irányíthat.

{
  "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 }
  }
}
KérdéstípuscriteriaVálasz
choiceLehetőség és leírás összerendelése, 2–255 lehetőség.choice, confidence és probabilities.
score2–10 sorrendbe rendezett szint listája.score 0-tól (első szint) felfelé, és confidence.
noulNincs.noul, annak valószínűsége, hogy az állítás igaz.

Egy válasz alapján condition segítségével irányíthat, például nodes.triage.urgency.score >= 1.5. A params.default minden kérdéshez megadja a biztonságos választ arra az esetre, ha nem lehet döntést hozni; az alapértelmezett válasz megbízhatósága 0. Az alapérték nélküli kérdés nem kap választ, így a rá vonatkozó feltételek a False élen haladnak tovább.

Hibák

Az on_error.retry határozza meg, hányszor próbálkozik újra egy sikertelen tevékenység; az alapérték 1. Az utolsó újrapróbálkozás után a futás befejeződik, és a notify_owner alapértelmezett fallback esetén a tulajdonos értesítést kap. A Nebo a futás indításakor ellenőrzi minden típusos tevékenység kötelező paramétereit, és elutasítja az ismeretlen tevékenységre mutató ágat.