uip maestro flow

Commands for authoring, packing, debugging, and operating UiPath Flow graph-shaped workflow projects using the `uip maestro flow` tool.

uip maestro flow , empaqueta, depura y opera proyectos de UiPath Flow : flujos de trabajo en forma de gráfico hechos de nodos (actividades, desencadenadores, conectores) conectados por bordes. Flow es una de las dos superficies de orquestación en UiPath; consulta uip maestro para la orquestación de procesos empresariales basada en BPMN, su hermana.

The tool is shipped as part of the @uipath/maestro-tool plugin (command prefix maestro flow). See Tools (plugins) for how plugins are installed and versioned.

Cuándo utilizar Flow frente a Maestro

Superficie	Forma del gráfico	Archivo de activos	Caso de uso principal
Flujo	Gráfico visual de nodo y borde	.flow (JSON)	Flujos de trabajo agénticos, automatizaciones de conectores, encadenamiento de nodos de IA
Maestro	Diagrama BPMN 2.0	.bpmn	Orquestación de procesos empresariales de larga duración con intervención humana

Ambas herramientas publican paquetes .nupkg en Orchestrator y comparten las primitivas de tiempo de ejecución (processes, instance, incident, job, registry).

Flujo de creación

Un proyecto de Flow es un directorio con un manifiesto project.uiproj y uno o más archivos .flow (más los archivos de soporte generados en el momento del empaquetado).

# 1. Scaffold a new project
uip maestro flow init invoice-flow

# 2. Discover nodes in the registry
uip maestro flow registry pull
uip maestro flow registry search slack

# 3. Edit the .flow file — add nodes, edges, variables, bindings
uip maestro flow node add invoice-flow/invoice-flow.flow uipath.connector.slack.send-message --label "Notify"
uip maestro flow edge add invoice-flow/invoice-flow.flow start node_a1b2c3d4
uip maestro flow node configure invoice-flow/invoice-flow.flow node_a1b2c3d4 --detail '{"connectionId":"…","folderKey":"…","method":"POST","endpoint":"/…"}'

# 4. Validate structure (and optionally governance policy)
uip maestro flow validate invoice-flow/invoice-flow.flow

# 5. Run against Studio Web to smoke-test
uip maestro flow debug ./invoice-flow

# 6. Pack for deployment
uip maestro flow pack ./invoice-flow ./dist --version 1.0.0

Comandos de creación

Comando	Propósito
uip maestro flow init	Andamio de un nuevo proyecto de flujo
uip maestro flow node	Add, configure, list, and remove nodes in a .flow file
uip maestro flow edge	Add, list, and remove edges between nodes
uip maestro flow validate	Validar un archivo .flow contra el esquema (y la política de control)
uip maestro flow debug	Cargar el proyecto a Studio Web y ejecutar una sesión de depuración
uip maestro flow pack	Producir un implementable .nupkg
uip maestro flow registry	Examinar y buscar tipos de nodos disponibles (OOTB + conector)

Asistentes de variables, vinculación y diseño

Estas superficies CLI aún no están en la barra lateral, pero se pueden llamar hoy: son envoltorios delgados para editar el JSON .flow mediante programación:

• uip maestro flow variable — add / list / remove top-level workflow variables (in, out, inout). See node-edge.md.
• uip maestro flow variable-update — adjunta una expresión de asignación JS a un nodo (=js:ctx.output) que se ejecuta al finalizar.
• uip maestro flow binding — add / list / remove resource bindings (process, agent, connection, etc.) that are resolved at publish time.
• uip maestro flow format — diseño automático: reposiciona los nodos para eliminar las superposiciones.

Tiempo de ejecución

En runtime, un paquete de flujo publicado se convierte en un proceso en Orchestrator. Al iniciar uno se crea una instancia; cada intento de ejecución es un trabajo; los fallos emergen como incidentes.

Comando	Propósito
uip maestro flow process	Enumerar y ejecutar procesos de flujo implementados (list, get, run)
uip maestro flow processes	Resúmenes de procesos en todas las carpetas e incidentes por proceso
uip maestro flow instance	Inspeccionar y dirigir instancias en ejecución (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro flow incident	Leer resúmenes y detalles de incidentes
uip maestro flow job	Seguimientos de transmisión (traces) e inspección del estado del trabajo

Los trabajos y procesos en Orchestrator propiamente dicho se manipulan a través de la herramienta de Orchestrator: consulta Trabajos de Orchestrator y Procesos de Orchestrator.

Convenciones

• Cada subcomando uip maestro flow respeta las opciones globales (--output, --output-filter, --log-level, --log-file).
• La salida predeterminada es JSON.
• Los códigos de salida siguen el contrato estándar.
• La mayoría de los comandos de runtime requieren uip login primero: consulta Autenticación.

Ver también

• uip maestro — BPMN relacionado para la orquestación de procesos empresariales
• Herramientas (complementos)
• Autenticación
• Opciones globales, Códigos de salida