- Démarrage
- Agents UiPath dans Studio Web
- À propos des agents UiPath
- Licences
- Exécuter des agents
- Agents et workflows
- Meilleures pratiques pour créer des agents
- Choix du meilleur modèle pour votre agent
- Meilleures pratiques pour la publication et le déploiement d’agents
- Meilleures pratiques en matière d’ingénierie contextuelle
- Meilleures pratiques pour DeepRAG et la transformation par lots : JIT vs. stratégies basées sur l’index
- Utiliser des fichiers
- Contextes
- Escalades
- Évaluations
- Traçages d’agent
- Score de l’agent
- Gérer les agents UiPath
- Agents codés UiPath
- Créer avec des agents codés
Publiez et déployez un agent conversationnel sur Orchestrator pour le mettre à la disposition des utilisateurs une fois la conception et les tests terminés.
Après avoir conçu et testé votre agent conversationnel, vous devez le publier et le déployer pour le mettre à la disposition des utilisateurs.La publication et le déploiement sont deux étapes distinctes :
- Publication : empaquète votre agent 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 |
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. Lorsque l’agent invoque des outils qui sont des processus Orchestrator, ils s’exécutent également sous l’identité de l’utilisateur.
- 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 agent conversationnel en tant que solution et le charge sur Orchestrator.
Étapes de publication
- Dans Studio Web, ouvrez votre agent conversationnel.
- Sélectionnez Publier dans la barre d'outils supérieure.
- Sélectionnez le flux cible d’Orchestrator (nous recommandons le fluxde locataire d’Orchestrator).
- (Facultatif) Entrez une note du journal des modifications décrivant votre modification.
- 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
- Naviguez vers votre Orchestrator.
- Localisez la solution publiée.
- 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é, l’agent 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:
- Créez des connexions Integration Service dans un dossier Orchestrator partagé.
- Utilisez ces connexions partagées pendant la conception et le débogage.
- 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
Personal connections is in Public Preview.
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.
- Dans Orchestrator, accédez au dossier dans lequel la solution d'agent est déployée et ouvrez l'onglet Processus .
- Sélectionnez Modifier sur le processus d’outil qui utilise un connecteur (par exemple, un workflow d’API qui envoie des e-mails).
- 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.
- 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.
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.
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 | Compte UiPath |
| Autopilot for Everyone | 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 | Autopilot for Everyone | 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.
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 Autopilot for Everyone 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.
Comportement de la session de chat
Les Agents conversationnels maintiennent des sessions persistantes :
- Chaque conversation s’exécute en tant que processus Orchestrator dédié (actif jusqu’à 8 heures d’inactivité).
- Les sessions restent actives pour activer des réponses immédiates.
- Les sessions inactives consomment des ressources minimales.
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 :
- Exigences du dossier Orchestrator
- Identité de l’exécution
- Publier
- Étapes de publication
- Déploiement
- Étapes de déploiement
- Gestion de la connexion
- Connexions partagées
- Connexions personnelles
- Activer les connexions personnelles
- Expérience utilisateur
- Canaux de déploiement
- Vue d'ensemble du canal
- Disponibilité des fonctionnalités par canal
- Choix d’un canal
- Comportement de la session de chat
- Utilisation des outils UiPath dans des plateformes externes
- Prochaines étapes