Bereitstellung Ihres Chat Agents

Veröffentlichen und stellen Sie Ihren Chat Agent in Orchestrator bereit, um ihn für Benutzer nach Abschluss von Design und Tests verfügbar zu machen.

Die gleichen Schritte und Kanäle gelten unabhängig davon, ob Sie einen Konversationsagenten in Agent Builder oder einen Konversationsprompt in Maestro Flow erstellt haben.

• In der Instanzverwaltung wird auf der Registerkarte Konversationell jeder Ihrer veröffentlichten Chats als beschrieben gekennzeichnet
  • Konversationsagent – wenn er über Agent Builder erstellt wurde
  • Konversationsflow – wenn es in Maestro Flow integriert ist
• Auf allen anderen Kanälen sehen Benutzer beide Typen als Conversational Agent. Ihre Endbenutzer sind nicht offengelegt für die Runtime, die den Chat bereitstellt, sodass Sie nahtloser zwischen Buildpfaden wechseln können (z. B. durch Umwandlung eines Conversational Agent mit einem einzigen Prompt in einen Conversational Flow).

Veröffentlichen und Bereitstellung sind zwei separate Schritte:

• Veröffentlichen: Pakete Ihr Projekt als Lösung und lädt es 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

Wichtig:

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. Sie können Benutzern erlauben, ihre persönlichen Verbindungen für Toolausführungen zu verwenden – weitere Informationen finden Sie unter Verbindungsverwaltung .
• 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 Projekt als Lösung gepackt und in Orchestrator hochgeladen.

Schritte zum Veröffentlichen

1. Öffnen Sie in Studio Web Ihr Agent Builder- oder Maestro Flow-Projekt.
2. Wählen Sie in der oberen Symbolleiste die Option veröffentlichen aus.
3. Wählen Sie den Orchestrator-Zielfeed aus (wir empfehlen den Orchestrator-Mandantenfeed).
4. Optional: Geben Sie eine Notiz im Änderungsprotokoll ein, die Ihre Änderung beschreibt.
5. 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

1. Navigieren Sie zu Ihrem Orchestrator.
2. Suchen Sie die veröffentlichte Agent Builder- oder Maestro Flow-Lösung.
3. Bereitstellung (oder Aktualisierung) der Lösung, um sicherzustellen, dass sie Zugriff auf die erforderlichen Roboterkonten und Verbindungen hat.

Nach der Bereitstellung wird sie 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:

1. Erstellen Sie Integration Service-Verbindungen in einem freigegebenen Orchestrator-Ordner.
2. Verwenden Sie diese freigegebenen Verbindungen während des Designs und des Debuggings.
3. 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

Hinweis:

Persönliche Verbindungen befinden sich in der öffentlichen Vorschau.

Ü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.

1. Navigieren Sie im Orchestrator zu dem Ordner, in dem die Agentlösung bereitgestellt wird, und öffnen Sie die Registerkarte Prozesse .
2. Wählen Sie Bearbeiten für den Toolprozess aus, der einen Connector verwendet (z. B. ein API-Workflow, der E-Mails sendet).
3. 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.
4. 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.

Wichtig:

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.

Hinweis:

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. Nur dieser Kanal unterscheidet zwischen einem Conversational Agent (Agent Builder) und einem Conversational Flow (Maestro Flow) auf der Registerkarte Conversational.	UiPath-Konto
Assistant	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	Assistant	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.

** Konversationseingaben werden nur für Konversations-Agents unterstützt, die in Agent Builder erstellt wurden.

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 Assistant 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.

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:

• Instanzverwaltung
• Assistant
• Microsoft Teams
• Slack
• Einbetten von IFrame und Apps
• UiPath TypeScript SDK