Integrieren Sie Konversations-Agents

Betten Sie einen veröffentlichten Conversational Agent mithilfe eines IFrame-Steuerelements in Studio Web in eine UiPath-App oder eine Drittanbieteranwendung ein.

Sie können einen Konversationsagenten mithilfe eines IFrame direkt in eine UiPath App oder eine Drittanbieteranwendung einbetten. Auf diese Weise können Benutzer mit Agents interagieren, ohne die Anwendung zu verlassen.

Einbetten von Konversationsagenten in UiPath Apps

1. Erstellen und veröffentlichen Sie einen Konversations-Agent.

2. Öffnen Sie Ihr App-Projekt in Studio.

3. Fügen Sie Ihrer Seite eine IFrame-Komponente hinzu.

4. Legen Sie die IFrame-Quell-URL mit dem folgenden Format fest:

   "https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=<title>&welcomeTitle=<welcome_title>&welcomeDescription=<welcome_description>&suggestions=<suggestions>"
   

   Wichtig:

   Die Organisation und der Mandant können die ID oder der Namedes Agents sein

   Erforderliche Parameter

   • agentId: Versions-ID des veröffentlichten Conversational Agent.

   Optionale Parameter

   • mode – Kann embedded oder fullscreen sein (Standardwert ist fullscreen).
   • Title - Der Titel der Chatkomponente. Standardmäßig wird der Name des Agents verwendet.
   • willkommenTitel – Titel der ersten Ausführung, der in der Mitte des Bildschirms angezeigt wird. Standardmäßig wird eine leere Zeichenfolge '' verwendet.
   • willkommenBeschreibung – Beschreibung der ersten Ausführung. Standardmäßig wird eine leere Zeichenfolge '' verwendet.
   • Vorschläge – Vorschläge zur ersten Ausführung. Standardmäßig wird ein leeres Array [] verwendet. Beispiel: ["Hi, what can you do", "Hello, how are you"].
     Hinweis:

     Um direkt im Browser zu testen, schließen Sie doppelte Anführungszeichen ein. Verwenden Sie bei der Einbettung von Apps zwei Anführungszeichen.

   • showHistory – Verlaufsbereich anzeigen. Die Standardeinstellung ist true.
   • jobStartOverloads – Überschreibt die Aufträge des Konversations-Agents, die bei der Ausgabe der Konversation ausgeführt werden. Wenn nicht übergeben oder wenn runAsMe nicht definiert ist, führt Führen Sie den Auftrag mit den Standardeinstellungen für den Auftragsstart RunAsMe: false aus. Beispiel: jobStartOverrides={"runAsMe":true}
     Hinweis:

     Um direkt im Browser zu testen, schließen Sie doppelte Anführungszeichen ein. Verwenden Sie bei der Einbettung von Apps zwei Anführungszeichen.

5. Veröffentlichen Sie Ihre App. Ihr Agent ist jetzt eingebettet und einsatzbereit.

Beispiel-URL

"https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=Conversational Agents&welcomeTitle=Welcome to conversational agents&welcomeDescription=Talk with your agent to get started&suggestions=[""Hi, what can you do"", ""Hello, how are you""]"

Einbetten von Konversations-Agents in Dienste von Drittanbietern

1. Erstellen und veröffentlichen Sie einen Konversations-Agent.
2. Fügen Sie Ihrer Anwendung ein <iframe> -Element hinzu, in dem der Konversations-Agent angezeigt werden soll.
3. Legen Sie das IFrame-Quellattribut mit dem folgenden Format fest:

   "https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=<title>&welcomeTitle=<welcome_title>&welcomeDescription=<welcome_description>&suggestions=<suggestions>"
   

Häufig gestellte Fragen

Wie rufen Sie die agentId ab?

• Gehen Sie zu Agents > Konversations-Agents, öffnen Sie Ihren Agent und kopieren Sie agentId aus der URL.

Gibt es eine Möglichkeit, Conversation Agent öffentlich zu machen?

• Noch nicht. Der öffentliche Zugriff erfordert zusätzliche Arbeit in Bezug auf Authentifizierung, Sicherheit und Lizenzierung.

Ist es möglich, dem Client einen Kontext zu geben?

• Unterstützung für das Einfügen von Eingaben in Konversations-Agents befindet sich in der Entwicklung.