Erstellen eines Agents in Studio Web

In diesem Abschnitt erfahren Sie, wie Sie einen Agents in Studio Web erstellen. Um zuverlässige Agents für die Produktion zu erstellen, empfehlen wir Ihnen dringend, sich die Best Practices anzusehen .

Erkunden des Arbeitsbereichs „Agent“

Entwerfen Sie auf der Hauptarbeitsfläche von Studio Web Designer Ihren Agent und erkunden Sie über den linken und rechten Bereich die Struktur und die Ressourcen des Agents.

Erstellen des Agents

1. Gehen Sie zu studio.uipath.com.

2. Wählen Sie die Taste Neuen erstellen, dann Agent.

3. Wählen Sie den Agenttyp aus:

   • Autonom: Erstellen Sie einen Agent, der unabhängig handelt, um eine bestimmte Aufgabe zu erledigen.
   • Konversation: Erstellen Sie einen Assistenten, der mit Benutzern über Echtzeitdialogfelder interagiert.

4. Wenn Sie Ihren Agent von Grund auf neu erstellen möchten, wählen Sie Neu beginnen aus.

5. Wenn Sie Ihren Agent mit Autopilot (Vorschau) generieren möchten, beschreiben Sie den Agent, den Sie erstellen möchten, im verfügbaren Nachrichtenfeld und wählen Sie Agent generieren aus. Seien Sie so spezifisch wie möglich, damit Autopilot effizient einen Agent generieren kann.

6. Die neue Lösung öffnet sich, wobei die Designerfläche Agent angezeigt wird.

7. Bei der Konfiguration Ihres Agents können Sie zwischen zwei Designmodi wählen: der traditionellen Formularansicht und der Leinwandansicht.

   Beide Modi verwenden die gleiche zugrunde liegende Agentendefinition und bleiben vollständig synchronisiert, sodass Sie zwischen ihnen jederzeit wechseln können, ohne Daten zu verlieren.

   Verwenden Sie die Formularansicht für eine strukturierte, schrittweise Konfiguration oder wechseln Sie zur Canvas-Ansicht für ein visuelles, knotenbasiertes Layout, mit dem Sie sehen können, wie die Komponenten Ihres Agents verbunden werden und interagieren.

Konfigurieren des Agents

Bei der Konfiguration Ihres Agents können Sie zwischen zwei Designmodi wählen: der traditionellen Formularansicht und der Leinwandansicht. Beide Modi haben dieselbe zugrunde liegende Agent-Definition und bleiben vollständig synchronisiert, sodass Sie jederzeit ohne Datenverlust zwischen ihnen wechseln können.

Verwenden Sie die Formularansicht für eine strukturierte, schrittweise Konfiguration oder wechseln Sie zur Canvas-Ansicht für ein visuelles, knotenbasiertes Layout, mit dem Sie sehen können, wie die Komponenten Ihres Agents verbunden werden und interagieren.

Einen Agent mithilfe der Formularansicht erstellen (Standard)

1. Greifen Sie im Projekt-Explorer-Panel links auf die Agent-Definition, die Bewertungssätze und die Evaluatoren zu.

   Abbildung 3. Der Agent innerhalb einer Lösung

   

   1. Im Bereich Definition werden die Hauptelemente eines Agents entworfen und definiert. Die Definition enthält folgende Abschnitte: Allgemein, Tools, Kontexte und Eskalationen.
      • Im Abschnitt Allgemein können Sie die Prompts für Ihren Agent definieren.
      • Im Abschnitt Tools können Sie Runtime-Tools wie Integration Service-Connectors oder veröffentlichte Automatisierungen verbinden.
      • Über den Abschnitt Kontexte können Sie Wissensquellen mithilfe von Indizes als Kontextgrundlage verknüpfen, um Ihrem Agent Zugriff auf relevante Daten zu ermöglichen.
      • Im Abschnitt Eskalationen können Sie Human-in-the-Loop-Fallbacks einrichten und das Agentengedächtnis zur Fortführung von Interaktionen und zur besseren Abstimmung zukünftiger Eskalationen von Agents aktivieren.
   2. Im Bereich Evaluierungssätze können Sie Evaluierungen erstellen und Ergebnisse speichern. Evaluierungen messen objektiv die Ausgabe Ihres Agents und bewerten, ob sie mit Ihren Zielen übereinstimmt. Weitere Informationen dazu finden Sie unter Evaluierungen.
   3. Im Bereich Evaluierer können Sie die für Evaluierungen verwendeten Evaluierer erstellen und verwalten.

2. Wählen Sie zunächst Ihren Agent unter Projekt-Explorer aus. Klicken Sie mit der rechten Maustaste, um Umbenennen zu wählen, und geben Sie Ihrem Agent einen eindeutigen Namen. Mithilfe des Agentennamen ist der Agenten projektübergreifend identifizierbar.

3. Gehen Sie als nächstes über das rechte Menü zum Eigenschaftenbereich, um das große Sprachmodell auszuwählen, das Sie mit Ihrem Agent verwenden möchten.

   1. Wählen Sie ein Modell aus der verfügbaren Auswahlliste. Modelle werden über UiPath AI Trust Layer bereitgestellt. Weitere Einzelheiten dazu finden Sie unter Konfiguration von LLMs.
   2. Konfigurieren Sie die Temperatur und die Max. Token pro Antwortfeld.Diese Einstellungen können durch eine Automation Ops-Governance-Richtlinie gesteuert werden. Weitere Details finden Sie unter Einstellungen für Studio Web-Richtlinien.
      • Die Temperatur bestimmt den Kreativitätsfaktor der LLM-Generierung. Sie können einen Wert zwischen 0 (Präzise) und 1 (kreativ) festlegen.
      • Maximale Tokens pro Antwort bezieht sich auf die maximale Anzahl von Tokens, die mit der Antwort des Agents generiert werden können.
   3. Maximale Iterationen festlegen – Die maximale Anzahl von Argumentationsschleifen, die der Agent ausführen kann, bevor er die Aufgabe abschließen oder anhalten muss.

4. Geben Sie im Bereich Agentendefinition einen Systempromptg und einen Benutzerprompt für Ihren Agent ein. Fügen Sie einen gut strukturierten Prompt hinzu, um Ihrem Agent anzuweisen, was er tun soll, und welche Einschränkungen er befolgen soll. Weitere Informationen dazu finden Sie unter Prompts.

5. Über den Bereich Data Manager können Sie die in den Prompts verwendeten Eingabe- und Ausgabeargumente des Agents definieren.

   Abbildung 5. Eingabeargumente im Data Manager-Bereich

   

6. Wählen Sie im Abschnitt Tools die Option Tool hinzufügen aus, um beliebige Tools hinzuzufügen, die Ihr Agent während der Ausführung verwenden kann. Dabei kann es sich um Integration Service-Aktivitäten, vorhandene Agenten und veröffentlichte Automatisierungen handeln, auf die Sie Zugriff haben. Jedes Tool muss eine detaillierte Beschreibung enthalten, die den Agent darüber informiert, wie und wann er dieses Tool verwenden soll. Weitere Informationen dazu finden Sie unter Tools.

7. (Optional) Wählen Sie im Abschnitt Kontexte die Option Kontext hinzufügen, um dem Agent Zugriff auf Indizes der Kontextgrundlage zu gewähren. Wählen Sie einen vorhandenen Index, der in Ihrem Mandanten verfügbar ist, oder wählen Sie Neu erstellen, um einen neuen Index direkt in Orchestrator zu erstellen. Weitere Information dazu finden Sie unter Kontexte.

8. (Optional) Wählen Sie im Abschnitt Eskalationen die Option Eskalation hinzufügen, um einen Menschen über eine Eskalations-App in den Prozess einzubinden und das Agentengedächtnis zu aktivieren. Durch Hinzufügen einer Eskalation kann Ihr Agent einen Menschen einbeziehen, der die Ausgabe während der Ausführung überprüft, genehmigt oder aktualisiert. Weitere Informationen dazu finden Sie unter Eskalationen und Gedächtnis des Agents.

Erstellen Sie einen Agent mithilfe der Canvas-Ansicht

1. Öffnen Sie Ihr Agent-Projekt in Studio Web.

2. Wählen Sie in der oberen rechten Ecke der Canvas zur Designzeit die Option Canvas im Umschalter für den Autorenmodus aus.

   • Die Arbeitsfläche wird geöffnet und zeigt die Agent-Struktur als Knoten an.
   • Sie können jederzeit zurück zur Formularansicht wechseln. Alle Änderungen werden gespeichert und automatisch zwischen den beiden Modi übersetzt.

3. Beginnen Sie mit dem LLM-Knoten.

   • Wählen Sie es aus, um den Eigenschaftenbereich auf der rechten Seite zu öffnen. Wählen Sie dann Ihr Modell aus und konfigurieren Sie es.
     • Wählen Sie ein Modell aus der verfügbaren Auswahlliste. Modelle werden über UiPath AI Trust Layer bereitgestellt. Informationen zur Verwendung eines benutzerdefinierten Modells finden Sie unter Konfiguration von LLMs.
     • Konfigurieren Sie die Temperatur und die Max. Token pro Antwortfeld.Diese Einstellungen können durch eine Automation Ops-Governance-Richtlinie gesteuert werden. Weitere Details finden Sie unter Einstellungen für Studio Web-Richtlinien.
       • Die Temperatur bestimmt den Kreativitätsfaktor der LLM-Generierung. Sie können einen Wert zwischen 0 (Präzise) und 1 (kreativ) festlegen.
       • Maximale Tokens pro Antwort bezieht sich auf die maximale Anzahl von Tokens, die mit der Antwort des Agents generiert werden können.
     • Maximale Iterationen festlegen – Die maximale Anzahl von Argumentationsschleifen, die der Agent ausführen kann, bevor er die Aufgabe abschließen oder anhalten muss.
   • Sobald ein Modell ausgewählt wurde, wird der Knoten mit dem entsprechenden Modellfamilie-Symbol aktualisiert und die Hervorhebung verschwindet.

4. Konfigurieren Sie den Agent-Knoten.

   • Der Agent-Knoten wird standardmäßig neben dem LLM-Knoten erstellt.
   • Öffnen Sie rechts den Abschnitt Eingabeaufforderung, um Ihre System- und Benutzeraufforderungen zu definieren.Für Conversational Agents wird dieser Abschnitt vereinfacht und nur die Systemaufforderung angezeigt.
   • Öffnen Sie den Abschnitt Schema auf der linken Seite, um Eingabe- und Ausgabeargumente im Data Manager-Panel zu definieren.

5. Fügen Sie Kontext, Tools und Eskalationen hinzu. Nach Fertigstellung der LLM- und Agent-Knoten werden drei neue Knotentypen verfügbar:

   • Kontext: Wählen Sie einen Index für die Kontextgrundlage aus und passen Sie seine Suchparameter an.
   • Tools: Öffnen Sie die Befehlspalette, suchen Sie nach einem bereitgestellten Tool und fügen Sie es zu Ihrer Canvas hinzu. Sie können jedes Tool weiter konfigurieren, sobald es hinzugefügt wurden.
   • Eskalationen: Fügen Sie einen Human-in-the-Loop-Knoten hinzu, der sich mit der vorhandenen Eskalationskonfiguration verbindet.

6. Greifen Sie auf zusätzliche Optionen zu, indem Sie das Menü ⋮ (Weitere Aktionen) auf einem Toolknoten auswählen. Die folgenden Aktionen sind verfügbar:

   • Haltepunkt hinzufügen – Fügt einen Haltepunkt am Toolknoten ein. Wenn der Agent debuggt ist, wird die Ausführung kurz vor der Ausführung dieses Tools pausiert, sodass Sie seine Eingaben, Ausgaben und Trace-Daten überprüfen können. Haltepunkte sind hilfreich bei der Überprüfung der Toollogik und beim Debuggen von Fehlern während der Tests in der Entwurfsphase.

   • Leitplanke hinzufügen – Öffnet das Konfigurationsfenster der Leitplanke, in dem Sie Regeln definieren können, die die Verwendung des Tools zur runtime einschränken oder überwachen.

   • Deaktivieren – Deaktiviert den ausgewählten Tool-Knoten vorübergehend für die Agent-Ausführung. Deaktivierte Tools verbleiben auf der Arbeitsfläche, werden jedoch während der runtime und des Debugging übersprungen, sodass Sie das Verhalten des Agents testen oder optimieren können, ohne das Tool dauerhaft zu entfernen.

     

7. Debuggen Sie Ihren Agent.

   • Wählen Sie Debug aus, um Ihren Agent in der Entwurfsphase auszuführen.
   • Während der Agent ausgeführt wird, schalten sich Knoten nacheinander auf, um den Ablauf der Ausführung anzuzeigen.
   • Wenn Sie Simulationen ausführen, werden Knoten in einer anderen Farbe angezeigt, um Pseudo-Daten oder Toolaufrufe anzuzeigen.
   • Für Konversations-Agents ermöglicht ein persistentes Chatfenster das Testen des Austauschs; Jede Meldung löst einen Debuglauf aus, der Hervorhebungen für die verbundenen Knoten anzeigt.
   • Sie können auch Haltepunkte auf bestimmten Knoten festlegen, um die Ausführung zu unterbrechen und Eingaben, Ausgaben sowie Ablaufverfolgungsdaten zu überprüfen.

8. Speichern und veröffentlichen Sie Ihre Änderungen.

   • Alle Aktualisierungen in der Canvas-Ansicht werden automatisch gespeichert und bleiben mit der Formularansicht synchronisiert.
   • Wenn Sie bereit sind, veröffentlichen Sie den Agent, um ihn für Tests und Bereitstellung verfügbar zu machen.

Testen des Agents

Jetzt ist es an der Zeit, Ihren Agent zu testen und zu sehen, wie Sie ihn verbessern können.

1. Navigieren Sie zur Symbolleiste über dem Studio Web-Designer.
2. Wählen Sie den Pfeil neben der Debugging-Umgebung und dann Debug-Konfiguration aus.
3. Bestätigen Sie im Fenster Debug-Konfiguration die in der Lösung verwendeten Ressourcen und die Beispieleingabe.
4. Wählen Sie Speichern und Ausführen.

Evaluierung des Agents

Gehen Sie als Nächstes zu den Bereichen Evaluierungssätze und Evaluierer, um Ihren Agent zu überprüfen und zu messen.

1. Benennen Sie im Panel „Evaluierungssätze“ den Standardauswertungssatz um und fügen Sie Testfälle mit erwarteten Ergebnissen hinzu.
2. Fügen Sie im Bereich Evaluierer Evaluierer hinzu, um die Ausgabe des Agents zu validieren.

Jede Evaluierung verknüpft eine bekannte Eingabe mit einer Feststellung zur Ausgabe.

Berechnung der Punktzahl des Agents [Vorschau]

Wählen Sie im rechten Bereich die Option Health Score öffnen, um die Punktzahl für den Agent berechnen zu lassen. Weitere Informationen zur Berechnung finden Sie unter Agent Score.

Verbesserung Ihres Agent mithilfe von Autopilot [Vorschau]

Wählen Sie im rechten Bereich Autopilot öffnen, um Vorschläge zur Verbesserung von Prompts, Tools und anderen Komponenten zu erhalten. Solche Verbesserungen unterstützen einen höheren Agent Score und sorgen dafür, dass Ihr Agent bereit für die Bereitstellung ist.

Veröffentlichung und Bereitstellung des Agents

Nachdem Sie Ihren Agent getestet, bewertet und verfeinert haben, ist es an der Zeit, ihn zu veröffentlichen. Dieser Schritt ist erforderlich, damit der Agent in der Aktivität Run Job verfügbar ist.

1. Wählen Sie Veröffentlichen, um den Agent als Prozess in Orchestrator zu veröffentlichen. Wählen Sie den Ort der Veröffentlichung:
   1. Orchestrator-Feed des persönlichen Arbeitsbereichs – Der Prozess wird in Ihrem persönlichen Arbeitsbereich veröffentlicht und steht nur Ihnen zur Verfügung. Dies ist die Standardauswahl.
   2. Orchestratorfeed mit Mandantenprozesse – Der Prozess wird im globalen Mandantenfeed veröffentlicht und ist für alle Benutzer in zugelassenen Ordnern verfügbar.
2. 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.
3. Optional können Sie Als Vorlage einreichen wählen, um den Agent als Vorlage in Ihrem Unternehmen verfügbar zu machen, oderFreigeben, um ihn für Benutzer in Ihrem Unternehmen freizugeben.

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.