NeboAI
NeboAI
Empezar

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" }
}
CampoPor defectoSignificado
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 debe conseguir el empleado. Un paso del empleado necesita intent o steps.
steps[]Instrucciones ordenadas, cuando una frase no basta.
labelningunoNombre que se muestra al propietario.
skills[]Skills que se deben usar. Las skills de la tienda indicadas aquí se instalan con el empleado.
tools[]Si 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 plugins 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, después, la alternativa. Cualquier fallo tras 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 le 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 está siempre disponible para terminar la ejecución.

El contexto de datos

Las actividades tipadas leen valores por ruta con puntos desde un único 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 bucle. Una ruta sin prefijo se busca en inputs y después en nodes.

condition

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

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

ModoExpresión
expressionEl modo por defecto. path op value con ==, !=, >=, <=, > o <, comparados como números cuando ambos lados son números; o una ruta sin más, verdadera cuando su valor es verdadero.
existsUna ruta; es verdadera cuando se resuelve en un valor verdadero.
containspath contains text, o texto sin más 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 etiquetada Each item lleva al cuerpo, que se ejecuta una vez por elemento con item definido; la etiquetada Done se ejecuta después de todos los elementos. Las iteraciones empiezan a la vez 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 de un intervalo en s, m o h. No existe un «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 plantea preguntas tipadas sobre el trabajo hecho hasta el momento y registra respuestas estructuradas que una condición puede usar para 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 ordenados.score desde 0 (primer nivel) hacia arriba, y confidence.
noulNinguno.noul, la probabilidad de que la afirmación se cumpla.

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 por defecto tiene confianza 0. Una pregunta sin valor por defecto 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 falla; el valor por defecto es 1. Tras el último reintento la ejecución termina y, con el fallback por defecto, notify_owner, se avisa al propietario. Nebo comprueba los parámetros obligatorios de cada actividad tipada cuando empieza la ejecución y rechaza una rama que apunte a una actividad desconocida.