NeboAI
NeboAI
Začít

Aktivity

Činnost je jeden krok pracovního postupu. Většinu činností provádí zaměstnanec: vy uvedete záměr a on práci udělá pomocí svých dovedností a připojení. Šest typů běží bez modelu, takže směrování i načasování zůstávají přesné.

Pole

{
  "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" }
}
PoleVýchozíVýznam
idpovinnéJedinečné v rámci pracovního postupu. Používá se v connections a v datových cestách.
typecustomKrok zaměstnance, nebo jeden z typů condition, loop, wait, http, command, decide.
intentžádnéČeho má zaměstnanec dosáhnout. Krok zaměstnance potřebuje intent nebo steps.
steps[]Seřazené pokyny, když jedna věta nestačí.
labelžádnéNázev zobrazený vlastníkovi.
skills[]Dovednosti, které se mají použít. Dovednosti z obchodu, které jsou zde uvedeny, se nainstalují spolu se zaměstnancem.
tools[]Pokud je nastaveno, jediné nástroje, které krok smí použít.
requires_tools[]Nástroje, které musí uspět, aby se krok počítal jako hotový.
cmds[]Příkazy pluginů určené pro tento krok.
mcps[]Servery MCP určené pro tento krok.
modelžádnéId modelu pro tento krok.
paramsžádnéParametry pro typované činnosti a maxIterations pro kroky zaměstnance.
min_iterationsžádnéMinimální počet tahů modelu, než se krok smí dokončit.
token_budgetžádné{max}. Odhad.
on_error{retry: 1, fallback: notify_owner}Opakované pokusy, pak záložní postup. Jakékoli selhání po vyčerpání pokusů běh ukončí.

Kroky zaměstnance

Krok zaměstnance běží jako tah zaměstnance: uplatní se jeho persona, paměť a připojení a může využít až 50 tahů modelu, nebo params.maxIterations. Výsledky předchozích kroků se předávají jako bloky [Activity 'id' result]. Krok, který ukončuje pracovní postup se seznamem emit, dostane pokyn zavolat emit_event s těmito událostmi. Nástroj exit je k ukončení běhu k dispozici vždy.

Datový kontext

Typované činnosti čtou hodnoty podle tečkové cesty z jednoho objektu: inputs obsahuje vstupy běhu, nodes.<id> obsahuje výstup každé dokončené činnosti (zpracovaný jako JSON, pokud jde o JSON) a item obsahuje aktuální položku uvnitř smyčky. Cesta bez předpony se hledá v inputs, pak v nodes.

condition

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

params.expression je povinné. Odchozí spojení mají popisky True a False. params.mode určuje, jak se výraz čte:

RežimVýraz
expressionVýchozí. path op value s ==, !=, >=, <=, > nebo <, porovnávané jako čísla, když jsou obě strany čísla; nebo samotná cesta, pravdivá, když je její hodnota pravdivá.
existsCesta; pravdivá, když se vyhodnotí na pravdivou hodnotu.
containspath contains text, nebo samotný text porovnávaný s předchozím výstupem.
regexVzor porovnávaný s předchozím výstupem.

loop

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

params.source je cesta k seznamu. Spojení s popiskem Each item vede k tělu, které proběhne jednou pro každou položku s nastaveným item; spojení s popiskem Done proběhne po zpracování všech položek. Iterace začínají současně, pokud nenastavíte concurrency. Přijímají se také maxIterations a 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 a 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" } }
TypPovinnéChování
waitparams.durationPozastaví se na dobu zadanou v s, m nebo h. Čekání do určitého okamžiku neexistuje; chcete-li pokračovat po události, spusťte na ni druhý pracovní postup.
httpparams.urlOdešle požadavek. method, headers a body jsou volitelné.
commandparams.commandSpustí příkaz shellu. Jeho stdout je výstupem činnosti.

decide

Činnost decide klade typované otázky o dosavadní práci a zaznamenává strukturované odpovědi, podle kterých může směrovat podmínka.

{
  "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 }
  }
}
Typ otázkycriteriaOdpověď
choiceObjekt přiřazující možnostem popisy, 2 až 255 možností.choice, confidence a probabilities.
scoreSeznam 2 až 10 seřazených úrovní.score od 0 (první úroveň) výše a confidence.
noulŽádné.noul, pravděpodobnost, že tvrzení platí.

Podle odpovědi směrujte podmínkou, například nodes.triage.urgency.score >= 1.5. params.default určuje bezpečnou odpověď na každou otázku pro případ, že rozhodnutí nelze učinit; výchozí odpověď má jistotu 0. Otázka bez výchozí hodnoty nedostane žádnou odpověď, takže podmínky na ní půjdou po hraně False.

Chyby

on_error.retry určuje, kolikrát se neúspěšná činnost zopakuje; výchozí hodnota je 1. Po posledním opakování běh skončí a s výchozím fallback notify_owner dostane vlastník zprávu. Nebo při spuštění běhu zkontroluje povinné parametry každé typované činnosti a odmítne větev, která odkazuje na neznámou činnost.