UiPath Documentation
maestro
latest
false
Benutzerhandbuch zu Maestro
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Orchestrieren Sie einen KI-Agent

Erstellen Sie einen autonomen Agent auf der Arbeitsfläche, übergeben Sie Daten an ihn und leiten Sie die Workflowausführung basierend auf der Entscheidung des Agents weiter.

Was Sie erstellen: Ein Flow, der einen KI-Agent aufruft, den Sie auf der Arbeitsfläche erstellt haben, Daten an ihn weiterleitet und die Ausführung basierend auf der Antwort des Agents weiterleitet (genehmigt, abgelehnt oder fehlgeschlagen). Dies ist die Grundlage für jede Automatisierung mit Agenten: eine argumentbasierte Entscheidung, die in einen größeren automatisierten Prozess eingebettet ist.

Der Agent, den Sie hier erstellen, ist ein autonomer Agent: dessen Modell, Prompts, Tools und Kontext sind alle live auf dem Knoten und bewegen sich mit dem Fluss. Um einen Agent wiederzuverwenden, der bereits in Ihrer Organisation veröffentlicht wurde, anstatt einen inline zu erstellen, verwenden Sie stattdessen den BPMN-Prozessknoten .

Was Sie benötigen

  • Ein UiPath Automation Cloud-Konto mit Zugriff auf Maestro Flow.
  • Ein verfügbares LLM-Modell, das der Agent verwenden kann.

Verwendete Knoten

  • Manueller Trigger: Startet den Flow bei Bedarf, während Sie erstellen
  • Agent: Ein KI-Agent, den Sie auf der Arbeitsfläche erstellen, gibt seine Ausgabe zurück
  • Entscheidung: Verzweigt die Ausführung basierend auf der Antwort des Agenten
  • Beenden: Beendet den Fluss auf einem Fehlerpfad

Schritte

1. Erstellen Sie einen neuen Flow und fügen Sie einen Trigger hinzu

  1. Öffnen Sie MaestroFlow und wählen Sie Neuer Flow aus.
  2. Ziehen Sie einen Manual Trigger- Knoten auf die Arbeitsfläche.

Bei einem Produktionsflow ersetzen Sie dies durch einen geplanten oder Integrationstrigger. Ein manueller Trigger reicht während des Erstellens aus.

2. Fügen Sie einen Agent-Knoten hinzu

Die Palettenbezeichnung des Agents ist Autonomous Agent.

  1. Ziehen Sie einen Agent -Knoten aus dem Abschnitt UiPath-Knoten des Knotenbereichs auf die Arbeitsfläche.
  2. Verbinden Sie es mit dem manuellen Trigger.
  3. Erstellen Sie im Eigenschaftenbereich den Agent:
    • Legen Sie das Modell fest oder lassen Sie es auf dem Standard-Agent-Modell Ihrer Organisation.
    • Schreiben Sie den Systemprompt, die Rolle des Agents und die ständigen Anweisungen. Das Modell, der Systemprompt und der Benutzerprompt sind alle erforderlich.
    • Schreiben Sie den Benutzerprompt, die Aufgabe für diese Ausführung. Referenzieren Sie Flussdaten mit Ausdrücken; Zum Beispiel der zu klassifizierende Dokumenttext: $vars.start.output.documentText.

3. Geben Sie ein strukturiertes Ergebnis zurück

Standardmäßig gibt der Agent ein Feld zurück, content, das seinen Antworttext enthält. Für eine saubere Verzweigung lassen Sie den Agent stattdessen ein strukturiertes Feld zurückgeben.

  1. Öffnen Sie die Registerkarte Variablen im Eigenschaftenbereich des Agents.
  2. Fügen Sie eine Ausgabevariable namens decision mit dem Typ string hinzu.
  3. Weisen Sie den Agent im Systemprompt an, decision auf approved oder rejected festzulegen.

4. Verarbeiten Sie die Antwort des Agenten

  1. Ziehen Sie einen Entscheidungsknoten auf die Arbeitsfläche und verbinden Sie ihn mit dem Agent-Knoten.
  2. Legen Sie die Bedingung fest, um die Ausgabe des Agents auszuwerten, z. B.: $vars.agent1.output.decision === "approved".
  3. Verbinden Sie die Verzweigung True mit dem nächsten Schritt in Ihrer Automatisierung (z. B. eine Benachrichtigung oder Datenschreibung).
  4. Verbinden Sie die False- Verzweigung mit einem Terminate -Knoten.
  5. Legen Sie den Status Beenden auf Failed fest und fügen Sie eine Meldung wie Agent returned: $vars.agent1.output.decision hinzu.

5. Debug den Flow

Wählen Sie in der Symbolleiste die Option Debuggen . In der Ausführungsablaufverfolgung:

  • Wählen Sie den Agent- Knoten, um zu überprüfen, welche Eingaben gesendet wurden und was der Agent zurückgegeben hat.
  • Bestätigen Sie, dass der Entscheidungsknoten anhand der Ausgabe des Agents die richtige Verzweigung genommen hat.
  • Wenn die Antwort des Agents nicht das ist, was Sie erwartet haben, überprüfen Sie den Systemprompt, den Benutzerprompt und die deklarierte Ausgabe, bevor Sie die getrennte Flusslogik ändern.

Um beide Zweige zu trainieren, ohne auf echte Antworten des Agents zu warten, aktivieren Sie die Pseudo-Ausgabe auf dem Agent-Knoten und legen Sie eine feste Antwort fest.

Ergebnis

Ihr Flow wird durchgängig ausgeführt: Der Manual Trigger startet die Ausführung, der Agent-Knoten argumentiert über die Eingabe und gibt ein strukturiertes decision -Feld zurück, der Entscheidungsknoten verzweigt sich auf dem Wert und der Beendenknoten beendet den Flow auf dem abgelehnten Pfad . Sie können die Eingaben und Ausgaben des Agents in der Execution Trace überprüfen und die Prompts direkt auf dem Knoten anpassen.

Erweitern Sie diesen Flow

  • Geben Sie den Agent-Tools: Verbinden Sie Toolressourcen (integrierte Tools, Connector-Tools, RPA- oder API-Workflow-Tools, Dokumentextraktion oder MCP-Server (Model Context Protocol)) mit dem Tools -Handle des Agents, damit er handeln kann – nicht nur der Grund.
  • Verankern Sie den Agent in Ihren Daten: Verbinden Sie eine Kontextressource mit dem Kontext -Handle des Agents, damit er aus einer indizierten Wissensquelle anstelle des Modells antwortet.
  • Einen Menschen in den Prozess einbinden: Verbinden Sie das Eskalations- Handle des Agents mit einer Eskalationsressource für Fälle, die der Agent nicht allein entscheiden sollte.
  • Eine Schleife hinzufügen: Umschließen Sie den Aufruf des Agents in einen Schleifenknoten , um eine Liste von Elementen mit demselben Agent zu verarbeiten.
  • Mit einem anderen System verketten: Fügen Sie nach der True-Verzweigung des Entscheidungsknotens einen HTTP-Anforderungs- oder Integrationsknoten hinzu, um das Ergebnis in ein externes System zu schreiben.

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben