Entwerfen des Agents

Konfigurieren Sie das Verhalten, die Funktionen und die Enterprise-Systemintegrationen für einen dialogorientierten Agent in Studio Web.

Diese Seite behandelt die Konfigurationsoptionen zur Entwurfszeit für Conversational Agents im Agent Builder von Studio Web. Verwenden Sie diese Einstellungen, um das Verhalten, die Funktionen und die Integration Ihres Agents in Enterprise-Systeme zu definieren.

Erstellen eines Conversational Agent in Agent Builder

1. Gehen Sie zu studio.uipath.com.
2. Wählen Sie „Neu erstellen“ und dann „Agent“ aus.
3. Wählen Sie Konversationell aus.
4. Beschreiben Sie Ihren Agent bei Autopilot, um eine Startkonfiguration zu generieren, oder wählen Sie Neu anfangen aus.

Systemprompt

Der System-Prompt ist die Grundlage für das Verhalten Ihres Agenten.Es definiert die Persona, Ziele, Einschränkungen und Anweisungen zur Behandlung verschiedener Szenarien.

Was enthalten sein sollte.

Ein umfassender System-Prompt sollte Folgendes adressieren:

• Identität und Persona: Wer ist der Agent? Welchen Ton sollte es verwenden?
• Umfang und Grenzen: Welche Themen sollte der Agent behandeln?Was sollte abgelehnt werden?
• Richtlinien zur Toolnutzung: Wann sollte der Agent bestimmte Tools verwenden?
• Eskalationskriterien: Wann sollte der Agent Off an einen Menschen übergeben?
• Antwortformat: Wie sollte der Agent seine Antworten strukturieren?

Beispiel-Systemaufforderung

Sie sind HR-Assistant für die Contoso Corporation. Ihre Rolle besteht darin, Mitarbeitern bei Fragen zu Unternehmensrichtlinien, Leistungen und HR-Verfahren zu helfen.

Richtlinien

• Seien Sie professionell, freundlich und prägnant.
• Durchsuchen Sie immer die Wissensdatenbank, bevor Sie Richtlinienfragen beantworten.
• Zitieren Sie bestimmte Dokumente beim Verweisen auf Richtlinien.
• Wenn Sie keine Antwort finden, bieten Sie an, das Anliegen an einen HR-Mitarbeiter zu eskalieren.

Grenzen

• Diskutieren Sie nicht über die Leistung oder Vergütung einzelner Mitarbeiter
• Geben Sie keine Versprechen hinsichtlich Richtlinienausnahmen ab.
• Leiten Sie rechtliche Fragen an die Rechtsabteilung weiter.

Verwenden von Autopilot zum Generieren von Prompts

Autopilot kann Ihnen helfen, effektive Systemaufforderungen zu erstellen:

1. Beschreiben Sie im Abschnitt „Systemaufforderung“ Ihren Anwendungsfall in natürlicher Sprache.
2. Autopilot generiert eine strukturierte Aufforderung basierend auf Ihrer Beschreibung.
3. Überprüfen und optimieren Sie die generierte Aufforderung, um Ihren spezifischen Anforderungen zu entsprechen.

Tipp:

Beginnen Sie mit der generierten Aufforderung von Autopilot und iterieren Sie dann basierend auf Tests.Der Debug-Chat hilft Ihnen, Lücken in Ihrem Prompt zu identifizieren, die behoben werden müssen.

Überprüfung Ihres Agents

Bitten Sie Autopilot, Ihren Agent zu überprüfen, oder wählen Sie das Abzeichen „Agent überprüfen“ aus. Autopilot bewertet den Agent und kann die gefundenen Probleme beheben.

Weitere Informationen finden Sie unter Agent-Überprüfung.

Modellauswahl

Konversationelle Agenten unterstützen mehrere große Sprachmodelle (LLMs).Wählen Sie ein Modell aus, das auf Ihren Anforderungen an Funktionalität, Latenz und Kosten basiert.

Eine Anleitung zur Auswahl des richtigen Modells finden Sie unter Auswahl des besten Modells für Ihren Agenten.

Hinweis:

Conversational Agents sind mit von UiPath verwalteten Modellen verfügbar und unterstützen LLM-Konfigurationen, sodass Sie Ihre eigenen LLM-Abonnements verwenden können.

Eingaben

Eingaben sind benannte Variablen, die in einem dialogorientierten Agent in Data Manager definiert sind und als Vorlage für das System-Prompt- und Tool-Aufruf-Argumente verwendet werden können. Verwenden Sie Eingaben, wenn die aufrufende Oberfläche dem Agent bei jedem Schritt zusätzlichen Kontext übergeben möchte – über den bereits in dem Konversationsverlauf enthaltenen Kontext hinaus.

Wichtig:

Der Konversationsverlauf (Benutzernachrichten, Agent-Nachrichten und Ergebnisse früherer Tool-Aufrufe) wird bereits bei jeder Ausführung der jeweiligen Runde implizit an den Agent übergeben. Eingaben sollten nur für zusätzlichen Kontext definiert werden, den der Agent nicht aus der Konversation selbst ableiten kann. Beginnen Sie ohne benutzerdefinierte Eingaben und führen Sie sie ein, wenn Ihr spezifischer Anwendungsfall sie erfordert.

Wie Oberflächen Eingaben offenlegen

Die Konversationsoberfläche kann beim Starten der Konversation erste Eingabewerte festlegen und diese jederzeit während der Konversation aktualisieren.

• Vorgefertigte Oberflächen wie Instanzverwaltung und iFrame-Einbettung bieten ein Formular, in dem der Benutzer die Eingabewerte vor oder während der Konversation eingibt.
• Mit dem UiPath TypeScript SDK haben Sie direkte Kontrolle darüber, wie Eingabewerte auf Ihrer benutzerdefinierten Oberfläche festgelegt werden. Sie können beispielsweise Eingaben an den Web-UI-Status – oder jeden anderen clientseitigen Status – leiten, damit der Agent automatisch bei jedem Gesprächsschritt den neuesten Oberflächenkontext erhält.

Tools

Tools erweitern die Funktionen Ihres Agents über die Konversation hinaus. Conversational Agents unterstützen die gleichen Tools wie autonome Agents.

Unterstützte Tooltypen

Tooltyp	Beschreibung	Use case
Kontextgrundlage	Wissensdatenbankindizes durchsuchen	RAG-basierte Fragen und Antworten zu Dokumenten
Dateien analysieren	Hochgeladene Dateien mit LLM verarbeiten.	Dokumentanalyse, Formularextraktion
Integration Service-Aktivitäten	Vorgefertigte Konnektoren zu externen Systemen.	Kalender, E-Mail, CRM-Vorgänge
API-Workflows	Benutzerdefinierte API-basierte Automatisierungen	Backend-Integrationen
RPA-Workflows	Plattformübergreifende und Windows-basierte Automatisierungen.	Interaktionen mit Legacy-Systemen
Autonome Agents	Ausführung des geschachtelten Agents	Komplexe, mehrstufige Aufgaben
MCP-Server	Integrationen von Modellkontextprotokollen	Externe Tool-Ökosysteme
Clientseitige Tools	Tools, die auf der Clientoberfläche ausgeführt werden	Zugriff auf Host-App-Daten, Auslösen von UI-Aktionen
Intelligente Datenextraktion und Verarbeitung (IXP)-Modelle	Intelligent Document Processing	Extraktion von strukturierten Dokumenten

Hinzufügen von Tools

1. Wählen Sie im Agent-Designer die Option „Tool hinzufügen“ aus.
2. Wählen Sie den Tooltyp aus und konfigurieren Sie seine Parameter.
3. Geben Sie eine klare Beschreibung an, wann und wie der Agent das Tool verwenden soll.

Verwenden Sie für Workflows, die ausschließlich API-Aufrufe ausführen, API-Workflows anstelle von RPA-Workflows für eine bessere Leistung in Echtzeit-Chat-Szenarien.

Tipp:

Wenn Ihre Tools Integration Service-Connectors verwenden, können Benutzer ihre eigenen Verbindungen zur Runtime über persönliche Verbindungen auswählen. Dies ist nützlich, wenn der Agent mit den eigenen Anmeldeinformationen des Benutzers arbeiten muss, z. B. E-Mails von seinem Konto senden oder auf seinen persönlichen Kalender zugreifen.

Toolbeschreibungen

Toolbeschreibungen leiten den Agenten dabei, wann die einzelnen Tools verwendet werden sollen.Verfassen Sie Beschreibungen, die eindeutig den Status angeben:

• Was das Tool tut
• Wann es verwendet werden soll (optional)

Beispielbeschreibung des Tools

Search HR Policies: Use this tool to find information about company policies,
benefits, and HR procedures. Always use this tool before answering questions
about policies.

Tool-Leitplanken

Wenden Sie Leitplanken auf Tools an, um Runtime-Richtlinien zu erzwingen. Leitplanken können:

• Einschränken, wann ein Tool ausgeführt werden kann.
• Validieren Sie Eingaben vor der Ausführung.
• Filtern oder transformieren Sie Ausgaben.

Weitere Informationen dazu finden Sie unter Guardrails.

Bestätigungen von Tool-Aufrufen

Verwenden Sie Bestätigungen für Tool-Aufrufe für Tools, die erst ausgeführt werden sollen, wenn der Benutzer die vorgeschlagene Aktion überprüft hat. Fordern Sie beispielsweise eine Bestätigung an, bevor ein Tool ein Ereignis erstellt, eine E-Mail sendet, einen Geschäftsdatensatz aktualisiert oder eine Automatisierung mit externen Nebenwirkungen auslöst.

So fordern Sie eine Bestätigung für ein Tool an:

1. Wählen Sie im Agent-Designer das Tool aus, das Sie konfigurieren möchten.
2. Aktivieren Sie in den Einstellungen der Tool-Leitlinien die Option „Bestätigung anfordern“.
3. Speichern und veröffentlichen Sie den Agent.

Wenn ein Tool eine Bestätigung erfordert, hält der Agent vor der Ausführung des Tools inne und zeigt dem Benutzer die Eingabeparameter an, die er verwenden soll. Der Benutzer kann den Toolaufruf genehmigen, die Eingabewerte vor der Genehmigung ändern oder den Toolaufruf ablehnen.

Zur Runtime:

• Wenn der Benutzer ohne Änderungen genehmigt, wird das Tool mit den vom Agent vorgeschlagenen ursprünglichen Eingaben ausgeführt.
• Wenn der Benutzer die Eingaben ändert und genehmigt, wird das Tool mit den geänderten Eingaben ausgeführt.
• Wenn der Benutzer die Bestätigung ablehnt, wird das Tool nicht ausgeführt.

Hinweis:

Bestätigungen von Tool-Aufrufen werden pro Tool konfiguriert. Aktivieren Sie sie für Actions, bei denen eine Benutzerüberprüfung vor der Ausführung erforderlich ist, und lassen Sie sie deaktiviert für schreibgeschützte Tools oder Tools, die sicher automatisch ausgeführt werden können.

Context

Kontext verbindet den Agent mit Indizes der Kontextgrundlage und ermöglicht die erweiterte Generierung (RAG) für genaue, auf Zitaten gestützte Antworten.

Hinzufügen eines Kontexts

1. Wählen Sie Kontext hinzufügen.
2. Wählen Sie aus Ihren verfügbaren Indizes einen Index der Kontextgrundlage aus.
3. Konfigurieren Sie Suchparameter (optional).

Der Agent fragt automatisch den Index ab, wenn er für die Frage des Benutzers relevant ist, und enthält Zitate in seinen Antworten.

Weitere Informationen zum Erstellen und Verwalten von Indizes finden Sie unter Kontexte.

Dateibehandlung

Conversational Agents können Dateien im Prozess verarbeiten, die während des Chats hochgeladen wurden.Dies ermöglicht Anwendungsfälle wie Dokumentanalyse, Formularverarbeitung und Bildinterpretation.

Aktivieren von Datei-Uploads

Um die Dateianalyse zu aktivieren, fügen Sie ein Tool hinzu, das Dateien verarbeiten kann:

• Dateien analysieren: Integriertes Tool für die allgemeine Dateianalyse mit LLMs.
• Intelligente Datenextraktion und Verarbeitung (IXP)-Modelle: Für die Extraktion von strukturierten Dokumenten.

Unterstützte Dateitypen

Dateityp	Empfohlenes Tool
Bilder (GIF, JPE, JPEG, PNG, WEBP)	Dateien analysieren
PDF-Dokumente	Dateien analysieren, Intelligente Datenextraktion und Verarbeitung (IXP)

Wichtig:

Dateiuploads sind auf 5 MB begrenzt.

Eskalationen

Eskalationen ermöglichen es dem agent, Konversationen an einen Menschen zu übergeben, wenn er eine Anfrage nicht sicher lösen kann.

Wie Eskalationen funktionieren

1. Der agent bestimmt, ob er menschliche Hilfe benötigt (basierend auf Ihren System-Prompt-Kriterien).
2. Der agent erstellt eine Eskalationsaufgabe im Action Center.
3. Die Konversation wird pausiert, bis ein Mensch die Eskalation auflöst.
4. Sobald das Problem gelöst ist, fährt der Agent mit der Eingabe des Menschen fort.

Konfiguration von Eskalationen

1. Wählen Sie im Agent Designer die Option Eskalation hinzufügen aus.
2. Konfigurieren Sie den Eskalationstyp.
3. Denken Sie daran, Eskalationskriterien in Ihrem Systemprompt zu definieren.

Hinweis:

Konversationen werden während der Eskalation synchron ausgeführt. Der Agent pausiert die gesamte Interaktion, bis die Eskalation aufgelöst ist. Wenn Sie Eskalationen starten müssen, ohne den Chat zu blockieren, erstellen Sie stattdessen Ihren Chat Assistant in Maestro Flow und führen Sie einen menschlichen Knoten auf einem parallelen Zweig aus, damit die Konversation weiterläuft, während die Genehmigung im Hintergrund erfolgt.

Weitere Informationen finden Sie unter Eskalationen und Agent-Speicher.

Überlegungen zur Verbindung

Wenn Ihr Agent Tools verwendet, die auf Integration Service-Connectors basieren, sollten Sie berücksichtigen, wie Verbindungen zur Runtime verwaltet werden.

• Freigegebene Verbindungen werden von Administratoren in einem Orchestrator-Ordner konfiguriert. Freigegebene Verbindungen, die während des Designs und des Debuggings konfiguriert wurden, stellen sicher, dass der Agent nach der Veröffentlichung Zugriff auf die erforderlichen Connectors hat.
• Persönliche Verbindungen (Öffentliche Vorschau) ermöglichen es einzelnen Benutzern, ihre eigenen Integration Service-Verbindungen zur Laufzeit auszuwählen. Dies ist nützlich, wenn der Agent mit den eigenen Anmeldeinformationen eines Benutzers arbeiten muss – z. B. E-Mails von seinem Konto senden oder auf seinen persönlichen Kalender zugreifen.

Beachten Sie beim Entwerfen eines Agents, der persönliche Verbindungen unterstützt, Folgendes:

• Um persönliche Verbindungen für Benutzer zu aktivieren, muss jedes Agent-Tool eingerichtet werden, indem Sie die Anweisungen zur Einrichtung persönlicher Verbindungen befolgen.
• Die Tools des Agents müssen Connectors verwenden, die persönliche Verbindungen unterstützen (z. B. Outlook, Slack, Salesforce).
• Der Agent konfiguriert automatisch Verbindungen aus dem persönlichen Arbeitsbereich des Benutzers, wenn eine passende Verbindung verfügbar ist, wodurch die Einrichtung für die meisten Benutzer nahtlos wird.
• Wenn die automatisch konfigurierte Verbindung fehlschlägt oder keine passende Verbindung gefunden wird, wird der Benutzer aufgefordert, eine neue auszuwählen oder eine neue zu erstellen.
• Wenn für einen Connector keine persönliche Verbindung konfiguriert ist, greift der Agent auf die freigegebene Verbindung im Orchestrator-Ordner zurück.
• Persönliche Verbindungen werden bei der Verwendung externer Anwendungen nicht unterstützt. Kanäle, die sich über externe App-Token (einschließlich des UiPath TypeScript SDK) authentifizieren, können keine persönlichen Verbindungen speichern oder automatisch binden.

Weitere Informationen zum Konfigurieren von persönlichen Verbindungen zur Runtime finden Sie unter Persönliche Verbindungen.

Best Practices für den Entwurf

Beginnen Sie mit einer klaren Persona.

Definieren Sie eine bestimmte Identität für Ihren Agent, anstatt sie generisch zu lassen. Eine klare Persona hilft dem Agenten, einen konsistenten Ton und Verhalten zu wahren.

Weniger effektiv: „Sie sind ein hilfreicher Assistent.“Effektiver: „Sie sind ein freundlicher HR-Assistent für die Contoso Corporation, der darauf spezialisiert ist, Mitarbeitern zu helfen, Unternehmensrichtlinien und Vorteile zu verstehen.“

Design für Unvorhersehbarkeit

Benutzer können unvollständige, mehrdeutige oder falsche Informationen bereitstellen. Ihr System-Prompt sollte den Agent anweisen, Folgendes zu tun:

• Stellen Sie bei Bedarf Fragen zur Klärung.
• Gehen Sie sorgfältig mit unvollständigen Informationen um.
• Beheben Sie Missverständnisse.

Leiten Sie die Verwendung des Tools explizit.

Gehen Sie nicht davon aus, dass der Agent weiß, wann Tools verwendet werden sollen. Fügen Sie explizite Anweisungen ein:

## Tool usage
- ALWAYS search the knowledge base before answering policy questions
- Use the calendar tool when the user asks about scheduling
- NEVER create calendar events without explicit user confirmation

Wiederholen Sie mit Auswertungen.

Erstellen Sie Testfälle sowohl für erwartete (Erfolgsweg) als auch für unerwartete (Randfall) Szenarien.Aktualisieren Sie die Konfiguration Ihres Agent basierend auf Auswertungsergebnissen.

Nächste Schritte

• Auswertung: Testen Sie das Verhalten Ihres Agents.
• Bereitstellung: Veröffentlichen und Bereitstellung Ihres Agent.

Benötigen Sie eine erweiterte Konversationsmodellierung – Routing, Übergabe zwischen spezialisierten Agenten oder Back-End-Automatisierungen, die parallel zur Konversation ausgeführt werden? Unter In Maestro Flow erstellen erfahren Sie, wie Sie den gesamten Chat als Konversationsflow modellieren.