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" }
} | Campo | Predeterminado | Significado |
|---|---|---|
id | obligatorio | Único dentro del flujo de trabajo. Se usa en connections y en las rutas de datos. |
type | custom | Un paso del empleado, o uno de condition, loop, wait, http, command, decide. |
intent | ninguno | Lo que el empleado debe lograr. Un paso del empleado necesita intent o steps. |
steps | [] | Instrucciones en orden, cuando una oración no basta. |
label | ninguno | Nombre 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. |
model | ninguno | Un id de modelo para este paso. |
params | ninguno | Parámetros de las actividades tipadas, y maxIterations para los pasos del empleado. |
min_iterations | ninguno | Mínimo de turnos del modelo antes de que el paso pueda terminar. |
token_budget | ninguno | {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:
| Modo | Expresión |
|---|---|
expression | El 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. |
exists | Una ruta; es verdadera cuando se resuelve a un valor verdadero. |
contains | path contains text, o texto simple que se compara con la salida anterior. |
regex | Un 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" } } | Tipo | Obligatorio | Comportamiento |
|---|---|---|
wait | params.duration | Hace 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. |
http | params.url | Hace la solicitud. method, headers y body son opcionales. |
command | params.command | Ejecuta 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 pregunta | criteria | Respuesta |
|---|---|---|
choice | Objeto de opción a descripción, de 2 a 255 opciones. | choice, confidence y probabilities. |
score | Lista de 2 a 10 niveles en orden. | score desde 0 (primer nivel) hacia arriba, y confidence. |
noul | Ninguno. | 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.