Intégrer des agents conversationnels

Intégrez un agent conversationnel publié dans une application UiPath ou une application tierce à l’aide d’un contrôle IFrame dans Studio Web.

You can embed a conversational agent directly inside a UiPath App or any third-party application using an IFrame. This allows users to interact with agents without leaving the application.

Intégrer des agents conversationnels dans UiPath Apps

1. Créez et publiez un agent conversationnel.

2. Open your app project in Studio.

3. Add an IFrame component to your page.

4. Définissez l'URL source IFrame en utilisant le format suivant :

   "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>"
   

   Important :

   L' organisation et le locataire peuvent être l' ID ou le nomde l'agent

   Paramètres requis

   • agentId: Release ID of the published conversational agent.

   Paramètres facultatifs

   • mode : peut être embedded ou fullscreen (la valeur par défaut est fullscreen).
   • titre - Titre du composant de chat. La valeur par défaut est le nom de l’agent.
   • soonTitle : titre de première expérience d'exécution affiché au milieu de l'écran. La valeur par défaut est une chaîne vide ''.
   • bienvenueDescription : Description de l'expérience de première exécution. La valeur par défaut est une chaîne vide ''.
   • suggestions : suggestions de première expérience d’exécution. La valeur par défaut est un tableau vide []. Exemple : ["Hi, what can you do", "Hello, how are you"].
     Remarque :

     Pour tester directement sur le navigateur, encapsulez un ensemble de guillemets doubles. Pour l'intégration dans Apps, encapsulez deux ensembles de guillemets doubles.

   • montrer Historique : affiche le panneau d'historique. La valeur par défaut est true.
   • jobStart Replaces - Remplace les tâches de l'agent conversationnel qui s'exécutent lors de la conversation. Lorsqu’il n’est pas transmis ou lorsque runAsMe n’est pas défini, Case exécutera la tâche avec les paramètres de début de tâche par défaut RunAsMe: false. Exemple : jobStartOverrides={"runAsMe":true}
     Remarque :

     Pour tester directement sur le navigateur, encapsulez un ensemble de guillemets doubles. Pour l'intégration dans Apps, encapsulez deux ensembles de guillemets doubles.

5. Publish your app. Your agent is now embedded and ready to use.

Exemple d'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""]"

Intégrer des agents conversationnels dans des services tiers

1. Créez et publiez un agent conversationnel.
2. Ajoutez un élément <iframe> à votre application dans lequel vous souhaitez que l'agent conversationnel s'affiche.
3. Définissez l'attribut source IFrame en utilisant le format suivant :

   "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>"
   

FAQ

Comment récupérer l’ID de l’agent ?

• Accédez à Agents > Agents conversationnels, ouvrez votre agent et copiez le agentId de l'URL.

Existe-t-il un moyen de rendre l'agent conversationnel public ?

• Pas encore. L'accès public nécessite des tâches supplémentaires liées à l'authentification, la sécurité et la licence.

Est-il possible d’injecter du contexte au client ?

• La prise en charge de l’injection d’entrées dans Conversational Agents est en cours de développement.