NeboAI
NeboAI
Začať

Aktivity

Aktivita je jeden krok pracovného postupu. Väčšinu aktivít vykonáva zamestnanec: vy uvediete zámer a on prácu urobí so svojimi zručnosťami a pripojeniami. Šesť typov beží bez modelu, takže smerovanie a načasovanie zostávajú presné.

Polia

{
  "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" }
}
PolePredvolenéVýznam
idpovinnéJedinečné v rámci pracovného postupu. Používa sa v connections a v dátových cestách.
typecustomKrok zamestnanca alebo jeden z typov condition, loop, wait, http, command, decide.
intentžiadneČo má zamestnanec dosiahnuť. Krok zamestnanca potrebuje intent alebo steps.
steps[]Pokyny v poradí, keď jedna veta nestačí.
labelžiadneNázov zobrazený vlastníkovi.
skills[]Zručnosti na použitie. Zručnosti z obchodu uvedené tu sa nainštalujú spolu so zamestnancom.
tools[]Ak sú nastavené, jediné nástroje, ktoré krok smie použiť.
requires_tools[]Nástroje, ktoré musia uspieť, aby sa krok považoval za hotový.
cmds[]Príkazy doplnkov určené pre krok.
mcps[]Servery MCP určené pre krok.
modelžiadneId modelu pre tento krok.
paramsžiadneParametre pre typové aktivity a maxIterations pre kroky zamestnanca.
min_iterationsžiadneMinimálny počet ťahov modelu, kým sa krok môže dokončiť.
token_budgetžiadne{max}. Odhad.
on_error{retry: 1, fallback: notify_owner}Opakovania a potom záložný postup. Každé zlyhanie po opakovaniach ukončí beh.

Kroky zamestnanca

Krok zamestnanca beží ako ťah zamestnanca: uplatňuje sa jeho osobnosť, pamäť a pripojenia a môže použiť najviac 50 ťahov modelu alebo params.maxIterations. Výsledky predchádzajúcich krokov sa odovzdávajú ako bloky [Activity 'id' result]. Krok, ktorý ukončuje pracovný postup so zoznamom emit, dostane pokyn zavolať emit_event s týmito udalosťami. Nástroj exit je vždy k dispozícii na ukončenie behu.

Dátový kontext

Typové aktivity čítajú hodnoty podľa cesty s bodkami z jedného objektu: inputs obsahuje vstupy behu, nodes.<id> obsahuje výstup každej dokončenej aktivity (spracovaný ako JSON, ak ide o JSON) a item obsahuje aktuálnu položku v cykle. Holá cesta sa hľadá v inputs, potom v nodes.

condition

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

params.expression je povinné. Jeho odchádzajúce spojenia sú označené True a False. params.mode určuje, ako sa výraz číta:

RežimVýraz
expressionPredvolené. path op value s ==, !=, >=, <=, > alebo <, porovnávané ako čísla, keď sú obe strany čísla; alebo holá cesta, pravda, keď je jej hodnota pravdivá.
existsCesta; pravda, keď sa vyhodnotí na pravdivú hodnotu.
containspath contains text alebo holý text porovnávaný s predchádzajúcim výstupom.
regexVzor porovnávaný s predchádzajúcim výstupom.

loop

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

params.source je cesta k zoznamu. Spojenie označené Each item vedie k telu, ktoré sa spustí raz pre každú položku s nastaveným item; spojenie označené Done sa spustí po všetkých položkách. Iterácie sa začnú naraz, pokiaľ nenastavíte concurrency. Prijímajú sa aj 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éSprávanie
waitparams.durationPozastaví sa na úsek v s, m alebo h. Čakanie do určitého času neexistuje; ak chcete pokračovať po udalosti, spustite na ňu druhý pracovný postup.
httpparams.urlOdošle požiadavku. method, headers a body sú voliteľné.
commandparams.commandSpustí príkaz shellu. Jeho stdout je výstupom aktivity.

decide

Aktivita decide kladie typové otázky o doterajšej práci a zaznamenáva štruktúrované odpovede, podľa ktorých môže smerovať podmienka.

{
  "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ázkycriteriaOdpoveď
choiceObjekt možností s popismi, 2 až 255 možností.choice, confidence a probabilities.
scoreZoznam 2 až 10 zoradených úrovní.score od 0 (prvá úroveň) vyššie a confidence.
noulŽiadne.noul, pravdepodobnosť, že tvrdenie platí.

Smerujte podľa odpovede pomocou podmienky, napríklad nodes.triage.urgency.score >= 1.5. params.default určuje bezpečnú odpoveď na každú otázku, keď sa nedá rozhodnúť; predvolená odpoveď má istotu 0. Otázka bez predvolenej hodnoty nedostane odpoveď, takže podmienky na nej idú po hrane False.

Chyby

on_error.retry určuje, koľkokrát sa zlyhaná aktivita zopakuje; predvolene je to 1. Po poslednom opakovaní sa beh ukončí a pri predvolenom fallback s hodnotou notify_owner dostane vlastník správu. Nebo pri spustení behu skontroluje povinné parametre každej typovej aktivity a odmietne vetvu, ktorá ukazuje na neznámu aktivitu.