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 erstellt, verpackt, debuggt und verwaltet UiPath Flow- Projekte – diagrammbasierte Workflows, die aus Knoten (Aktivitäten, Trigger, Connectors) bestehen, die durch Kanten verbunden sind. Flow ist eine von zwei Orchestrierungsoberflächen in UiPath. siehe uip maestro für BPMN-basierte Geschäftsprozessorchestrierung, ihr gleichgeordnetes Element.

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.

Wann Flow oder Maestro verwendet werden sollte

Oberfläche	Diagrammform	Asset-Datei	Primärer Einsatz
Flow	Visuelles Knoten-und-Edge-Diagramm	.flow (JSON)	Agentische Workflows, Connector-Automatisierungen, Verkettung von KI-Knoten
Maestro	BPMN 2.0-Diagramm	.bpmn	Langlaufende, Human-in-the-Loop-Orchestrierung von Geschäftsprozessen

Beide Tools veröffentlichen .nupkg Pakete in Orchestrator und teilen die Runtime / runtime-Elemente (processes, instance, incident, job, registry).

Erstellungsflow

Ein Flow-Projekt ist ein Verzeichnis mit einem project.uiproj -Manifest und einer oder mehreren .flow -Dateien (plus unterstützende Dateien, die zur Packzeit generiert werden).

# 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

Erstellen von Befehlen

Befehl	Zweck
uip maestro flow init	Erstellen Sie ein Gerüst für ein neues Flow-Projekt
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	Validieren Sie eine .flow -Datei anhand des Schemas (und der Governance-Richtlinie)
uip maestro flow debug	Laden Sie das Projekt in Studio Web hoch und führen Sie eine Debug-Sitzung aus
uip maestro flow pack	Sie können ein bereitstellbares erstellen .nupkg
uip maestro flow registry	Durchsuchen und Suchen verfügbarer Knotentypen (OOTB + Connector)

Variablen, Bindungs- und Layout-Assistenten

Diese CLI-Oberflächen befinden sich noch nicht in der Seitenleiste, können aber heute aufgerufen werden – sie sind Thin-Wrapper für die programmgesteuerte Bearbeitung der .flow -JSON:

• uip maestro flow variable — add / list / remove top-level workflow variables (in, out, inout). See node-edge.md.
• uip maestro flow variable-update – Fügen Sie einen JS-Zuweisungsausdruck an einen Knoten (=js:ctx.output) an, der nach Abschluss ausgeführt wird.
• uip maestro flow binding — add / list / remove resource bindings (process, agent, connection, etc.) that are resolved at publish time.
• uip maestro flow format – Automatisches Layout: Positionieren Sie Knoten neu, um Überlappungen zu entfernen.

Laufzeit

Zur Runtime wird ein veröffentlichtes Flow-Paket zu einem Prozess in Orchestrator. Beim Starten von eins wird eine Instanz erstellt; Jeder Ausführungsversuch ist ein Auftrag; Fehler als Vorfälle auftreten.

Befehl	Zweck
uip maestro flow process	Bereitgestellte Flow-Prozesse auflisten und ausführen (list, get, run)
uip maestro flow processes	Ordnerübergreifende Prozesszusammenfassungen und Vorfälle pro Prozess
uip maestro flow instance	Überprüfen und steuern Sie die laufenden Instanzen (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro flow incident	Lesen Sie Zusammenfassungen und Details der Vorfälle
uip maestro flow job	Streamen Sie die Ablaufverfolgung (traces) und überprüfen Sie den Auftragsstatus

Aufträge und Prozesse im eigentlichen Orchestrator werden über das Orchestrator-Tool bearbeitet – siehe Orchestrator-Aufträge und Orchestrator-Prozesse.

Konventionen

• Jeder uip maestro flow -Unterbefehl berücksichtigt die globalen Optionen (--output, --output-filter, --log-level, --log-file).
• Die Standardausgabe ist JSON.
• Austrittscodes folgen dem Standardvertrag.
• Die meisten Runtime-Befehle erfordern zuerst uip login – siehe Authentifizierung.

Siehe auch

• uip maestro – neben BPMN für die Orchestrierung von Geschäftsprozessen
• Tools (Plugins)
• Authentication
• Globale Optionen, Beendigungscodes