Flujo de UIP

uip 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.

La herramienta se envía como complemento @uipath/flow-tool (prefijo de comando flow). Consulta Herramientas (complementos) para saber cómo se instalan y versionan los complementos.

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 flow init invoice-flow

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

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

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

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

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

Comandos de creación

Comando	Propósito
uip flow init	Andamio de un nuevo proyecto de flujo
uip flow node	Añadir, configurar, enumerar y eliminar nodos en un archivo .flow
uip flow edge	Añadir, enumerar y eliminar bordes entre nodos
uip flow validate	Validar un archivo .flow contra el esquema (y la política de control)
uip flow debug	Cargar el proyecto a Studio Web y ejecutar una sesión de depuración
uip flow pack	Producir un implementable .nupkg
uip 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 flow variable — añadir/enumerar/eliminar variables de flujo de trabajo de nivel superior (in, out, inout). Consulta node-edge.md.
• uip flow variable-update — adjunta una expresión de asignación JS a un nodo (=js:ctx.output) que se ejecuta al finalizar.
• uip flow binding — añadir/enumerar/eliminar enlaces de recursos (proceso, agente, conexión, etc.) que se resuelven en el momento de la publicación.
• uip flow tidy — 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 flow process	Enumerar y ejecutar procesos de flujo implementados (list, get, run)
uip flow processes	Resúmenes de procesos en todas las carpetas e incidentes por proceso
uip flow instances	Inspeccionar y dirigir instancias en ejecución (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip flow incidents	Leer resúmenes y detalles de incidentes
uip 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 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