Déploiement de votre agent de chat

Publiez et déployez votre agent de chat sur Orchestrator pour le mettre à la disposition des utilisateurs une fois la conception et les tests terminés.

Les mêmes étapes et les mêmes canaux s'appliquent, que vous ayez créé un agent conversationnel dans Agent Builder ou un Maestro Flow conversationnel.

• Sur la gestion des instances, l'onglet Conversationnel libelle chacune de vos expériences de chat publiées comme
  • Agent conversationnel — lorsqu'il est créé à partir d'Agent Builder
  • Flux conversationnel — lorsqu'il est intégré à Maestro Flow
• Sur tous les autres canaux, les utilisateurs voient les deux types d' agent conversationnel. Vos utilisateurs finaux ne sont pas exposés au runtime qui sert de chat, ce qui vous permet de passer plus facilement d’un chemin de création à un autre (par exemple, la mise à niveau d’un agent conversationnel à invite unique dans un flux conversationnel).

La publication et le déploiement sont deux étapes distinctes :

• Publication: empaquète votre projet en tant que solution et le charge sur Orchestrator.
• Déploiement : rend la solution publiée disponible pour l’exécution avec les ressources de Runtime requises.

Exigences du dossier Orchestrator

Avant de publier, assurez-vous que votre dossier Orchestrator cible dispose des ressources requises configurées.

Ressource	Objectif	Requis
Modèle de machine robot sans serveur	Exécute les appels d’agents conversationnels et d’outils spécifiques (automatisations RPA inter-plateformes)	Toujours
Compte Unattended Robot	Fournit une identité d’exécution lorsque l’agent est utilisé de manière anonyme	Si l’agent est accessible via un canal en utilisant l’accès anonyme
Machine virtuelle	Exécute des automatisations RPA basées sur Windows	Si vous utilisez des automatisations Windows
Connexions partagées	Fournit un accès aux connecteurs Integration Service lorsqu'aucune connexion personnelle configurée par l'utilisateur n'est disponible	Si les outils utilisent des connecteurs

Important :

Si votre agent ne démarre pas dans la gestion des instances, vérifiez que :

• Vous êtes dans le bon locataire où réside la solution de l’agent.
• Un modèle de machine robot sans serveur est affecté au dossier de la solution.
• Si vous utilisez un canal d’accès anonyme, un compte Unattended Robot est affecté au dossier de la solution.

Identité de l’exécution

• Lorsque l'agent conversationnel est accessible via un canal de déploiement qui s'authentifie avec le compte UiPath de l'utilisateur, l'agent conversationnel s'exécute sous l'identité de l'utilisateur. Vous pouvez autoriser les utilisateurs à utiliser leurs connexions personnelles pour les exécutions d’outils. Consultez la section Gestion des connexions pour plus de détails.
• Lors de l'utilisation d'un canal de déploiement avec accès anonyme, l'agent conversationnel s'exécute plutôt sous l'identité d'un compte robot non assisté dans le dossier.

Publier

La publication empaquète votre projet en tant que solution et le charge sur Orchestrator.

Étapes de publication

1. Dans Studio Web, ouvrez votre projet Agent Builder ou Maestro Flow.
2. Sélectionnez Publier dans la barre d'outils supérieure.
3. Sélectionnez le flux cible d’Orchestrator (nous recommandons le fluxde locataire d’Orchestrator).
4. (Facultatif) Entrez une note du journal des modifications décrivant votre modification.
5. Sélectionnez Publier.

Pour des options de publication détaillées, consultez Publication d'un projet.

Déploiement

Après la publication, vous devez effectuer le déploiement de la solution pour la rendre disponible pour l’exécution.Le déploiement associe la solution publiée aux ressources de Runtime dans votre dossier Orchestrator.

Étapes de déploiement

1. Naviguez vers votre Orchestrator.
2. Localisez la solution Agent Builder ou Maestro Flow publiée.
3. Déployez (ou mettez à niveau) la solution en vous assurant qu'elle a accès aux comptes et aux connexions de robot requis.

Une fois déployé, il apparaît dans la gestion des instances et devient disponible via les canaux configurés.

Pour des options de déploiement détaillées, reportez-vous à Publication d'un projet.

Gestion de la connexion

L’agent doit accéder aux mêmes connexions utilisées en phase de conception. Les Agents conversationnels prennent en charge deux types de connexions: les connexions partagées configurées par les administrateurs et les connexions personnelles configurées par des utilisateurs individuels.

Connexions partagées

Les connexions partagées sont configurées par des administrateurs dans un dossier Orchestrator et sont disponibles pour tous les utilisateurs de l'agent. Pour configurer des connexions partagées:

1. Créez des connexions Integration Service dans un dossier Orchestrator partagé.
2. Utilisez ces connexions partagées pendant la conception et le débogage.
3. Publiez la solution en tant que sous-dossier dans le même dossier partagé.

Cette configuration garantit que la solution hérite automatiquement des connexions du dossier parent.

Connexions personnelles

Remarque :

Les connexions personnelles sont en aperçu public.

Les connexions personnelles permettent aux utilisateurs individuels de sélectionner les connexions Integration Service que l'agent utilise en leur nom. Cela est utile lorsque les utilisateurs ont besoin que l’agent agisse avec ses propres informations d’identification, par exemple en envoyant des e-mails à partir de leur propre compte ou en accédant à leur calendrier personnel.

Activer les connexions personnelles

Pour que les connexions personnelles fonctionnent, deux paramètres doivent être configurés sur chaque processus d'outil dans Orchestrator. Pour des informations générales sur les paramètres d'exécution, consultez Lier les paramètres d'exécution.

1. Dans Orchestrator, accédez au dossier dans lequel la solution d'agent est déployée et ouvrez l'onglet Processus .
2. Sélectionnez Modifier sur le processus d’outil qui utilise un connecteur (par exemple, un workflow d’API qui envoie des e-mails).
3. Dans la configuration du processus, définissez le Compte sur Hériter de l'identité de la tâche parente. Cela permet à l’outil de s’exécuter sous l’identité de l’utilisateur, ce qui est requis pour que l’outil puisse accéder aux connexions personnelles de l’utilisateur.
4. Définissez la connexion du connecteur sur Configurable par les utilisateurs. Cela permet aux utilisateurs de sélectionner leurs propres connexions pour le connecteur au moment du runtime.

Important :

Les deux paramètres sont requis. Sans ensemble de tests, les connexions personnelles ne sont pas visibles pour les utilisateurs et l’outil peut renvoyer une erreur au moment de l’exécution.

Expérience utilisateur

Lorsque les connexions personnelles sont activées pour un agent:

• Les utilisateurs peuvent ouvrir le panneau Paramètres de l'agent et sélectionner l'onglet Connexions disponibles pour afficher et gérer leurs connexions.
• Pour chaque connecteur requis (par exemple, Slack, Outlook ou Salesforce), les utilisateurs peuvent sélectionner l'une de leurs connexions disponibles ou en créer une nouvelle.
• Par défaut, l’agent sélectionne automatiquement une connexion correspondante dans l’espace de travail personnel de l’utilisateur pour le connecteur qu’utilisent l’agent et les autres outils du dossier.

L’agent tente de configurer automatiquement les connexions depuis l’espace de travail personnel de l’utilisateur. Si l'utilisateur dispose d'une connexion correspondante pour un connecteur dans son espace de travail personnel, l'agent l'utilise automatiquement, ce qui rend la configuration transparente et généralement une expérience unique. Si la connexion configurée automatiquement échoue ou si aucune connexion correspondante n'est trouvée, l'utilisateur est invité à sélectionner ou à en créer une nouvelle.

Si un utilisateur n'a pas configuré de connexion personnelle pour un connecteur, l'agent revient à la connexion par défaut de l'agent. Les connexions personnelles sélectionnées ont priorité sur les connexions partagées et sont toujours utilisées lorsqu'elles sont présentes. Lors de l'utilisation d'applications externes, seules les connexions de l'espace de travail personnel de l'utilisateur sont disponibles - les connexions de dossier partagé ne s'affichent pas.

Remarque :

Les utilisateurs peuvent sélectionner et gérer les connexions personnelles uniquement dans les canaux qui prennent en charge les paramètres de profil utilisateur (voir Disponibilité des fonctionnalités par canal). Une fois configurées, les connexions personnelles sont utilisées par l'agent sur tous les canaux.

Pour apprendre à concevoir un agent pour les connexions personnelles, consultez Considérations relatives aux connexions dans le guide de conception.

Canaux de déploiement

Après la publication, les utilisateurs peuvent accéder à votre agent conversationnel via plusieurs canaux.Chaque canal offre des fonctionnalités différentes et est adapté à différents cas d’utilisation.

Vue d'ensemble du canal

Canal	Idéal pour	Authentification de l’utilisateur
Gestion des instances	Tests d’administrateur, utilisateurs internes. Seul ce canal fait la différence entre un Agent Builder et un Maestro Flow dans l'onglet Conversationnel.	Compte UiPath
Assistant	Hub de productivité interne	Compte UiPath
Microsoft Teams	Collaboration d’équipe	Compte Microsoft et compte UiPath
Slack	Collaboration d’équipe	Compte Slack et compte UiPath
Intégration iFrame	Apps tierces et Apps UiPath	Compte UiPath ou anonyme
SDK UiPath TypeScript	Applications personnalisées	Déterminé par votre application

Disponibilité des fonctionnalités par canal

Toutes les fonctionnalités de chat ne sont pas disponibles dans chaque canal. La gestion des instances fournit l’ensemble complet de fonctionnalités ; d’autres canaux peuvent avoir des limitations.

Fonctionnalités	Gestion des instances	Assistant	Microsoft Teams	Slack	Iframe	SDK TypeScript*
Démarrer un nouveau chat	✅	✅	✅	✅	✅	✅
Historique du chat	✅	✅	✅	✅	✅	✅
Supprimer la session de chat	✅	✅	✅	❌	✅	✅
Paramètres utilisateur/profil	✅	✅	✅	❌	✅	✅
Connexions personnelles	✅	✅	✅	❌	✅	✅
Invites de démarrage	✅	✅	✅	❌	✅	✅
Téléversements de fichiers	✅	✅	✅	✅	✅	✅
Entrées de conversation**	✅	✅	✅	❌	✅	✅
Confirmations d'appel d'outil	✅	✅	✅	❌	✅	✅
Citations	✅	✅	✅	✅	✅	✅
Aperçu HTML	✅	✅	✅	❌	✅	✅
Copier la réponse	✅	✅	✅	❌	✅	✅
Commentaires (pouces)	✅	✅	✅	✅	✅	✅

* Toutes les fonctionnalités des SDK peuvent être configurées par le développeur dans son implémentation personnalisée.

** Les entrées de conversation sont prises en charge uniquement pour les Agents conversationnels intégrés à Agent Builder.

Choix d’un canal

Tenez compte de ces facteurs lors de la sélection de canaux de déploiement :

Utilisateurs internes avec accès UiPath

• Utilisez la gestion des instances pour les tests d'administrateur et les utilisateurs expérimentés.
• Utilisez Assistant comme hub central pour tous les Agents.

Collaboration d’équipe

• Utilisez Teams ou Slack pour amener l’agent là où les équipes travaillent déjà.

Applications personnalisées

• Utilisez l’intégration iFrame pour les Apps tierces ou les Apps UiPath.

Utilisateurs externes ou anonymes

• Utilisez l’intégration iFrame avec un serveur d’authentification anonyme.

Applications personnalisées

• Utilisez le SDK UiPath TypeScript pour intégrer des agents conversationnels dans vos propres applications ou portails Web.

Utilisation des outils UiPath dans des plateformes externes

Vous pouvez exposer les fonctionnalités UiPath (automatisations, workflows, traitement de documents) à des plateformes de chat externes telles que ChatGPT et Microsoft Copilot Studio à l’aide d’outils MCP (Model Context Protocol). Cette approche utilise des appels d’outils directs plutôt que des Agents conversationnels.

Pour des détails sur l’intégration MCP, reportez-vous à Serveurs MCP.

Prochaines étapes

Sélectionnez un canal pour en savoir plus sur l’installation et la configuration :

• Gestion des instances
• Assistant
• Microsoft Teams
• Slack
• Intégration d'IFrame et d'Apps
• SDK UiPath TypeScript