Designing the agent

Configurer le comportement, les fonctionnalités et les intégrations de système d’entreprise d’un agent conversationnel dans Studio Web.

This page covers the design-time configuration options for conversational agents in Studio Web's Agent Builder. Use these settings to define your agent's behavior, capabilities, and integration with enterprise systems.

Creating a conversational agent in Agent Builder

1. Accédez à studio.uipath.com.
2. Sélectionnez Créer nouveau, puis sélectionnez Agent.
3. Sélectionnez Conversationnel.
4. Décrivez votre agent à Autopilot pour générer une configuration de démarrage ou sélectionnez Démarrer à zéro.

Requête système

L’invite système est la base du comportement de votre agent.Il définit le personnage, les objectifs, les contraintes et les instructions de l’agent pour gérer différents scénarios.

Ce qu'il faut inclure

Une invite système complète doit adresser :

• Identité et personnage : qui est l’agent ? Quel ton doit-il utiliser ?
• Étendue et limites : quels sujets l’agent doit-il gérer ? Que doit-il refuser ?
• Directives d’utilisation des outils : quand l’agent doit-il utiliser des outils spécifiques ?
• Critères d’escalade : quand l’agent doit-il transmettre à un humain ?
• Format de la réponse : comment l’agent doit-il structurer ses réponses ?

Exemple d’invite système

Vous êtes un assistant RH pour Contoso Corporation. Votre rôle est d'aider les employés ayant des questions sur les politiques de l'entreprise, les avantages et les procédures RH.

Directives

• Soyez professionnel, aimable et concis
• Recherchez toujours dans la base de connaissances avant de répondre aux questions de politique
• Citez des documents spécifiques lorsque vous faites référence aux politiques
• Si vous ne trouvez pas de réponse, proposez de faire remonter la question à un responsable des ressources humaines

Limites

• Ne discutez pas du rendement ou de la rémunération individuels de l'employé
• Ne faites pas de promesses concernant des dérogations aux politiques
• Redirigez les questions juridiques vers le service juridique

Utilisation d’Autopilot pour générer des invites

Autopilot peut vous aider à créer des invites système efficaces :

1. Dans la section Invite système, décrivez votre incident d'utilisation en langage naturel.
2. Autopilot génère une invite structurée en fonction de votre description.
3. Examinez et affinez l’invite générée pour qu’elle corresponde à vos exigences spécifiques.

Astuce :

Commencez par l’invite générée d'Autopilot, puis itérez en fonction des tests. Le chat Debug vous aide à identifier les lacunes dans votre invite qui doivent être corrigées.

Utilisation du score de l’agent

Le score de l’agent analyse la configuration de votre agent et fournit des recommandations d’amélioration.Le score évalue :

• Qualité de l’invite système : clarté, complétude, cohérence, chaîne de pensée et démonstrations.
• Configuration de l’outil : quantité, clarté du contexte et exhaustivité.

Pour afficher le score de votre agent :

1. Dans le concepteur de l’agent, recherchez l’indicateur Ouvrir le score de santé.
2. Sélectionnez-le pour voir des recommandations détaillées.
3. Traitez les suggestions pour améliorer l’efficacité de votre agent.

Pour des détails, reportez-vous à Score de l’agent.

Sélection du modèle

Les Agents conversationnels prennent en charge plusieurs modèles LLM (Large Language Model).Sélectionnez un modèle en fonction de vos exigences en matière de fonctionnalités, de latence et de coût.

Pour des directives sur le choix du bon modèle, reportez-vous à Choix du meilleur modèle pour votre agent.

Remarque :

Les Agents conversationnels sont disponibles avec les modèles gérés par UiPath et prennent en charge les configurations LLM de sorte que vous pouvez utiliser vos propres abonnements LLM.

Entrées

Les entrées sont des variables nommées définies sur un agent conversationnel dans Data Manager et peuvent être modèles dans l'invite système et les arguments d'appel d'outil. Utilisez des entrées lorsque la surface d'appel souhaite transmettre un contexte supplémentaire à l'agent à chaque tour, au-delà de ce qui est déjà contenu dans l'historique des conversations.

Important :

L'historique des conversations (messages de l'utilisateur, messages de l'agent et résultats passés d'appels d'outil) est déjà transmis implicitement à l'agent lors de l'exécution de chaque tour. Les entrées doivent uniquement être définies pour un contexte supplémentaire que l’agent ne peut pas dériver de la conversation elle-même. Commencez sans entrées personnalisées et introduisez-les lorsque votre cas d'utilisation spécifique les nécessite.

Comment les interfaces exposent les entrées

L'interface de conversation peut définir les valeurs d'entrée initiales lorsqu'elle démarre la conversation et peut également les mettre à jour à tout moment pendant la conversation.

• Les interfaces prédéfinies, telles que la gestion des instances et l'intégration iFrame, fournissent un formulaire dans lequel l'utilisateur remplit les valeurs d'entrée avant ou pendant la conversation.
• Le SDK UiPath TypeScript vous permet de contrôler directement la façon dont les valeurs d'entrée sont définies sur votre interface personnalisée. Par exemple, vous pouvez connecter les entrées à l'état de l'interface utilisateur Web ou à tout autre état côté client afin que l'agent reçoive automatiquement le dernier contexte de surface à chaque tour.

Outils

Les outils étendent les fonctionnalités de votre agent au-delà de la conversation.Les Agents conversationnels prennent en charge les mêmes outils que les Agents autonomes.

Types d’outil pris en charge

Type d’outil	Description	Use case
Ancrage dans le contexte	Rechercher des index de la base de connaissances	Questions et réponses basées sur RAG sur les documents
Analyser les fichiers	Traiter les fichiers chargés avec LLM	Analyse de documents, extraction de formulaires
Activités Integration Service	Connecteurs pré-créés vers des systèmes externes	Calendrier, e-mail, opérations CRM
Workflows d’API	Automatisations personnalisées basées sur l’API	Intégrations back-end
Workflows RPA	Automatisations inter-plateformes et basées sur Windows	Interactions du système hérité
Agents autonomes	Exécution de l’agent imbriquée	Tâches complexes multi-étapes
Serveurs MCP	Intégrations du protocole de contexte du modèle	Écosystèmes d’outils externes
Outils côté client	Outils exécutés sur l'interface client	Accès aux données de l'application hôte, déclenchement d'actions d'IU
Modèles Extraction et traitement intelligents (IXP)	Traitement intelligent des documents	Extraction de documents structurés

Ajout d’outils

1. Dans le concepteur d’agent, sélectionnez Ajouter un outil.
2. Choisissez le type d’outil et configurez ses paramètres.
3. Fournissez une description claire du moment et de la façon dont l’agent doit utiliser l’outil.

Pour les workflows qui effectuent exclusivement des appels d’API, utilisez des workflows d’API plutôt que des workflows RPA pour de meilleures performances dans les scénarios de chat en temps réel.

Astuce :

Si vos outils utilisent des connecteurs Integration Service, vous pouvez laisser les utilisateurs choisir leurs propres connexions au moment de l'exécution via des connexions personnelles. Cela est utile lorsque l’agent doit agir avec les propres informations d’identification de l’utilisateur, par exemple en envoyant des e-mails à partir de son compte ou en accédant à son calendrier personnel.

Descriptions des outils

Les descriptions des outils guident l’agent sur le moment où utiliser chaque outil. Écrivez des descriptions qui indiquent clairement :

• Ce que fait l’outil
• Quand l’utiliser (facultatif)

Exemple de description de l’outil

Search HR Policies: Use this tool to find information about company policies,
benefits, and HR procedures. Always use this tool before answering questions
about policies.

Garde-fous d’outils

Appliquez des garde-fous aux outils pour appliquer des politiques de Runtime.Les garde-fous peuvent :

• Restreignez le moment où un outil peut être exécuté.
• Validez les entrées avant l’exécution.
• Filtrez ou transformez les sorties.

Pour de plus amples informations, consultez la section Garde-fous.

Confirmations d'appel d'outil

Utilisez des confirmations d'appel d'outil pour les outils qui ne doivent pas s'exécuter tant que l'utilisateur n'a pas examiné l'action proposée. Par exemple, vous pouvez obtenir une confirmation avant qu'un outil crée un événement, envoie un e-mail, met à jour un enregistrement métier ou déclenche une automatisation avec des effets secondaires externes.

Pour demander la confirmation d’un outil:

1. Dans le concepteur d’agent, sélectionnez l’outil que vous souhaitez configurer.
2. Dans les paramètres des garde-fous de l'outil, activez Exiger la confirmation.
3. Enregistrez et publiez l’agent.

Lorsqu'un outil nécessite une confirmation, l'agent s'interrompt avant d'exécuter l'outil et affiche à l'utilisateur les paramètres d'entrée qu'il prévoit d'utiliser. L'utilisateur peut approuver l'appel d'outil, modifier les valeurs d'entrée avant l'approbation ou rejeter l'appel d'outil.

Au moment de l’exécution:

• Si l’utilisateur approuve sans modification, l’outil s’exécute avec les entrées d’origine proposées par l’agent.
• Si l’utilisateur modifie les entrées et approuve, l’outil s’exécute avec les entrées modifiées.
• Si l'utilisateur rejette la confirmation, l'outil ne s'exécute pas.

Remarque :

Les confirmations d’appel d’outil sont configurées par outil. Activez-les pour les actions pour lesquelles une vérification par l’utilisateur est requise avant l’exécution et laissez-les désactivées pour les outils en lecture seule ou les outils dont l’exécution automatique est sécurisée.

Context

Le contexte connecte votre agent aux index de la base de connaissances d’ancrage dans le contexte, permettant la génération augmentée par la récupération (RAG) pour des réponses précises basées sur des citations.

Ajout d'un contexte

1. Sélectionnez Add context (Ajouter un contexte).
2. Choisissez un index d’ancrage dans le contexte parmi vos index disponibles.
3. Configurez les paramètres de recherche (facultatif).

L’agent interroge automatiquement l’index lorsqu’il est pertinent pour la question de l’utilisateur et inclut des citations dans ses réponses.

Pour des détails sur la création et la gestion d’index, reportez-vous à Contextes.

Gestion des fichiers

Les Agents conversationnels peuvent traiter les fichiers chargés pendant le chat.Cela permet des cas d’utilisation tels que l’analyse de documents, le traitement des formulaires et l’interprétation d’images.

Activation des chargements de fichiers

Pour activer l’analyse de fichiers, ajoutez un outil capable de traiter des fichiers :

• Analyser les fichiers : outil intégré pour l’analyse générale des fichiers à l’aide de LLM.
• Extraction et traitement intelligents (IXP) : pour l’extraction de documents structurés.

Types de fichiers pris en charge

Type de fichier	Outil recommandé
Images (GIF, JPE, JPEG, PNG, WEBP)	Analyser les fichiers
Documents PDF	Analyser les fichiers, Extraction et traitement intelligents (IXP)

Important :

Les chargements de fichiers sont limités à 5 Mo.

Escalades

Les escalades permettent à l’agent de transmettre des conversations à un humain lorsqu’il ne peut pas résoudre une demande en toute confiance.

Fonctionnement des escalades

1. L’agent détermine qu’il a besoin d’une assistance humaine (en fonction de vos critères d’invite système).
2. L’agent crée une tâche d’escalade dans Action Center.
3. La conversation est mise en pause jusqu’à ce qu’un humain résolve l’escalade.
4. Une fois résolu, l’agent continue avec l’entrée de l’humain.

Configurer des procédures d'escalade

1. Dans le concepteur d'agent, sélectionnez Ajouter une escalade.
2. Configurez le type d’escalade.
3. N’oubliez pas de définir des critères d’escalade dans votre invite système.

Remarque :

Conversations run synchronously during escalation. The agent pauses all interaction until the escalation is resolved. If you need to launch escalations without blocking the chat, build your chat assistant in Maestro Flow instead, and run a Human Task node on a parallel branch, so the conversation keeps moving while the approval happens in the background.

Pour des détails, consultez Escalades et mémoire de l’agent.

Considérations relatives à la connexion

Lorsque votre agent utilise des outils qui s'appuient sur des connecteurs Integration Service, tenez compte de la façon dont les connexions sont gérées au moment du Runtime.

• Les connexions partagées sont configurées par des administrateurs dans un dossier Orchestrator. Les connexions partagées, configurées lors de la conception et du débogage, garantissent que l'agent a accès aux connecteurs requis après la publication.
• Les connexions personnelles (aperçu public) permettent aux utilisateurs individuels de choisir leurs propres connexions Integration Service au moment du runtime. Cela est utile lorsque l’agent doit agir avec les propres informations d’identification d’un utilisateur, par exemple en envoyant des e-mails à partir de son compte ou en accédant à son calendrier personnel.

Lors de la conception d'un agent qui prend en charge les connexions personnelles, gardez à l'esprit les éléments suivants:

• Pour activer les connexions personnelles pour les utilisateurs, chaque outil d'agent doit être configuré en suivant les instructions de configuration des connexions personnelles.
• Les outils de l'agent doivent utiliser des connecteurs qui prennent en charge les connexions personnelles (par exemple, Outlook, Slack, Salesforce).
• L'agent configure automatiquement les connexions depuis l'espace de travail personnel de l'utilisateur lorsqu'une connexion correspondante est disponible, ce qui rend la configuration transparente pour la plupart des utilisateurs.
• 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 aucune connexion personnelle n'est configurée pour un connecteur, l'agent bascule vers la connexion partagée dans le dossier Orchestrator.
• Lors de l’utilisation d’applications externes, seules les connexions de l’espace de travail personnel de l’utilisateur sont disponibles. Les connexions de dossiers partagés ne s'affichent pas.

Pour plus de détails sur la façon dont les utilisateurs configurent les connexions personnelles au moment de l'exécution, consultez Connexions personnelles.

Meilleures pratiques de conception

Commencez par un personnage clair

Définissez une identité spécifique pour votre agent plutôt que de la laisser générique. Un personnage clair aide l’agent à maintenir un ton et un comportement cohérents.

Moins efficace : « Vous êtes un Assistant utile. »Plus efficace : « Vous êtes un Assistant RH convivial pour Contoso Corporation qui se spécialise dans l’aide apportée aux employés pour comprendre les politiques et les avantages de l’entreprise. »

Concevez pour l’imprévisibilité

Les utilisateurs peuvent fournir des informations incomplètes, ambiguës ou incorrectes. Votre invite système doit demander à l’agent de :

• Posez des questions de clarification si nécessaire.
• Gérez les informations partielles avec soin.
• Récupérez des malentendus.

Guidez l’utilisation de l’outil explicitement

Ne supposez pas que l’agent sait quand utiliser des outils. Incluez des instructions explicites :

## Tool usage
- ALWAYS search the knowledge base before answering policy questions
- Use the calendar tool when the user asks about scheduling
- NEVER create calendar events without explicit user confirmation

Itérez avec des évaluations

Créez des cas de test pour les scénarios à la fois attendus (chemin heureux) et inattendus (incident périphérique).Mettez à jour la configuration de votre agent en fonction des résultats de l’évaluation.

Prochaines étapes

• Évaluation : testez le comportement de votre agent
• Déploiement : publiez et déployez votre agent

Need more advanced conversation modeling — routing, hand-off between specialist agents, or backend automations running in parallel with the conversation? See Build in Maestro Flow to model the whole chat as a conversational Flow.