Erstellen eines Agents in Agent Builder

In diesem Abschnitt wird beschrieben, wie Sie einen Agent in Agent Builder entwerfen.

Wichtig: Agent Builder wird voraussichtlich ab dem 14. Juni 2025 eingestellt. Bis dahin können Sie nur bereits vorhandene Agents entwerfen oder evaluieren. Wir empfehlen Ihnen, Ihre vorhandenen Agents zu migrieren und mit der Arbeit mit Agents in Studio Web zu beginnen. Weitere Einzelheiten dazu finden Sie unter Migration von Agents zu Studio Web.

Mehr zur Erstellung neuer Agents finden Sie unter Erstellen neuer Agents in Studio Web.

1. Wählen Sie in UiPath® Automation Cloud^TM in der linken Navigationsleiste Agents.
   Der Arbeitsbereich Agents wird angezeigt.
2. Wählen Sie einen Agent aus der List mit Vorschau-Agents, um Agent Builder zu öffnen.
3. Zum Arbeitsbereich „Agent“ gehören drei Registerkarten: Design, Bewertungen und Ablaufverfolgung.

   Gehen Sie über die Registerkarte Design, um die Hauptelemente Ihres Agents zu entwerfen und zu definieren. Nachdem Sie die Eingabe-/Ausgabeargumente definiert haben, können Sie in diesen Bereich in einer Vorschau Ihren Agent bei der Arbeit zusehen.

   Über die Registerkarte Bewertungen können ie Bewertungen erstellen und Ergebnisse speichern. Bewertungen messen objektiv die Ausgabe Ihres Agents und bewerten, ob sie mit Ihren Zielen übereinstimmt.

   Gehen Sie über die Registerkarte Ablaufverfolgung, um alle Zeitspuren von Design und Bewertung für den Agent zu protokollieren und darzustellen. Hier können Sie sich alle Ausführungen des Agents und die Details dazu anzeigen lassen.

4. Wählen Sie das Large Language Model, das Sie mit Ihrem Agent verwenden möchten. Modelle werden über UiPath AI Trust Layer bereitgestellt.
   1. Um Modelleinstellungen zu konfigurieren, wählen Sie das Einstellungssymbol neben dem Feld Modell. Hier können Sie die Felder Temperatur und Max. Tokens pro Antwort konfigurieren.
      • Die Temperatur bestimmt den Kreativitätsfaktor der LLM-Generierung. Sie können einen Wert zwischen 0 (präzise) und 2 (kreativ) festlegen.
      • Maximale Tokens pro Antwort bezieht sich auf die maximale Anzahl von Tokens, die mit der Antwort des Agents generiert werden können.
5. Bearbeiten Sie den Namen und die Beschreibung des Agents auf der Registerkarte Allgemein.

   Der Name und die Beschreibung des Agents müssen in einfacher Sprache Informationen zum Zweck des Agents enthalten. Die Beschreibung dient der Identifizierung des Agents in Studio.

6. Fügen Sie auf der Registerkarte Prompt einen gut strukturierten Systemprompt und einen Benutzerprompt hinzu, um Ihren Agent Anweisungen dazu zu geben, was sie tun sollen und welche Beschränkungen sie beachten sollen.
7. Wählen Sie Argumente, um auf das Fenster Argumente zuzugreifen, in dem Sie die in Ihrem Prompt verwendeten Eingabe- und Ausgabeargumente konfigurieren können.
8. Fügen Sie auf der Registerkarte Tools alle Tools hinzu, die Ihr Agent während der Ausführung verwenden kann. Dabei kann es sich um Aktivitäten des Integration Service, veröffentlichte Prozesse, auf die Sie Zugriff haben, oder andere Agents handeln.

   Jedes Tool muss eine detaillierte Beschreibung enthalten, die den Agent darüber informiert, wie und wann er dieses Tool verwenden soll.

9. Gehen Sie über die Registerkarte Kontexte, um alle erforderlichen Kontexte hinzuzufügen.

   Mithilfe von Indizes für die Kontextgrundlage kann ein Agent auf Wissensdatenbanken, zugreifen, für die eine Zugriffsberechtigung vorliegt. Dadurch lassen sich Aktionen oder Antworten des Agents in Ihren Unternehmsdaten verankern.

10. Gehen Sie über die Registerkarte Eskalationen, um einen Menschen in den Prozess einzubinden und das Gedächtnis des Agents zu aktivieren.

    Wenn Sie eine Eskalation hinzufügen, kann Ihr Agent einen Menschen einbeziehen, um die Ausgabe während der Ausführung zu überprüfen, zu genehmigen oder zu aktualisieren.

11. Geben Sie im Fenster Playground Eingaben für einen Testlauf ein und wählen Sie Ausführen.

    Sie müssen Ihren Agent testen, um sicherzustellen, dass er wie erwartet funktioniert.

12. Gehen Sie als Nächstes zur Registerkarte Bewertungen, um Ihren Agent zu überprüfen und zu messen.

    Eine Bewertung ist ein Paar zwischen einer Eingabe und einer Assertion zur Ausgabe. Damit kann Ihr Agent während eines End-to-End-Laufs bewertet werden.

13. Nach Durchführung von Bewertungen können Sie auf der Registerkarte Ablaufverfolgung alle Protokolle zur Ablaufverfolgung Ihres Agents überprüfen.
14. Nachdem Sie Ihren Agent getestet, bewertet und verfeinert haben, wählen Sie Veröffentlichen, um ihn als Prozess in Orchestrator zu veröffentlichen.
    • Wählen Sie aus, wo veröffentlicht werden soll:
      • Orchestrator-Feed für den persönlichen Arbeitsbereich – Der Prozess wird in Ihrem persönlichen Arbeitsbereich veröffentlicht und steht nur Ihnen zur Verfügung.Dies ist die Standardauswahl.
      • Orchestrator-Feed für Mandantenprozesse – Der Prozess wird im globalen Mandantenfeed veröffentlicht und ist für alle Benutzer verfügbar, die Ordnern zugewiesen sind, die den Mandantenfeed verwenden.
    • Wählen Sie eine Version aus. Wenn Sie zum ersten Mal veröffentlichen, wird automatisch beginnend mit 1.0.0 eine Version generiert und dann bei jeder erneuten Veröffentlichung automatisch erhöht.

    Wichtig: Dieser Schritt ist erforderlich, damit der Agent in der Aktivität Run Job verfügbar ist.

    Wählen Sie Exportieren, um die Definition des Agents zu sehen und als JSON-Datei zu verpacken. Sie können diesen JSON-Extrakt dann verwenden, um den Agent in eine andere Organisation zu importieren.

15. Fügen Sie schließlich Ihren Agent mithilfe der Aktivität Run Job in Studio in eine Automatisierung ein.Weitere Informationen dazu finden Sie unter Ausführen des Agents.

Ausführung des Agents

Wenn Sie Agents als Aktivitäten verwenden, können Sie sie in Workflows integrieren, um Teile größerer deterministischer Prozesse zu verwalten, mehrere Agents nacheinander arbeiten zu lassen und den Agent basierend auf Triggern ausführen zu lassen.

Um Ihren Agent in einen Workflow zu integrieren, gehen Sie wie folgt vor:

1. Veröffentlichen Sie Ihren Agent in Orchestrator.
2. In Studio können Sie mithilfe der Aktivität Run Job Ihren Agent in einen Workflow integrieren.

3. Nach jeder Änderung an Ihrem Agenten müssen Sie den aktualisierten Agenten erneut in Orchestrator veröffentlichen und den entsprechenden Prozess in Orchestrator aktualisieren.

   Die Aktivität Run Job führt immer die Version des aktuell in Orchestrator konfigurierten Agenten aus. Dadurch wird sichergestellt, dass Ihr Workflow konsequent die aktuellste Version Ihres Agents verwendet.

Weitere Informationen zu Konfiguration und Verwendung der Aktivität Run Job in Ihren Studio-Workflows finden Sie im Handbuch zu Systemaktivitäten.

Hinweis: Ab Version 25.4.2 von UiPath.System.Activities wurde die Ausführung von Agenten und anderen Aufträgen in Orchestrator unter der Aktivität Run Job konsolidiert und verbessert. Vorhandene Workflows mit der Aktivität Run Agent funktionieren weiterhin ohne Änderungen, was einen reibungslosen Übergang gewährleistet. Wenn Sie Ihren Workflows neue Funktionen zur Ausführung von Agenten hinzufügen, schlägt das System automatisch die Aktivität Run Job vor und implementiert sie, auch wenn Sie nach Run Agent suchen.