NeboAI
NeboAI
Comenzar

Actividades

Una actividad es un paso de un flujo de trabajo. La mayoría de las actividades las realiza el empleado: tú indicas la intención y él hace el trabajo con sus skills y conexiones. Seis tipos se ejecutan sin el modelo, para que el enrutamiento y los tiempos sean exactos.

Campos

{
  "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" }
}
CampoPredeterminadoSignificado
idobligatorioÚnico dentro del flujo de trabajo. Se usa en connections y en las rutas de datos.
typecustomUn paso del empleado, o uno de condition, loop, wait, http, command, decide.
intentningunoLo que el empleado debe lograr. Un paso del empleado necesita intent o steps.
steps[]Instrucciones en orden, cuando una oración no basta.
labelningunoNombre que se le muestra al dueño.
skills[]Skills que se usan. Las skills de la tienda que aparecen aquí se instalan con el empleado.
tools[]Cuando se define, las únicas herramientas que puede usar el paso.
requires_tools[]Herramientas que deben tener éxito para que el paso cuente como hecho.
cmds[]Comandos de plugin indicados para el paso.
mcps[]Servidores MCP indicados para el paso.
modelningunoUn id de modelo para este paso.
paramsningunoParámetros de las actividades tipadas, y maxIterations para los pasos del empleado.
min_iterationsningunoMínimo de turnos del modelo antes de que el paso pueda terminar.
token_budgetninguno{max}. Una estimación.
on_error{retry: 1, fallback: notify_owner}Reintentos y luego el plan alternativo. Cualquier falla después de los reintentos termina la ejecución.

Pasos del empleado

Un paso del empleado se ejecuta como un turno del empleado: se aplican su personalidad, su memoria y sus conexiones, y puede usar hasta 50 turnos del modelo, o params.maxIterations. Los resultados de los pasos anteriores se pasan como bloques [Activity 'id' result]. Al paso que termina un flujo de trabajo con una lista emit se le indica que llame a emit_event con esos eventos. La herramienta exit siempre está disponible para terminar la ejecución.

El contexto de datos

Las actividades tipadas leen valores por ruta con puntos de un solo objeto: inputs contiene las entradas de la ejecución, nodes.<id> contiene la salida de cada actividad terminada (interpretada como JSON cuando es JSON) e item contiene el elemento actual dentro de un loop. Una ruta sin prefijo busca en inputs y luego en nodes.

condition

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

params.expression es obligatorio. Sus conexiones de salida llevan las etiquetas True y False. params.mode elige cómo se interpreta:

ModoExpresión
expressionEl predeterminado. path op value con ==, !=, >=, <=, > o <, comparados como números cuando ambos lados son números; o una ruta simple, verdadera cuando su valor es verdadero.
existsUna ruta; es verdadera cuando se resuelve a un valor verdadero.
containspath contains text, o texto simple que se compara con la salida anterior.
regexUn patrón que se compara con la salida anterior.

loop

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

params.source es la ruta de una lista. La conexión con la etiqueta Each item lleva al cuerpo, que se ejecuta una vez por elemento con item definido; la que tiene la etiqueta Done se ejecuta después de todos los elementos. Las iteraciones empiezan juntas salvo que definas concurrency. También se aceptan maxIterations y 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 y 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" } }
TipoObligatorioComportamiento
waitparams.durationHace una pausa durante un lapso en s, m o h. No existe esperar hasta; para reanudar con un evento, activa un segundo flujo de trabajo con él.
httpparams.urlHace la solicitud. method, headers y body son opcionales.
commandparams.commandEjecuta un comando de shell. Su stdout es la salida de la actividad.

decide

Una actividad decide hace preguntas tipadas sobre el trabajo hecho hasta ahora y registra respuestas estructuradas por las que una condición puede enrutar.

{
  "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 }
  }
}
Tipo de preguntacriteriaRespuesta
choiceObjeto de opción a descripción, de 2 a 255 opciones.choice, confidence y probabilities.
scoreLista de 2 a 10 niveles en orden.score desde 0 (primer nivel) hacia arriba, y confidence.
noulNinguno.noul, la probabilidad de que la afirmación sea cierta.

Enruta según una respuesta con una condición, como nodes.triage.urgency.score >= 1.5. params.default da la respuesta segura para cada pregunta cuando no se puede tomar una decisión; una respuesta predeterminada tiene confianza 0. Una pregunta sin valor predeterminado no recibe respuesta, así que las condiciones sobre ella toman su conexión False.

Errores

on_error.retry define cuántas veces se reintenta una actividad que falló; el valor predeterminado es 1. Después del último reintento, la ejecución termina y, con el fallback predeterminado notify_owner, se le avisa al dueño. Nebo verifica los parámetros obligatorios de cada actividad tipada cuando empieza la ejecución, y rechaza una rama que apunte a una actividad desconocida.