Verwenden von Agents in Maestro

So funktionieren Agents in Maestro

Agents werden in BPMN-Workflows von Maestro als Serviceaufgaben dargestellt. Wenn Ihr Prozess eine Serviceaufgabe aufruft, ruft Maestro den entsprechenden Agenten mit den erforderlichen Eingabeparametern für die spezifische Prozessinstanz auf.

Agents geben Ausgabedaten an Maestro zurück, die zur Bestimmung der nächsten Schritte im Workflow verwendet werden. Sie können Agents so konfigurieren, dass sie die verwendeten Tools, getroffenen Entscheidungen und Protokolldaten melden, um Debugging und Transparenz zu unterstützen.

Agents können:

• Direkt in der UiPath-Plattform erstellt werden (Low-Code oder programmiert)
• Über externe APIs oder den Integration Service verbunden werden
• Durch Ereignisse oder Signale basierend auf der Workflowlogik ausgelöst werden

Sehen Sie sich ein Beispiel aus der Praxis an: UiPath Maestro: Die treibende Kraft hinter der nahtlosen und transparenten Automatisierung der Bearbeitung von Krediten.

Verbinden von Agents über Integration Service

UiPath Integration Service stellt vorgefertigte und benutzerdefinierte Connectors zur Integration externer Systeme in Ihren Automatisierungen bereit:

• Vorgefertigte Connectors für Dienste wie Salesforce, Microsoft 365 und Google Workspace
• Benutzerdefinierter Connector-Builder zur Bereitstellung einer REST-API für die UiPath-Plattform
• Einheitliche Verwaltung von Zugangsdaten und Verbindungen

Mithilfe des Integration Service können Sie Maestro das Senden und Empfangen von Daten von Agents oder Systemen erlauben, die nicht nativ in UiPath gehostet werden. Weitere Informationen zu Integration Service.

Mithilfe externer Agents

Maestro ist herstellerneutral. Sie können die Arbeit über Ihre bevorzugten externen KI-Agents hinweg orchestrieren – ohne Ihre Prozesse neu zu erstellen –, indem Sie UiPath Integration Service-Connectors verwenden.

Sie können Folgendes orchestrieren:

• Proprietäre KI-Dienste
• Externe Entscheidungsengines
• Microservices oder Bots, die auf anderen Plattformen gehostet werden

Maestro ruft diese Agents auf, indem es REST-Endpunkte aufruft und eine Antwortnutzlast mit strukturierten Daten erwartet.

Verbinden von externen Agents über Integration Service

Fügen Sie in der Entwurfsphase eine Serviceaufgabe hinzu, wählen Sie Starten und auf externen Agent warten aus und konfigurieren Sie die Agentaktivität über den ausgewählten Connector. Zur Runtime sendet Maestro den Prompt und den Kontext an den Agent und wartet auf die Antwort. Sie ordnen diese Antwort Variablen zu, um Gateways, Zuweisungen und nachfolgende Aktionen zu steuern.

Die folgenden Links zeigen, wie Sie eine Verbindung mit einem externen Agent herstellen, ihn über einen Maestro-Prozess ausführen und seine Ausgabe für Routing und Entscheidungen erfassen:

• Snowflake Cortex-Agents
• Databricks-Agents
• Azure AI Foundry-Agents
• Starten des CrewAI-Agents (Vorschau)
• Google Vertex-Agent ausführen

Schnellstart: API-Workflow-Integrationen

Verwenden Sie nach Möglichkeit Integration Service-Connectors, wenn diese vorhanden sind. Verwenden Sie API-Workflows, wenn Sie eine Verbindung auf API-Ebene benötigen (frühe APIs, sich ändernde Schemas oder Streaming-Antworten). Definieren Sie Anforderungen und Ausgaben deklarativ, parsen Sie JSON ohne benutzerdefinierten Code und übergeben Sie die Ergebnisse an Ihren Maestro-Prozess.

When to use which

• Connector: Unterstütztes System, stabiles Schema, verwaltete Authentifizierung, langfristig die beste Wahl.
• API-Workflow: Neue oder nicht unterstützte API, sich ändernde Antwortstrukturen oder nur Streaming-Unterstützung.

Schritt-für-Schritt-Anleitungen

• Snowflake Cortex – API-Workflow: Verarbeiten Sie die Streaming-Ausgabe des Cortex-Agents, fassen Sie sie zu einer verwendbaren Antwort zusammen und geben Sie strukturiertes JSON für die nachgelagerte Automatisierung zurück.
• Databricks Genie – API-Workflow: Starten Sie eine Unterhaltung, prüfen Sie den Nachrichtenstatus, bis er Abgeschlossen ist, extrahieren Sie das generierte SQL (attachment_id), führen Sie es aus und geben Sie die Antwort zurück.

Konfiguration von Agenteneigenschaften

In Maestro werden Agents wie Teilnehmer an einem Geschäftsprozess behandelt. In einem BPMN-Workflow werden Agents als Serviceaufgaben dargestellt, die sowohl von UiPath gehostete als auch externe Agents aufrufen können. Jede Agentenaufgabe ist mit bestimmten Eingabe- und Ausgabeparametern konfigurierbar, sodass Maestro kontextbezogene Daten an den Agent weiterleiten und im Gegenzug strukturierte Ergebnisse erhalten kann.

Einen Überblick über Serviceaufgaben in Maestro finden Sie unter Aufgaben in der BPMN-Modellierung.

Ausführungsmodi von Agents

Das Verhalten von Agents wird im Eigenschaftenbereich einer Serviceaufgabe definiert. Sie können die Aufgabe je nach Anforderung so konfigurieren, dass sie einen UiPath-Agent oder einen externen Agent aufruft.

Starten und auf Agent warten

Über diese Option können Sie einen in Ihrem UiPath-Mandanten bereitgestellten Agent aufrufen. Dazu gehören:

• Low-Code-Agents, die mit Tools wie Agent Builder erstellt wurden.
• Codierte Agents, die mit Python oder anderen Sprachen entwickelt und in Orchestrator bereitgestellt wurden.

Während der Runtime sendet Maestro Eingabeparameter im JSON-Format an den Agent. Wenn der Agent die Ausführung abschließt, gibt er eine Antwort mit den vom Prozess erwarteten Ausgabewerten zurück.

Starten und auf externen Agenten warten

Über diese Option könne Sie eine Verbindung zu externen Anbietern oder Systemen herstellen. Sie müssen Folgendes angeben:

• Connector: Das Integrationsziel (z. B. CrewAI, Salesforce oder ein anderer Dienst)

• Verbindung: Eine konfigurierte Instanz des Connectors, die entweder einen bestimmten Agent oder kontextspezifische Zugangsdaten darstellt.

  Hinweis:

  Sie können denselben Agent mit unterschiedlichen Berechtigungen oder Verhaltensweisen verwenden, indem Sie mehrere Verbindungen definieren.

  

Eingaben und Ausgaben

Eingaben und Ausgaben für Agents werden auf die gleiche Weise konfiguriert wie andere Maestro-Aufgabentypen.

• Eingaben: Variablen oder Ausdrücke, die zur Runtime an den Agent übergeben werden.
• Ausgaben: Variablen, die anhand der JSON-Antwort des Agents ausgefüllt werden.

Maestro sendet Eingabeparameter als JSON-Payload im Format:

{
  "key1": "value1",
  "key2": "value2"
}

Der Agent muss eine JSON-Antwort mit den von Maestro erwarteten Parameternamen zurückgeben. Diese Werte werden über den Abschnitt Ausgabe > Antwort im Eigenschaftenbereich der Aufgabe den Verarbeitungsvariablen zugeordnet.

Beispiele für Eingaben und Ausgaben

Beispiele für Eingaben (von Maestro an den Agent):

Parameter	Beschreibung
role	Rolle oder Kontext für die Aufgabe (z. B. Validierung vs. Zusammenfassung)
prompt	Anweisung, die dem Agent bereitgestellt wurde, häufig mit prozessspezifischen Daten.
tools	Liste der Tools, die der Agent zur Aufgabenbearbeitung nutzen darf.
user_id	Eindeutige Kennung, die zwischen dem Prozess und dem Agentenkontext geteilt wird

Beispielaufforderung:"Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

Beispiele für Ausgaben (vom Agent an Maestro)

Parameter	Beschreibung
conversation_id	Verweis auf die Dialog- oder Interaktionssitzung
loan_application_status	Vom Agent zurückgegebenes Statusergebnis
tokens_used	Metadaten zur Ressourcennutzung

Warnung:

Um die Agentenausgabe in Ihrem Workflow zu verwenden, müssen Sie jeden Ausgabeparameter einer Prozessvariablen in der Konfiguration Ausgabe > Antwort der Aufgabe zuweisen.