Intégration d'IFrame et d'Apps

Vue d'ensemble (Overview)

Intégrez votre agent conversationnel dans des applications Web à l’aide d’iFrame.Utilisez cette approche pour ajouter des Agents conversationnels à des applications tierces ou à des Apps UiPath à l’aide du composant iFrame.

Utilisateurs prévus : développeurs et Administrators qui souhaitent intégrer des Agents conversationnels dans des applications Web personnalisées ou des Apps UiPath.

Disponibilité des fonctionnalités

Fonctionnalités	Disponible
Démarrer un nouveau chat	✅
Historique du chat	✅
Supprimer la session de chat	✅
Paramètres	✅
Invites de démarrage	✅
Téléversements de fichiers	✅
Citations	❌
Aperçu HTML	✅
Copier la réponse	✅
Commentaires (pouces)	✅
Image mémoire Debug	❌

Prérequis

Pour intégrer un agent conversationnel, effectuez les étapes de configuration suivantes :

Configuration de l'administrateur ou du développeur

1. Publiez l’agent conversationnel dans votre dossier Orchestrator souhaité.
2. Récupérez l’ID de publication de l’agent à partir de la gestion des instances.
3. Pour les Apps UiPath, créez un projet Apps dans UiPath Studio.
4. Pour les Apps tierces, assurez-vous que l’application Web prend en charge l’intégration iFrame.

Recherche de l’ID de l’agent

1. Dans la gestion des instances, naviguez vers Agents > Agents déployés.
2. Sélectionnez Chat pour l’agent souhaité.
3. Copiez l’ID de l’agent à partir de l’URL. Par exemple, dans l’URL https://cloud.uipath.com/conversationalagents/agents_/deployed/chat/342061, l’ID de l’agent est 342061.

Exigences de l’utilisateur :

• Les utilisateurs authentifiés doivent avoir un compte UiPath avec l’autorisation d’accéder à l’agent.
• Les utilisateurs anonymes doivent avoir accès à l’application ou à la surface où l’agent est intégré.

Intégration de l’agent

Construction d’URL

Définissez la source iFrame sur une URL au format suivant :

https://cloud.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=<mode>

Remarque :

Le nom de l’Organization et le nom du locataire sont sensibles à la casse.

Paramètres URL

Paramètre	Requis	Description
agentId	Oui (Yes)	L’ID de publication de l’agent publié
mode	Non (No)	embedded pour l’expérience de barre latérale droite, fullscreen pour le plein écran (par défaut : fullscreen)
title	Non (No)	Titre affiché dans l’en-tête de chat (par défaut : nom de l’agent)
welcomeTitle	Non (No)	Titre de l’écran de bienvenue de la première exécution
welcomeDescription	Non (No)	Description de l’écran de bienvenue de la première exécution
suggestions	Non (No)	Array des invites suggérées pour la première exécution
showHistory	Non (No)	Afficher/Masquer le panneau Historique de chat (par défaut : true)

Exemples d’URL

Mode intégré de base :

https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded

Avec un message de bienvenue et des suggestions :

https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded&title=HR Assistant&welcomeTitle=Welcome!&welcomeDescription=I can help you with HR questions&suggestions=["What is the PTO policy?","How do I submit expenses?"]

Intégration dans les Apps UiPath

Pour intégrer un agent conversationnel dans des Apps UiPath, utilisez le composant iFrame.

1. Ouvrez votre application dans UiPath Apps Studio.

2. Ajoutez un composant iFrame à votre page.

3. Définissez la propriété Source iFrame sur l’URL construite.

4. Publier l’application.

   

Lors de l’intégration d’un agent conversationnel dans des Apps UiPath, échappez à l’Array de suggestions en utilisant des guillemets doubles, comme indiqué dans l’exemple suivant :

suggestions=[""What is the PTO policy?"",""How do I submit expenses?""]

Cela est requis, car Apps UiPath valide la valeur en tant que string.

Intégration dans des applications tierces

Vous pouvez intégrer un agent conversationnel dans n’importe quelle application Web qui prend en charge l’intégration iFrame.

Exemple de HTML :

<iframe
  src="https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded"
  width="400"
  height="600"
  frameborder="0"
  allow="clipboard-write"
></iframe>

Considérations

• Politiques d’origine croisée : assurez-vous que la politique de sécurité du contenu de votre application permet l’intégration à partir de uipath.com.
• Conception réactive : configurez les valeurs de largeur et de hauteur appropriées pour garantir un rendu correct sur les tailles d’écran.
• Accès au Presse-papiers : incluez allow="clipboard-write" pour activer la fonctionnalité Copier la réponse.

Fonctionnalités de chat

L’expérience de chat intégrée utilise l’IU de chat de gestion des instances, fournissant la même fonctionnalité de chat avec les exceptions et limitations suivantes.

Limitations

Les fonctionnalités suivantes ne sont pas disponibles en mode intégré :

Fonctionnalités	Remarques
Citations	L’aperçu des citations n’est pas disponible
Image mémoire Debug	Non disponible.Utilisez la gestion des instances pour le débogage.

Options d'authentification

Utilisateurs authentifiés

Pour les utilisateurs internes avec des comptes UiPath :

• Les utilisateurs s’authentifient à l’aide de l’authentification UiPath standard.
• L’agent a accès aux informations d’identité de l’utilisateur telles que le nom et l’adresse e-mail.
• La consommation est suivie par rapport à la licence de l’utilisateur.

Utilisateurs anonymes

Pour les scénarios externes ou non authentifiés :

• Une application externe confidentielle doit être configurée dans le portail Administrateur.
• Un point de terminaison de jeton hébergé par votre Organization est requis.
• Aucune licence utilisateur individuelle n’est requise.
• La consommation est déduite du pool d’unités du locataire.

Pour des instructions de configuration, reportez-vous à Configuration de l’accès anonyme.

Pour des détails sur la concession de licences, reportez-vous à Concession de licences.

Avertissement :

L’accès anonyme permet aux utilisateurs sans comptes UiPath d’interagir avec votre agent. Nous recommandons fortement de synchroniser des Agents anonymes derrière votre propre portail ou connexion pour atténuer les abus.

Résolution des problèmes

iFrame ne se charge pas

• Vérifiez que l’URL est correctement construite.
• Vérifiez que l’ID de l’agent est valide.
• Assurez-vous que l’agent est publié et en cours d’exécution.
• Vérifiez la console du navigateur pour détecter des erreurs de politique de sécurité de contenu.

La copie ne fonctionne pas

• Assurez-vous qu’iFrame inclut allow="clipboard-write" attribut.
• Vérifiez les autorisations du navigateur pour l’accès au Presse-papiers.

Prochaines étapes

• Configuration de l’accès anonyme : activez l’accès pour les utilisateurs sans comptes UiPath
• Gestion des instances : référence des fonctionnalités complètes et débogage