- Erste Schritte
- UiPath Agents in Studio Web
- Über UiPath Agents
- Lizenzierung
- Ausführung von Agents
- Agents und Workflows
- Bewährte Verfahren zum Erstellen von Agents
- Auswahl des besten Modells für Ihren Agenten
- Best Practices für das Veröffentlichen und Bereitstellen von Agents
- Bewährte Verfahren für Kontext-Engineering
- Best Practices für DeepRAG und Batch-Transformation: JIT vs. indexbasierte Strategien
- Arbeiten mit Dateien
- Kontexte
- Eskalationen
- Bewertungen
- Spuren von Agents
- Agent-Punktzahl
- Verwaltung von UiPath Agents
- Codierte UiPath Agents
- Erstellen Sie mit Codierungs-Agents
Veröffentlichen und Bereitstellung eines Conversational Agent in Orchestrator, um ihn für Benutzer nach Abschluss von Design und Tests verfügbar zu machen.
Nach dem Entwerfen und Testen Ihres Conversational Agenten müssen Sie ihn veröffentlichen und bereitstellen, um ihn für Benutzer verfügbar zu machen.Veröffentlichen und Bereitstellung sind zwei separate Schritte:
- Veröffentlichen: Pakete Ihren Agenten als Lösung und lädt ihn in Orchestrator hoch.
- Bereitstellung: Macht die veröffentlichte Lösung für die Ausführung mit den erforderlichen Runtime-Ressourcen verfügbar.
Orchestrator-Ordneranforderungen
Stellen Sie vor dem Veröffentlichen sicher, dass Ihr Orchestrator-Zielordner über die erforderlichen Ressourcen verfügt.
| Ressource | Zweck | Erforderlich |
|---|---|---|
| Vorlage für serverlose Robotermaschine | Führt den Conversational Agent und bestimmte Toolaufrufe aus (plattformübergreifende RPA-Automatisierungen) | Immer |
| Unattended Robot-Konto | Bietet eine Ausführungsidentität, wenn der Agent anonym verwendet wird | Wenn der Zugriff auf den Agent über einen Kanal mit anonymem Zugriff erfolgt |
| Virtuelle Maschine | Führt Windows-basierte RPA-Automatisierungen aus | Wenn Sie Windows-Automatisierungen verwenden |
| Freigegebene Verbindungen | Bietet Zugriff auf Integration Service-Connectors, wenn keine vom Benutzer konfigurierte persönliche Verbindung verfügbar ist | Wenn Tools Connectors verwenden |
Wenn Ihr Agent in der Instanzverwaltung nicht gestartet werden kann, stellen Sie sicher, dass:
- Sie befinden sich im richtigen Mandanten, in dem sich die Agent-Lösung befindet.
- Dem Lösungsordner wird eine serverlose Robotermaschinenvorlage zugewiesen.
- Wenn Sie einen anonymen Zugriffskanal verwenden, wird dem Lösungsordner ein Unattended Robot-Konto zugewiesen.
Ausführungsidentität
- Wenn auf den Conversational Agent über einen Bereitstellungskanal zugegriffen wird, der sich mit dem UiPath-Konto des Benutzers authentifiziert, wird der Conversational Agent unter der Identität des Benutzers ausgeführt. Wenn der Agent Tools aufruft, bei denen es sich um Orchestrator-Prozesse handelt, werden sie auch unter der Identität des Benutzers ausgeführt.
- Bei Verwendung eines Bereitstellungskanals mit anonymem Zugriff wird der Conversational Agent stattdessen unter der Identität eines Unattended Robot-Kontos innerhalb des Ordners ausgeführt.
Veröffentlichen
Durch das Veröffentlichen wird Ihr Conversational Agent als Lösung gepackt und in Orchestrator hochgeladen.
Schritte zum Veröffentlichen
- Öffnen Sie in Studio Web Ihren Conversational Agent.
- Wählen Sie in der oberen Symbolleiste die Option veröffentlichen aus.
- Wählen Sie den Orchestrator-Zielfeed aus (wir empfehlen den Orchestrator-Mandantenfeed).
- Optional: Geben Sie eine Notiz im Änderungsprotokoll ein, die Ihre Änderung beschreibt.
- Wählen Sie Veröffentlichen aus.
Ausführliche Informationen finden Sie unter Veröffentlichen eines Projekts.
Bereitstellung
Nach dem Veröffentlichen müssen Sie die Lösung zur Bereitstellung verfügbar machen, um sie für die Ausführung verfügbar zu machen.Die Bereitstellung verknüpft die veröffentlichte Lösung mit den Runtime-Ressourcen in Ihrem Orchestrator-Ordner.
Bereitstellungsschritte
- Navigieren Sie zu Ihrem Orchestrator.
- Suchen Sie die veröffentlichte Lösung.
- Bereitstellung (oder Aktualisierung) der Lösung, um sicherzustellen, dass sie Zugriff auf die erforderlichen Roboterkonten und Verbindungen hat.
Nach der Bereitstellung wird der Agent in der Instanzverwaltung angezeigt und über konfigurierte Kanäle verfügbar.
Für ausführliche Bereitstellungsoptionen siehe veröffentlichen eines Projekts.
Verbindungsverwaltung
Der Agent benötigt Zugriff auf die gleichen Verbindungen, die zur Entwurfszeit verwendet wurden. Conversational Agents unterstützen zwei Arten von Verbindungen: freigegebene Verbindungen, die von Administratoren konfiguriert werden, und persönliche Verbindungen, die von einzelnen Benutzern konfiguriert werden.
Freigegebene Verbindungen
Freigegebene Verbindungen werden von Administratoren in einem Orchestrator-Ordner konfiguriert und sind für alle Benutzer des Agenten verfügbar. So richten Sie freigegebene Verbindungen ein:
- Erstellen Sie Integration Service-Verbindungen in einem freigegebenen Orchestrator-Ordner.
- Verwenden Sie diese freigegebenen Verbindungen während des Designs und des Debuggings.
- Veröffentlichen Sie die Lösung als Unterordner innerhalb desselben freigegebenen Ordners.
Diese Einrichtung stellt sicher, dass die Lösung automatisch die Verbindungen des übergeordneten Ordners erbt.
Persönliche Verbindungen
Über persönliche Verbindungen können einzelne Benutzer auswählen, welche Integration Service-Verbindungen der Agent in ihrem Namen verwendet. Dies ist nützlich, wenn Benutzer den Agent benötigen, um mit ihren eigenen Anmeldeinformationen zu arbeiten – z. B. um E-Mails von ihrem eigenen Konto aus zu senden oder auf ihren persönlichen Kalender zuzugreifen.
Aktivieren von persönlichen Verbindungen
Damit persönliche Verbindungen funktionieren, müssen für jeden Toolprozess im Orchestrator zwei Einstellungen konfiguriert werden. Allgemeine Informationen zu den Ausführungseinstellungen finden Sie unter Verknüpfen von Ausführungseinstellungen.
- Navigieren Sie im Orchestrator zu dem Ordner, in dem die Agentlösung bereitgestellt wird, und öffnen Sie die Registerkarte Prozesse .
- Wählen Sie Bearbeiten für den Toolprozess aus, der einen Connector verwendet (z. B. ein API-Workflow, der E-Mails sendet).
- Legen Sie in der Prozesskonfiguration das Konto auf Übergeordnete Auftragsidentität erben fest. Dadurch kann das Tool unter der Identität des Benutzers ausgeführt werden, was für den Zugriff des Tools auf die persönlichen Verbindungen des Benutzers erforderlich ist.
- Legen Sie die Verbindung des Connectors auf Von Benutzern konfigurierbar fest. Auf diese Weise können Benutzer ihre eigenen Verbindungen für den Connector zur Runtime auswählen.
Beide Einstellungen sind erforderlich. Ohne eine der beiden Einstellungen sind persönliche Verbindungen für Benutzer nicht sichtbar und das Tool kann zur Laufzeit einen Fehler zurückgeben.
User Experience
Wenn persönliche Verbindungen für einen Agent aktiviert sind:
- Benutzer können den Bereich Einstellungen des Agents öffnen und die Registerkarte Verfügbare Verbindungen wählen, um ihre Verbindungen einzusehen und zu verwalten.
- Für jeden erforderlichen Connector (z. B. Slack, Outlook oder Salesforce) können Benutzer eine ihrer verfügbaren Verbindungen auswählen oder eine neue erstellen.
- Standardmäßig wählt der Agent automatisch eine passende Verbindung aus dem persönlichen Arbeitsbereich des Benutzers für den Connector aus, den der Agent und andere Tools im Ordner verwenden.
Der Agent versucht, Verbindungen automatisch vom persönlichen Arbeitsbereich des Benutzers aus zu konfigurieren. Wenn der Benutzer über eine passende Verbindung für einen Connector in seinem persönlichen Arbeitsbereich verfügt, verwendet der Agent diesen automatisch – so dass die Einrichtung nahtlos und in der Regel einmalig ist. 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 ein Benutzer keine persönliche Verbindung für einen Connector konfiguriert hat, greift der Agent auf die Standardverbindung des Agents zurück. Ausgewählte persönliche Verbindungen haben Vorrang vor freigegebenen Verbindungen und werden immer verwendet, wenn vorhanden. Bei Verwendung externer Anwendungen sind nur Verbindungen aus dem persönlichen Arbeitsbereich des Benutzers verfügbar – freigegebene Ordnerverbindungen werden nicht angezeigt.
Benutzer können persönliche Verbindungen nur in Kanälen auswählen und verwalten, die Benutzerprofileinstellungen unterstützen (siehe Funktionsverfügbarkeit nach Kanal). Nach der Konfiguration werden persönliche Verbindungen vom Agent über alle Kanäle hinweg verwendet.
Informationen zum Entwerfen eines Agents für persönliche Verbindungen finden Sie unter Überlegungen zur Verbindung im Designhandbuch.
Bereitstellungskanäle
Nach dem veröffentlichen können Benutzer über mehrere Kanäle auf Ihren Konversationsagenten zugreifen.Jeder Kanal bietet verschiedene Funktionen und ist für verschiedene Anwendungsfälle geeignet.
Kanalübersicht
| Kanal | Am besten geeignet für | Benutzerauthentifizierung |
|---|---|---|
| Instanzverwaltung | Administratortests, interne Benutzer | UiPath-Konto |
| Autopilot for Everyone | Interner Produktivitätshub | UiPath-Konto |
| Microsoft Teams | Teamzusammenarbeit | Microsoft-Konto und UiPath-Konto |
| Slack | Teamzusammenarbeit | Slack-Konto und UiPath-Konto |
| Einbetten von iFrame | Apps von Drittanbietern und UiPath Apps | UiPath-Konto oder anonym |
| UiPath TypeScript SDK | Benutzerdefinierte Anwendungen | Wird von Ihrer Anwendung festgelegt |
Funktionsverfügbarkeit nach Kanal
Nicht alle Chatfunktionen sind in jedem Kanal verfügbar. Die Instanzverwaltung bietet den vollständigen Funktionssatz; andere Kanäle können Einschränkungen haben.
| Funktionen | Instanzverwaltung | Autopilot for Everyone | Microsoft Teams | Slack | Iframe | TypeScript-SDK* |
|---|---|---|---|---|---|---|
| Neuen Chat starten | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Chatverlauf | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Chat-Sitzung löschen | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Benutzerprofil-Einstellungen | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Persönliche Verbindungen | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Eingabeaufforderungen beim Starten | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Dateiuploads | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Konversationseingaben | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Bestätigungen von Tool-Aufrufen | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Zitate | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| HTML-Vorschau | ✅ | ❌ | ✅ | ❌ | ✅ | ✅ |
| Antwort kopieren | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Feedback (Daumen) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
* Alle SDK-Funktionen können vom Entwickler in seiner benutzerdefinierten Implementierung konfiguriert werden.
Auswählen eines Kanals
Berücksichtigen Sie diese Faktoren bei der Auswahl von Bereitstellungskanälen:
Interne Benutzer mit UiPath-Zugriff
- Verwenden Sie die Instanzverwaltung für Administratortests und Power-Benutzer.
- Verwenden Sie Autopilot for Everyone als zentralen Hub für alle Agents.
Teamzusammenarbeit
- Verwenden Sie Teams oder Slack, um den Agent dort zu bringen, wo Teams bereits arbeiten.
Benutzerdefinierte Anwendungen
- Verwenden Sie die iFrame-Einbettung für Apps von Drittanbietern oder UiPath Apps.
Externe oder anonyme Benutzer
- Verwenden Sie die iFrame-Einbettung mit einem anonymen Authentifizierungsserver.
Benutzerdefinierte Anwendungen
- Verwenden Sie das UiPath TypeScript SDK, um Konversations-Agents in Ihre eigenen Webanwendungen oder -portale zu integrieren.
Verhalten der Chat-Sitzung
Konversationsagenten pflegen persistente Sitzungen:
- Jede Konversation wird als dedizierter Orchestrator-Prozess ausgeführt (aktiv für bis zu 8 Stunden Inaktivität).
- Sitzungen bleiben aktiv, um sofortige Antworten zu aktivieren.
- Inaktive Sitzungen verbrauchen minimale Ressourcen.
Verwenden von UiPath-Tools in externen Plattformen
Sie können UiPath-Funktionen (Automatisierungen, Workflows, Dokumentverarbeitung) mit MCP-Tools (Model Context Protocol) externen Chatplattformen wie ChatGPT und Microsoft Copilot Studio bereitstellen. Dieser Ansatz verwendet direkte Toolaufrufe anstelle von Agents.
Weitere Informationen zur MCP-Integration finden Sie unter MCP-Server.
Nächste Schritte
Wählen Sie einen Kanal aus, um mehr über Einrichtung und Konfiguration zu erfahren:
- Orchestrator-Ordneranforderungen
- Ausführungsidentität
- Veröffentlichen
- Schritte zum Veröffentlichen
- Bereitstellung
- Bereitstellungsschritte
- Verbindungsverwaltung
- Bereitstellungskanäle
- Kanalübersicht
- Funktionsverfügbarkeit nach Kanal
- Auswählen eines Kanals
- Verhalten der Chat-Sitzung
- Verwenden von UiPath-Tools in externen Plattformen
- Nächste Schritte