NeboAI
NeboAI
Kom i gang

Aktiviteter

En aktivitet er ett trinn i en arbeidsflyt. De fleste aktiviteter utføres av den ansatte: du oppgir hensikten, og den gjør arbeidet med sine ferdigheter og tilkoblinger. Seks typer kjører uten modellen, så ruting og tidsstyring forblir eksakt.

Felt

{
  "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
idobligatoriskUnik i arbeidsflyten. Brukes i connections og datastier.
typecustomEt ansattrinn, eller en av condition, loop, wait, http, command, decide.
intentingenHva den ansatte skal oppnå. Et ansattrinn trenger intent eller steps.
steps[]Ordnede instruksjoner, når én setning ikke er nok.
labelingenNavnet som vises for eieren.
skills[]Ferdigheter som skal brukes. Ferdigheter fra markedsplassen som står her, installeres sammen med den ansatte.
tools[]Når angitt, de eneste verktøyene trinnet kan bruke.
requires_tools[]Verktøy som må lykkes for at trinnet skal regnes som fullført.
cmds[]Tilleggskommandoer som er nevnt for trinnet.
mcps[]MCP-servere som er nevnt for trinnet.
modelingenEn modell-ID for dette trinnet.
paramsingenParametere for de typede aktivitetene, og maxIterations for ansattrinn.
min_iterationsingenMinste antall modellturer før trinnet kan avsluttes.
token_budgetingen{max}. Et anslag.
on_error{retry: 1, fallback: notify_owner}Nye forsøk, deretter reserveløsningen. Enhver feil etter nye forsøk avslutter kjøringen.

Ansattrinn

Et ansattrinn kjører som en tur for den ansatte: personaen, minnet og tilkoblingene gjelder, og den kan bruke opptil 50 modellturer, eller params.maxIterations. Resultatene av tidligere trinn sendes inn som [Activity 'id' result]-blokker. Trinnet som avslutter en arbeidsflyt med en emit-liste, får beskjed om å kalle emit_event med disse hendelsene. Verktøyet exit er alltid tilgjengelig for å avslutte kjøringen.

Datakonteksten

Typede aktiviteter leser verdier etter punktsti fra ett objekt: inputs inneholder kjøringens inndata, nodes.<id> inneholder utdataene fra hver ferdige aktivitet (tolket som JSON når det er JSON), og item inneholder gjeldende element i en løkke. En sti uten prefiks ser i inputs, deretter i nodes.

condition

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

params.expression er obligatorisk. De utgående tilkoblingene merkes True og False. params.mode velger hvordan det leses:

ModusUttrykk
expressionStandard. path op value med ==, !=, >=, <=, > eller <, sammenlignet som tall når begge sider er tall; eller en sti alene, sann når verdien er en sannhetsverdi.
existsEn sti; sann når den gir en sannhetsverdi.
containspath contains text, eller ren tekst som matches mot forrige utdata.
regexEt mønster som matches mot forrige utdata.

loop

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

params.source er stien til en liste. Tilkoblingen merket Each item fører til innholdet, som kjører én gang per element med item angitt; den merket Done kjører etter alle elementene. Iterasjonene starter samtidig med mindre du angir concurrency. maxIterations og batchSize godtas 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" } }
TypeObligatoriskVirkemåte
waitparams.durationVenter i et tidsrom i s, m eller h. Det finnes ingen vent-til; for å fortsette ved en hendelse utløser du en andre arbeidsflyt på den.
httpparams.urlSender forespørselen. method, headers og body er valgfrie.
commandparams.commandKjører en skallkommando. Stdout fra den er aktivitetens utdata.

decide

En decide-aktivitet stiller typede spørsmål om arbeidet så langt og registrerer strukturerte svar som en betingelse kan rute etter.

{
  "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ørsmålstypecriteriaSvar
choiceObjekt fra alternativ til beskrivelse, 2 til 255 alternativer.choice, confidence og probabilities.
scoreListe med 2 til 10 ordnede nivåer.score fra 0 (første nivå) og oppover, og confidence.
noulIngen.noul, sannsynligheten for at påstanden stemmer.

Rut etter et svar med en betingelse, for eksempel nodes.triage.urgency.score >= 1.5. params.default gir det trygge svaret på hvert spørsmål når ingen beslutning kan tas; et standardsvar har konfidens 0. Et spørsmål uten standardverdi får ikke noe svar, så betingelser på det tar False-kanten.

Feil

on_error.retry angir hvor mange ganger en mislykket aktivitet prøves på nytt; standard er 1. Etter siste forsøk avsluttes kjøringen, og med standardverdien notify_owner for fallback får eieren beskjed. Nebo kontrollerer de obligatoriske parameterne for hver typede aktivitet når kjøringen starter, og avviser en gren som peker til en ukjent aktivitet.