NeboAI
NeboAI
Kom i gang

Aktiviteter

En aktivitet er ét trin i en arbejdsgang. De fleste aktiviteter udføres af medarbejderen: Du angiver hensigten, og den udfører arbejdet med sine færdigheder og forbindelser. Seks typer kører uden modellen, så dirigering og timing forbliver præcis.

Felter

{
  "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" }
}
FeltStandardBetydning
idpåkrævetUnik inden for arbejdsgangen. Bruges i connections og datastier.
typecustomEt medarbejdertrin eller en af condition, loop, wait, http, command, decide.
intentingenHvad medarbejderen skal opnå. Et medarbejdertrin kræver intent eller steps.
steps[]Instruktioner i rækkefølge, når én sætning ikke er nok.
labelingenNavn, der vises for ejeren.
skills[]Færdigheder, der skal bruges. Færdigheder fra markedspladsen, der står her, installeres sammen med medarbejderen.
tools[]Når det er angivet, de eneste værktøjer, trinnet må bruge.
requires_tools[]Værktøjer, der skal lykkes, for at trinnet tæller som udført.
cmds[]Pluginkommandoer, der er angivet for trinnet.
mcps[]MCP-servere, der er angivet for trinnet.
modelingenEt model-id til dette trin.
paramsingenParametre til de typede aktiviteter og maxIterations til medarbejdertrin.
min_iterationsingenMindste antal modelture, før trinnet må afslutte.
token_budgetingen{max}. Et skøn.
on_error{retry: 1, fallback: notify_owner}Genforsøg og derefter reserveløsningen. Enhver fejl efter genforsøgene afslutter kørslen.

Medarbejdertrin

Et medarbejdertrin kører som en tur for medarbejderen: Dens persona, hukommelse og forbindelser gælder, og den kan bruge op til 50 modelture eller params.maxIterations. Resultaterne af tidligere trin sendes ind som [Activity 'id' result]-blokke. Det trin, der afslutter en arbejdsgang med en emit-liste, får besked om at kalde emit_event med de hændelser. Værktøjet exit er altid tilgængeligt til at afslutte kørslen.

Datakonteksten

Typede aktiviteter læser værdier via punktumstier fra ét objekt: inputs indeholder kørslens input, nodes.<id> indeholder hver afsluttet aktivitets output (fortolket som JSON, når det er JSON), og item indeholder det aktuelle element inde i en løkke. En sti uden præfiks søger i inputs og derefter i nodes.

condition

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

params.expression er påkrævet. Dens udgående forbindelser er mærket True og False. params.mode vælger, hvordan det læses:

TilstandUdtryk
expressionStandarden. path op value med ==, !=, >=, <=, > eller <, sammenlignet som tal, når begge sider er tal; eller en sti alene, sand, når dens værdi er sand.
existsEn sti; sand, når den giver en sand værdi.
containspath contains text eller ren tekst, der matches mod det forrige output.
regexEt mønster, der matches mod det forrige output.

loop

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

params.source er stien til en liste. Forbindelsen mærket Each item fører til løkkens krop, som kører én gang pr. element med item angivet; den mærket Done kører efter alle elementer. Gennemløb starter samtidig, medmindre du angiver concurrency. maxIterations og batchSize accepteres også.

"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 og 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" } }
TypePåkrævetAdfærd
waitparams.durationHolder pause i et tidsrum i s, m eller h. Der er ingen vent-indtil; for at genoptage ved en hændelse skal du udløse en anden arbejdsgang på den.
httpparams.urlSender forespørgslen. method, headers og body er valgfri.
commandparams.commandKører en shellkommando. Dens stdout er aktivitetens output.

decide

En decide-aktivitet stiller typede spørgsmål om arbejdet indtil videre og registrerer strukturerede svar, som en condition kan dirigere efter.

{
  "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 }
  }
}
SpørgsmålstypecriteriaSvar
choiceObjekt fra valgmulighed til beskrivelse, 2 til 255 valgmuligheder.choice, confidence og probabilities.
scoreListe med 2 til 10 ordnede niveauer.score fra 0 (første niveau) og opefter samt confidence.
noulIngen.noul, sandsynligheden for, at udsagnet holder.

Dirigér efter et svar med en condition, f.eks. nodes.triage.urgency.score >= 1.5. params.default giver det sikre svar på hvert spørgsmål, når der ikke kan træffes nogen beslutning; et standardsvar har konfidens 0. Et spørgsmål uden standard får intet svar, så conditions på det følger deres False-kant.

Fejl

on_error.retry angiver, hvor mange gange en mislykket aktivitet forsøges igen; standarden er 1. Efter det sidste genforsøg afsluttes kørslen, og med standardværdien notify_owner for fallback får ejeren besked. Nebo tjekker hver typet aktivitets påkrævede parametre, når kørslen starter, og afviser en gren, der peger på en ukendt aktivitet.