- Erste Schritte
- Erstellen
- Fügen Sie einen KI-Agent zu einem Workflow hinzu
- Rufen Sie eine externe API auf
- Eingehende E-Mails verarbeiten
- Einen Slack-Benachrichtigungs-Workflow erstellen
- Eine menschliche Genehmigung zu einem Workflow hinzufügen
- Erstellen Sie einen Chat Agent-Workflow
- Fehler behandeln
- Grundlagen des Debuggens
- Human-in-the-Loop: Eskalation oder menschlicher Schritt
- Auswerten Ihrer Workflows
- Bereitstellen und ausführen
- Beispiele
- Referenz (Reference)
Ihr erster Workflow
Erstellen Sie einen Workflow für die Auftragsannahme mit zwei API-Aufrufen, einem KI-Agent, der entscheidet, und zwei Verzweigungen, testen Sie ihn dann und stellen Sie ihn bereit, mit einem Codierungsagenten oder auf der Arbeitsfläche.
In diesem Tutorial erstellen Sie den Workflow zur Auftragserfassung, der Was ist Maestro Automate? beschreibt. Für jede neue Bestellung überprüft der Workflow den Lagerbestand und die Bonität des Kunden, lässt einen KI-Agent entscheiden, ob die Bestellung angenommen wird, und erstellt dann entweder die Bestellung oder benachrichtigt einen Vertriebsmitarbeiter.
Das Tutorial dauert etwa 15 Minuten. Die Aktien- und Bonitätsprüfungen rufen dummyjson.com auf. Eine kostenlose Beispiel-API, sodass Sie kein Konto oder keinen API-Schlüssel für eine andere App benötigen. Die letzten beiden Schritte sind Skripte, die für das Customer Relationship Management (CRM) und Slack stehen, sodass der Workflow ohne Verbindungen zu diesen Apps ausgeführt wird. Der obige Screenshot zeigt Benachrichtigungen für einen Vertriebsmitarbeiter als Slack-Connector, wie es in einem echten Workflow vorkommen würde.
Sie können den Workflow auf zwei Arten erstellen. Wählen Sie eine aus und der Rest der Seite folgt Ihrer Auswahl:
- Mit einem Codierungsagenten: Beschreiben Sie den Workflow und der Agent erstellt ihn für Sie.
- Manuell auf der Arbeitsfläche: Fügen Sie jeden Knoten selbst hinzu und richten Sie ihn ein.
Bevor Sie beginnen
- Ein UiPath-Konto. Bei der Registrierung wird beschrieben, wie Sie einen erstellen.
- Ein Codierungsagent mit der UiPath CLI und den Fähigkeiten. Einrichten Ihres Codierungs-Agents in drei Schritten.
- VS Code mit der UiPath Maestro-Erweiterung, um den Workflow auf der Arbeitsfläche anzuzeigen. Bei Build in VS Code wird beschrieben, wie Sie die Installation durchführen.
- Ein UiPath-Konto. Bei der Registrierung wird beschrieben, wie Sie einen erstellen.
- VS Code, Studio Web oder Studio Desktop. Studio Web wird in Ihrem Browser ausgeführt und erfordert keine Installation. Wo erstellt werden soll, werden sie verglichen.
1. Erstellen Sie den Workflow
-
Erstellen Sie einen leeren Ordner für das Projekt und öffnen Sie ihn in VS Code.
-
Starten Sie Ihren Codierungs-Agent in diesem Ordner. Führen Sie beispielsweise für Claude Code
claudeim VS Code-Terminal aus. -
Fügen Sie diesen Prompt ein:
Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.Der Agent erstellt das Projekt, fügt die Knoten hinzu und validiert den Workflow. Dabei werden Ihnen möglicherweise Fragen gestellt. Beantworten Sie sie über die Eingabeaufforderung.
-
Wenn der Agent fertig gestellt ist, öffnen Sie die
.flowDatei aus dem Explorer. Er wird auf der Arbeitsfläche „Flow“ geöffnet. -
Überprüfen Sie das Ergebnis:
- Die Canvas entspricht dem Workflow oben auf dieser Seite.
- Kein Knoten zeigt ein Warnsymbol an und der Problembereich ist leer.
- Die untere Symbolleiste zeigt Maestro Automate an. Wenn Maestro Orchestrate angezeigt wird, wählen Sie es und dann Maestro Automate aus.
Wenn etwas nicht übereinstimmt, teilen Sie dem Agent mit, was anders ist, z. B.: „Prüfungskredit fehlt“. Fügen Sie sie zwischen Bestand prüfen und Bestellung überprüfen hinzu.
Ergebnis: Ihre Arbeitsfläche entspricht dem Workflow oben auf dieser Seite.
Erstellen Sie das Projekt
Erstellen Sie ein Maestro Automation-Projekt, wo Sie erstellen:
| Wo Sie erstellen | So wird das Projekt erstellt |
|---|---|
| VS-Code | Öffnen Sie die UiPath Maestro-Ansicht mit dem UiPath- Symbol in der Aktivitätsleiste. Wählen Sie Neu erstellen und dann Maestro Automate in der Liste Neues Projekt . |
| Studio Web | Wählen Sie den Pfeil neben Neu erstellen und dann Flow unter Maestro Automate. |
| StudioDesktop | Öffnen Sie eine Lösung. Wählen Sie im Explorer die Option Projekt hinzufügen und dann unter Zur Lösung hinzufügen die Option Maestro Automate. |
Das Projekt wird auf der Arbeitsfläche „Flow“ geöffnet, wobei sich bereits ein manueller Trigger befindet. In der unteren Symbolleiste wird Maestro Automate als Buildmodus angezeigt.
Jedes Tool bietet auch ein Projekt für Maestro Orchestrate: Maestro Orchestrate in VS Code, Flow unter Maestro Orchestrate in Studio Web und Maestro Flow in Studio Desktop. Stellen Sie sicher, dass Sie die für Maestro Automate auswählen.
Beginnen Sie mit einem Trigger
Beim Erstellen eines Workflows ist die erste Frage, die beantwortet werden muss, wie er beginnt. Ein Trigger ist der Schritt, der jede Ausführung startet. Dieser Workflow startet bei Bedarf, was die einfachste Möglichkeit ist, ihn zu testen, also verwendet er den manuellen Trigger , der sich bereits auf der Arbeitsfläche befindet.
- Doppelklicken Sie auf den Namen des manuellen Triggers und geben Sie Neue Reihenfolge ein. Sie benennen jeden Knoten auf die gleiche Weise um.
- Legen Sie auf der Registerkarte Erweitert die ID auf
newOrderfest. Ausdrücke in späteren Schritten verwenden diese ID. - Wählen Sie auf der Registerkarte Parameter zweimal die Option Eingabeargument hinzufügen aus, um die Details der Reihenfolge hinzuzufügen:
productIdvom Typ Nummer.customerIdvom Typ Zeichenfolge.
Ergebnis: Der Workflow akzeptiert bei jedem Start eine Produkt-ID und eine Kunden-ID.
Überprüfen Sie den Bestand
Die erste Frage zu einer Bestellung ist, ob das Produkt auf Lager ist. Ein HTTP-Anforderungsknoten fragt ein anderes System an, indem er dessen API aufruft, die Schnittstelle, die Apps für den Austausch von Daten verwenden.
-
Wählen Sie + am ausgehenden Handle von Neuer Auftrag aus, suchen Sie nach HTTP-Anforderung und wählen Sie diese aus.
-
Benennen Sie den Knoten Bestand prüfen um und legen Sie auf der Registerkarte Erweitert seine ID auf
checkStockfest. -
Lassen Sie auf der Registerkarte Parameter die Authentifizierung auf Manuelle Authentifizierung und auf
GETdie Methode eingestellt. -
Wechseln Sie das URL- Feld in den Ausdrucksmodus, sodass zu Beginn
=angezeigt wird, und geben Sie Folgendes ein:"https://dummyjson.com/products/" + $vars.newOrder.output.productId"https://dummyjson.com/products/" + $vars.newOrder.output.productIdDie Webadresse steht in Anführungszeichen und
$vars.newOrder.output.productIdfügt die Produkt-ID aus dem Trigger am Ende hinzu. Sie können den$vars-Teil mit { } Einfügen hinzufügen , anstatt ihn einzugeben.Wenn der Editor
productIdwährend der Eingabe vorschlägt, akzeptieren Sie den Vorschlag mitEnter, anstatt den Namen einzugeben, oder er wird zweimal eingegeben.
$vars enthält die Ausgabe früherer Knoten. Ein Ausdruck liest es als $vars.<node ID>.output. Ein Feld im Ausdrucksmodus ist JavaScript, sodass Text wie eine Webadresse in Anführungszeichen steht. Variablen und Datenfluss beschreiben, wie Daten zwischen Knoten verschoben werden.
Testen Sie, was Sie bisher haben
- Wählen Sie Debuggen ausführen (><) in der unteren Symbolleiste der Arbeitsfläche aus, geben Sie
1für ProductId undc-100für CustomerId ein und starten Sie dann die Ausführung. Starten Sie es in Studio Web mit „Speichern und debuggen“. - Erweitern Sie im Bereich unter der Arbeitsfläche auf der Registerkarte Variablen die Option Bestand prüfen. Die Ausgaben zeigen, dass
codeauf200festgelegt ist, und die Daten des Produkts inbody, einschließlichstock.
Wenn die Bestandsprüfung fehlschlägt, wählen Sie sie in der Ausführungsablaufverfolgung aus, um den Fehler anzuzeigen. Die häufigste Ursache ist ein URL-Ausdruck ohne Anführungszeichen um die Webadresse.
Ergebnis: Der Workflow liest bereits echte Daten von einer API. Sie können sie auf die gleiche Weise nach jedem Knoten, den Sie hinzufügen, erneut ausführen.
Überprüfen Sie die Bonität des Kunden
- Wählen Sie die + am ausgehenden Handle von Bestand prüfen aus, fügen Sie eine weitere HTTP-Anforderung hinzu, benennen Sie sie in Gutschrift prüfen um und legen Sie ihre ID auf
checkCreditfest. - Lassen Sie Methode auf
GETfestgelegt und geben Sie in URLhttps://dummyjson.com/users/1ein.
In diesem Tutorial ersetzt der Beispielbenutzerdatensatz den Gutschriftendatensatz des Kunden.
Lassen Sie einen Agent entscheiden
Ein Agent ist ein KI-Modell, dem Sie Anweisungen und Tools geben. Anstatt feste Regeln zu befolgen, liest es die Daten und entscheidet.
-
Wählen Sie + am ausgehenden Handle von Gutschrift überprüfen aus, öffnen Sie die Kategorie Agent und wählen Sie Autonomer Agent aus.
-
Benennen Sie den Knoten Reihenfolge überprüfen um und legen Sie seine ID auf
reviewOrderfest. -
Lassen Sie Model auf das Standardmodell festgelegt.
-
Geben Sie in Systemprompt die Anweisungen des Agents ein:
You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason.You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason. -
Geben Sie in Benutzeraufforderung
Product:ein, fügen Sie$vars.checkStock.output.bodymit { } Einfügen hinzu, geben Sie dannCustomer:ein und fügen Sie$vars.checkCredit.output.bodyauf die gleiche Weise hinzu. Jeder eingefügte Wert wird als Chip im Prompt angezeigt. -
Wählen Sie unter Ausgaben zweimal die Option Ausgabevariable hinzufügen aus:
acceptedvom Typ Boolesch.reasonvom Typ Zeichenfolge.
Ergebnis: Der Agent gibt accepted und reason zurück, was die nächsten Knoten lesen können.
Verzweigen Sie die Entscheidung
-
Wählen Sie + am ausgehenden Handle der Überprüfungsreihenfolge aus, öffnen Sie die Steuerelementkategorie und wählen Sie Entscheidung aus. Umbenennen in Akzeptiert? und legen Sie seine ID auf
acceptedfest. -
Geben Sie in der Bedingung
$vars.reviewOrder.output.acceptedein. Der Entscheidungsknoten erhält ein True- und ein False- Handle. -
Fügen Sie im True- Handle einen Skriptknoten mit dem Namen Auftrag in CRM erstellen mit der ID
createOrderInCrmhinzu und geben Sie diesen Code ein:return { orderCreated: true, productId: $vars.newOrder.output.productId };return { orderCreated: true, productId: $vars.newOrder.output.productId }; -
Fügen Sie im False- Handle einen Skriptknoten mit dem Namen Vertriebsmitarbeiter benachrichtigen mit der ID
notifySalesRephinzu und geben Sie diesen Code ein:return { notified: true, reason: $vars.reviewOrder.output.reason };return { notified: true, reason: $vars.reviewOrder.output.reason };
In einem echten Workflow wären Auftrag in CRM erstellen und Vertriebsmitarbeiter benachrichtigen Connectors, vorgefertigte Verbindungen zu Apps wie Ihrem CRM und Slack. Connector listet jeden Connector auf.
Ergebnis: Ihre Arbeitsfläche stimmt mit dem Workflow oben auf dieser Seite überein, und kein Knoten zeigt ein Warnsymbol an.
2. Testen Sie es
Testausführungen führen den Workflow auf der Arbeitsfläche mit Beispieldaten aus.
- Fragen Sie den Agent: „Debug den Workflow mit ProduktID 1 und KundenID c-100.“
- Der Agent führt den Workflow aus und meldet das Ergebnis. Jeder Knoten sollte abgeschlossen sein und die Ausführung sollte den True -Pfad zu Bestellung in CRM erstellen nehmen, da das Beispielprodukt auf Lager ist.
- Überprüfen Sie die Entscheidung des Agents im Bericht:
acceptedisttrue, mit einem kurzen Grund, z. B. „Produkt ist auf Lager und Kundendatensatz ist vorhanden.“
Um die Ausführung selbst zu sehen, wählen Sie stattdessen in der unteren Symbolleiste der Arbeitsfläche die Option Debuggen (*****) aus und führen Sie die Schritte auf der Registerkarte Manuell auf der Arbeitsfläche aus.
-
Wählen Sie in der unteren Symbolleiste der Arbeitsfläche die Option Debuggen ausführen (↑) aus. In einem Dialogfeld werden die Werte der Eingaben des Triggers abgefragt.
-
Geben Sie
1für produktID undc-100für kundenID ein und starten Sie dann die Ausführung. In Studio Web ist das Dialogfeld Konfiguration debuggen und Sie starten die Ausführung mit Speichern und Debuggen.In Studio Web werden die Werte für die nächste Ausführung gespeichert.
-
Warten Sie, bis die Ausführung abgeschlossen ist. Jeder Knoten zeigt ein grünes Häkchen an und die Ausführung nimmt den True- Pfad zu Bestellung im CRM erstellen, da das Beispielprodukt auf Lager ist.
-
Erweitern Sie in der Ausführungsablaufverfolgung die Option Überprüfungsreihenfolge und wählen Sie Agent-Ausgabe aus. Die Registerkarte Ergebnis zeigt die Entscheidung des Agents,
accepted: true, und den Grund an.
Wählen Sie Auftrag selbst überprüfen, um die Daten anzuzeigen, die der Agent erhalten hat: den vollständigen Produktdatensatz von Bestand prüfen und den Benutzerdatensatz von Gutschrift prüfen.
Wenn ein Knoten fehlschlägt, wählen Sie ihn in der Ausführungsablaufverfolgung aus, um den Fehler anzuzeigen. Debugging-Grundlagen deckt die Debug-Tools im Detail ab.
Ergebnis: Ihr Workflow wird vom Trigger bis zur Verzweigung ausgeführt und die Entscheidung des Agents ist in der Ablaufverfolgung sichtbar.
3. Bereitstellen und ausführen
Bisher wurde der Workflow nur als Test ausgeführt. Durch die Bereitstellung wird er zu einem Live-Workflow, der ohne die Arbeitsfläche ausgeführt wird. Jede Ausführung zählt auf die monatlichen Ausführungen Ihres Plans.
-
Fragen Sie den Agent:
Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.Der Agent verpackt das Projekt, stellt es bereit und startet eine Ausführung mit diesen Eingaben.
-
Wenn die Ausführung Zeit zum Fertigstellen hatte, fragen Sie: „Ist die Ausführung abgeschlossen? Teilen Sie mir den endgültigen Status mit und welche Verzweigung es genommen hat.“
Der Agent meldet, dass die Ausführung erfolgreich ist und den True -Pfad zu Auftrag in CRM erstellen genommen hat.
- Stellen Sie den Workflow bereit:
- Studio Web: Wählen Sie Bereitstellen und warten Sie, bis Bereitstellung erfolgreich war.
- VS Code oder Studio Desktop: Folgen Sie einem Workflow bereitstellen.
- Auftrag starten:
- Studio Web: Wählen Sie auf dem Erfolgsbildschirm die Option Auftrag starten aus.
- VS Code oder Studio Desktop: Wählen Sie im Orchestrator Lösungen aus, wählen Sie den Ordner aus, in dem Sie bereitgestellt haben, und wählen Sie dann Ihre Lösung aus. Wählen Sie in dem Bereich die Option Auftrag starten aus.
- Geben Sie unter Eingabe
1für ProductId undc-100für CustomerId ein und wählen Sie dann Starten aus. - Um der Ausführung zu folgen, wählen Sie den Produktstarter, das Rastersymbol oben links auf der Seite und dann Maestro.
- Wählen Sie Flow-Instanzen und dann den Namen Ihres Workflows aus.
- Wählen Sie die Ausführung aus, um jeden Schritt auf der Arbeitsfläche anzuzeigen.
Ergebnis: Ihr Workflow wird bereitgestellt und bei der ersten Ausführung wurde der Pfad True zu Auftrag in CRM erstellen verwendet.
Was Sie gelernt haben
- Trigger: Jeder Workflow beginnt mit einem Trigger und Eingabeargumente übertragen die Daten, mit denen jede Ausführung beginnt.
- HTTP-Anfragen: Ein Knoten ruft die API eines anderen Systems auf und stellt die Antwort späteren Knoten zur Verfügung.
- Ausdrücke:
$vars.<node ID>.outputliest die Ausgabe eines früheren Knotens. - Agents: Ein Agent liest Daten, entscheidet und gibt die von Ihnen definierten Ausgabevariablen zurück.
- Entscheidungen: Eine Bedingung sendet jede Ausführung über einen von zwei Pfaden.
- Tests: Eine Debug-Ausführung zeigt, was jeder Knoten erhalten und zurückgegeben hat.
- Codierungsagents: Ein Agent kann denselben Workflow aus einer Beschreibung erstellen, und Sie überprüfen ihn auf der Arbeitsfläche.
- Wird bereitgestellt: Ein bereitgestellter Workflow wird ohne die Arbeitsfläche ausgeführt und jede Ausführung wird mit seinem Status aufgelistet.
Nächste Schritte
- Bewertungen: Vergleichen Sie die Entscheidungen des Agents mit einer Reihe von Beispielaufträgen. Die Taste Zu Evaluierungen hinzufügen in einem Ablaufverfolgungseintrag ist eine schnelle Möglichkeit, um zu starten.
- Bereitstellung eines Workflows: Lassen Sie den Workflow ohne Sie ausführen.
- Connector: Ersetzen Sie die beiden Skripts durch echte Apps.
- Knotenreferenz: Jeder Knoten und wie er konfiguriert wird.
- Community: Stellen Sie Fragen und teilen Sie Workflows mit anderen Buildern.