uip Maestro Flow

Befehle zum Erstellen, Packen, Debuggen und Betreiben von Workflow-Projekten in Form eines UiPath Flow-Diagramms mit dem Tool „uip Maestro Flow“.

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.

Das Tool wird als Teil des Plugins @uipath/maestro-tool (Befehlspräfix maestro flow) ausgeliefert. Unter Tools (Plugins) erfahren Sie, wie Plugins installiert und versioniert werden.

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	Hinzufügen, Konfigurieren, Auflisten und Entfernen von Knoten in einer .flow -Datei
uip maestro flow edge	Fügen Sie Kanten zwischen Knoten hinzu, listen Sie sie auf und entfernen Sie sie
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 debug-instance	Steuerung der schrittweisen Debugging-Sitzung auf niedrigerer Ebene (Erstellen/Status/Haltepunkte/Fortsetzen)
uip maestro flow eval	Verwalten Sie Auswerter/Auswertungssätze/Datenpunkte und führen Sie sie in Studio Web aus
uip maestro flow hitl	Fügen Sie einen Human-in-the-Loop-Knoten zu einer .flow -Datei hinzu
uip maestro flow migrate	Aktualisieren Sie eine .flow -Datei auf die aktuelle Schemaversion
uip maestro flow pack	Sie können ein bereitstellbares erstellen .nupkg
uip maestro flow publish	Packen und Hochladen direkt in Orchestrator-Pakete
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 – Hinzufügen/Auflisten/Entfernen von Workflow-Variablen auf oberster Ebene (in, out, inout). Siehe Node-Edge.md.
• uip maestro flow binding – Hinzufügen/Auflisten/Entfernen von Ressourcenbindungen (Prozess, Agent, Verbindung usw.), die zum Zeitpunkt der Veröffentlichung aufgelöst werden.
• 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