Docs de agentes

Automatizaciones · flows

← Todos los módulos · Conecta tu agente →

Automatizaciones · flows

Un flow es un grafo de nodos conectados: algo entra (fuente o input), se transforma (IA, código, mapeo, condiciones) y sale (diseños, entradas de calendario, reporte, HTTP). Se editan en Crear › Automatizaciones y por MCP con las mismas herramientas.

Importante en esta versión: los flows solo se disparan manualmente (botón Ejecutar o flow_run). No hay disparo por horario ni por webhook de entrada. Máximo 20 flows por espacio y unas 25 llamadas a herramientas por ejecución.

Flujos

Partir de un preset (recomendado)

1. flow_library_list() → presets (noticias RSS → IA → carrusel, vigilancia de competencia, monitor de precios…).

2. flow_library_instantiate({ presetId, name, workspaceId }) → queda como borrador.

3. flow_get({ flowId }) → mira pendingConfig: lo que falta configurar (credenciales, plantilla, URL).

4. Completa con flow_save y prueba (abajo).

Construir uno desde cero

1. flow_save({ workspaceId, name, nodes, edges, trigger: { type: "manual" } }).

2. Cada nodo: { id, type, label, config, position: { x, y } }. Tipos principales:

3. Referencias entre nodos: {{input.campo}}, {{steps.idDelNodo.campo}}, {{item.campo}} dentro de perItem.

4. Credenciales de IA o HTTP: flow_credentials_set({ name, type, secret, provider, model }) (cifradas). Sin credencial, los nodos de IA usan la llave BYOK del dueño del espacio.

Probar y depurar

1. flow_run_node({ flowId, nodeId, input }) prueba un nodo suelto, sin crear ejecución (ojo: nodos tool y template sí escriben).

2. flow_run({ flowId, input }) ejecuta el flow completo.

3. Si falla: flow_history({ flowId }) → cada paso trae error.code; corrige con flow_save y vuelve a ejecutar.

4. Para no repetir pasos caros mientras depuras: fija salidas (pins) y corre con mode: "dev"; flow_unpin las limpia.

5. Si rompiste algo: flow_versions_list → flow_rollback({ flowId, version }).

Atender pausas

Mover flows entre espacios

Herramientas

Construir

Credenciales y datos

Ejecutar y depurar

Reglas

Ejemplos

Documentación de agentes de Musaworks · actualizado 2026-11-20