Intégration d'IFrame et d'Apps

Vue d'ensemble (Overview)

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

Utilisateurs destinés : développeurs et administrateurs qui souhaitent intégrer des agents conversationnels dans des applications Web personnalisées ou dans des applications 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	✅
Image mémoire Debug	❌

Prérequis

Pour intégrer un agent conversationnel, procédez aux étapes de configuration suivantes :

Configuration de l’administrateur ou du développeur

1. Publiez l’agent conversationnel dans le dossier Orchestrator de votre choix.
2. Récupérez l'ID de version de l'agent dans Instance Management.
3. Pour UiPath Apps, créez un projet Apps dans UiPath Studio.
4. Pour les applications tierces, assurez-vous que l’application Web prend en charge l’intégration iFrame.

Rechercher l'ID de l'agent

1. Dans Gestion des instances, accédez à Agents > Agents déployés.
2. Sélectionnez Chat pour l'agent souhaité.
3. Copiez l' ID de l'agent provenant de l'URL. Par exemple, dans l'URL https://cloud.uipath.com/conversationalagents/agents_/deployed/chat/342061, l'ID de l'agent est 342061.

Prérequis utilisateur :

• Les utilisateurs authentifiés doivent disposer d'un compte UiPath autorisé à accéder à l'agent.
• Unutilisateur anonyme doit avoir accès à l'application ou à l'interface où l'agent est intégré.

Intégrer l’agent

Constructions 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'organisation et du locataire est sensible à la casse.

Paramètres URL

Paramètre	Requis	Description
agentId	Oui (Yes)	L'ID de version de l'agent publié
mode	Non (No)	embedded pour l'expérience de la barre de droite, fullscreen pour le mode plein écran (par défaut : fullscreen)
title	Non (No)	Titre affiché dans l’en-tête du 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 d'accueil de la première exécution
suggestions	Non (No)	Tableau des invites suggérées pour la première exécution
showHistory	Non (No)	Afficher/masquer le panneau de l'historique des chats (par défaut : true)

Exemples d'URL

Mode intégré basique :

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

Avec message de bienvenue et 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 UiPath Apps

Pour intégrer un agent conversationnel dans UiPath Apps, 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 de iFrame sur l'URL créée.

4. Publier l’application.

   

Lorsque vous intégrez un agent conversationnel dans UiPath Apps, échapper le tableau des suggestions en utilisant des guillemets doubles, comme le montre l'exemple suivant :

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

Cela est nécessaire car UiPath Apps valide la valeur sous forme de chaîne.

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 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’origines croisées: 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 approprié sur toutes les tailles d'écran.
• Accès au presse-papiers: incluez allow="clipboard-write" pour activer la fonctionnalité de copie de réponse.

Fonctionnalités de chat

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

Limitations

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

Fonctionnalités	Remarques
Citations	L’aperçu de la citation 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 organisation est requis.
• Aucune licence utilisateur individuelle n’est requise.
• La consommation est déduite du pool d’unités du locataire.

Pour obtenir des instructions de configuration, consultez la section Configuration de l'accès anonyme.

Pour de plus amples informations sur les licences, consultez la section Licences.

Avertissement :

L'accès anonyme permet aux utilisateurs sans compte UiPath d'interagir avec votre agent. Nous vous recommandons fortement de garder les agents anonymes derrière votre propre portail ou de vous connecter pour atténuer les abus.

Résolution des problèmes

iFrame ne se charge pas

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

Copie ne fonctionne pas

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

Prochaines étapes

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