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 | Por defecto | 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 debe conseguir el empleado. Un paso del empleado necesita intent o steps. |
steps | [] | Instrucciones ordenadas, cuando una frase no basta. |
label | ninguno | Nombre 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. |
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, 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:
| Modo | Expresión |
|---|---|
expression | El 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. |
exists | Una ruta; es verdadera cuando se resuelve en un valor verdadero. |
contains | path contains text, o texto sin más 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 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" } } | Tipo | Obligatorio | Comportamiento |
|---|---|---|
wait | params.duration | Hace 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. |
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 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 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 ordenados. | score desde 0 (primer nivel) hacia arriba, y confidence. |
noul | Ninguno. | 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.