NeboAI
NeboAI
Kom igång

Aktiviteter

En aktivitet är ett steg i ett arbetsflöde. De flesta aktiviteter utförs av medarbetaren: du anger avsikten och den gör arbetet med sina färdigheter och anslutningar. Sex typer körs utan modellen, så att dirigering och tidpunkter förblir exakta.

Fält

{
  "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" }
}
FältStandardBetydelse
idobligatorisktUnikt inom arbetsflödet. Används i connections och datasökvägar.
typecustomEtt medarbetarsteg, eller en av condition, loop, wait, http, command, decide.
intentingetVad medarbetaren ska åstadkomma. Ett medarbetarsteg behöver intent eller steps.
steps[]Instruktioner i ordning, när en mening inte räcker.
labelingetNamn som visas för ägaren.
skills[]Färdigheter att använda. Färdigheter från marknadsplatsen som listas här installeras med medarbetaren.
tools[]När det är angivet: de enda verktyg som steget får använda.
requires_tools[]Verktyg som måste lyckas för att steget ska räknas som klart.
cmds[]Pluginkommandon som anges för steget.
mcps[]MCP-servrar som anges för steget.
modelingetEtt modell-id för det här steget.
paramsingetParametrar för de typade aktiviteterna, och maxIterations för medarbetarsteg.
min_iterationsingetMinsta antal modellturer innan steget får avslutas.
token_budgetinget{max}. En uppskattning.
on_error{retry: 1, fallback: notify_owner}Nya försök, sedan reservåtgärden. Ett fel efter de nya försöken avslutar körningen.

Medarbetarsteg

Ett medarbetarsteg körs som en tur för medarbetaren: dess persona, minne och anslutningar gäller, och den kan använda upp till 50 modellturer, eller params.maxIterations. Resultaten från tidigare steg skickas in som block av typen [Activity 'id' result]. Steget som avslutar ett arbetsflöde med en emit-lista ombeds anropa emit_event med de händelserna. Verktyget exit finns alltid tillgängligt för att avsluta körningen.

Datakontexten

Typade aktiviteter läser värden via punktnotationssökväg från ett objekt: inputs innehåller körningens indata, nodes.<id> innehåller varje avslutad aktivitets utdata (tolkad som JSON när den är JSON), och item innehåller det aktuella objektet i en loop. En sökväg utan prefix letar i inputs och sedan i nodes.

condition

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

params.expression är obligatoriskt. Dess utgående kopplingar har etiketterna True och False. params.mode väljer hur det tolkas:

LägeUttryck
expressionStandard. path op value med ==, !=, >=, <=, > eller <, jämfört som tal när båda sidor är tal; eller en sökväg utan operator, sann när dess värde är sant.
existsEn sökväg; sann när den ger ett sant värde.
containspath contains text, eller ren text som matchas mot föregående utdata.
regexEtt mönster som matchas mot föregående utdata.

loop

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

params.source är sökvägen till en lista. Kopplingen med etiketten Each item leder till loopens innehåll, som körs en gång per objekt med item satt; den med etiketten Done körs efter alla objekt. Iterationerna startar samtidigt om du inte anger concurrency. maxIterations och batchSize godtas också.

"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 och 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" } }
TypObligatorisktBeteende
waitparams.durationPausar under ett tidsspann i s, m eller h. Det finns ingen väntan till en viss tidpunkt; för att fortsätta vid en händelse låter du den utlösa ett andra arbetsflöde.
httpparams.urlGör förfrågan. method, headers och body är valfria.
commandparams.commandKör ett skalkommando. Dess stdout är aktivitetens utdata.

decide

En decide-aktivitet ställer typade frågor om arbetet hittills och sparar strukturerade svar som ett villkor kan dirigera på.

{
  "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 }
  }
}
FrågetypcriteriaSvar
choiceObjekt som mappar alternativ till beskrivning, 2 till 255 alternativ.choice, confidence och probabilities.
scoreLista med 2 till 10 ordnade nivåer.score från 0 (första nivån) och uppåt, och confidence.
noulInga.noul, sannolikheten att påståendet stämmer.

Dirigera på ett svar med ett villkor, till exempel nodes.triage.urgency.score >= 1.5. params.default anger det säkra svaret för varje fråga när inget beslut kan fattas; ett standardsvar har säkerheten 0. En fråga utan standardvärde får inget svar, så villkor på den följer sin False-kant.

Fel

on_error.retry anger hur många gånger en misslyckad aktivitet försöks igen; standard är 1. Efter det sista försöket avslutas körningen, och med standardvärdet notify_owner för fallback meddelas ägaren. Nebo kontrollerar varje typad aktivitets obligatoriska parametrar när körningen startar, och avvisar en gren som pekar på en okänd aktivitet.