Ajoutez des tables Dataverse à votre agent comme source de connaissances

Lorsque vous intégrez les tables Dataverse en tant que source de connaissances, vous ancrez votre agent sur les données contenues dans vos tables. En savoir plus sur les réponses de l’agent Improve à partir de Microsoft Dataverse.

Note

Pour utiliser cette source de connaissances, Copilot Studio agents doivent utiliser la recherche Dataverse. Si vous ne pouvez pas ajouter de table Dataverse à un agent, demandez à votre administrateur d’activer la recherche Dataverse dans votre environnement. En savoir plus sur La recherche Dataverse et configurer la recherche Dataverse pour votre environnement.
Les tables Dataverse en tant que sources de connaissances vous obligent à définir l'authentification de votre agent sur Authenticate avec Microsoft. Les deux autres options, sans authentification et Authentification manuelle , ne sont pas prises en charge actuellement.
Pour ajouter des tables Dataverse comme source de connaissances, vous devez disposer des autorisations appropriées pour accéder aux données sous-jacentes. Des permissions manquantes ou insuffisantes peuvent empêcher les tables d’être visibles ou sélectionnables lors de la configuration. Pour en savoir plus, voir Attribuer un rôle de sécurité à un utilisateur.

Pour ajouter des tables Dataverse en tant que source de connaissances, procédez comme suit :

Ouvrez votre agent Copilot Studio.
Cliquez sur l’onglet Créer.
Dans le panneau composants, sélectionnez le bouton Connaissances .
Sélectionnez Ajouter des connaissances, puis Dataverse.
Localisez une ou plusieurs de vos tables Dataverse à ajouter. Vous pouvez ajouter jusqu’à 15 tables Dataverse par source de connaissances. Pour réduire vos options, utilisez le champ de recherche.

Note

Les recommandations de table sont basées sur le nom de votre agent.
Vérifiez le nom et la description de la connaissance. Fournir une description détaillée, car cette description aide l’orchestration de l’agent et l’aide à comprendre le contexte de la source de connaissances.
Sélectionnez Ajouter à l’agent pour terminer l’ajout de la source de connaissances.

Tip

Testez votre agent avec des questions que vos utilisateurs poseraient et incluez des questions nécessitant un filtrage, telles que « quels dossiers ouverts cette semaine ne sont pas encore résolus ? », plutôt qu’une seule recherche. Si les réponses sont faibles, la correction est généralement une meilleure description de connaissances, pas un tableau différent.

Préparez les tables Dataverse avec Data Workspace

Lorsque vous ajoutez des tables Dataverse comme connaissance, l’étape Select table peut inclure un lien vers Power Apps Data Workspace. Sélectionnez le lien si vous devez créer, mettre à jour ou organiser des données avant de choisir les tables pour l’agent. Data Workspace s’ouvre dans un nouvel onglet, et vous pouvez revenir à l’assistant Ajouter des connaissances lorsque vous serez prêt à sélectionner des tableaux.

Le lien n’apparaît que lorsque votre environnement dispose de la solution de préparation de données requise et que Data Workspace est activé. Si le lien n’apparaît pas, continuez avec les tables disponibles ou demandez à votre administrateur si Data Workspace est disponible dans votre environnement.

La disponibilité des fonctionnalités d’aperçu peut varier selon le locataire ou le groupe de déploiement.

Rechercher dans les colonnes de texte multiligne et de fichiers

Lorsque vous ajoutez Dataverse en tant que source de connaissances, vous pouvez appliquer un raisonnement non structuré pour obtenir des réponses de meilleure qualité à partir de colonnes Texte multiligne (MemoType) et Fichier (FileType). Par défaut, la récupération s’effectue sur les colonnes structurées d’une table. L’aperçu étend cette fonctionnalité au contenu non structuré stocké dans les colonnes Texte multiligne (MemoType) et Fichier (FileType), de sorte que les notes, les descriptions et les documents joints puissent désormais servir à répondre aux questions.

Avant d’effectuer une recherche sur des données Dataverse, vérifiez que vous répondez aux exigences suivantes :

La fonctionnalité de recherche Dataverse est activée.
Vous disposez d’un accès créateur ou administrateur (requis pour modifier les vues dans Power Apps).

Pour plus d’informations : Configurer la recherche Dataverse pour votre environnement.

Important

La création d’un index de recherche entraîne des coûts supplémentaires de capacité Dataverse. En savoir plus dans Combien coûtera la recherche Dataverse.

Configurer la table Dataverse dans Power Apps

Dans la vue Recherche rapide, incluez explicitement la table, ainsi que les colonnes Texte multiligne et Fichier comme Searchable. Pour plus d’informations : Configurer la recherche Dataverse pour votre environnement.

Connectez-vous à Power Apps et sélectionnez l’environnement souhaité.
Sélectionnez Dataverse , puis Tables.
Sélectionnez la table Dataverse que vous avez ajoutée à l’agent Copilot Studio.
Activez la fonction Searchable pour chaque colonne que vous souhaitez rechercher.
Dans le volet Expériences de données , sélectionnez Affichages.
Dans la liste des affichages, sélectionnez le type d’affichage Recherche rapide .
Sélectionnez une colonne pouvant faire l’objet d’une recherche dans la liste et ajoutez-la à l’affichage.
Sélectionnez Modifier les colonnes de recherche des tables pour ajouter des colonnes recherchables dans les options Rechercher par.
Sélectionnez Enregistrer et Publier pour publier les modifications apportées à l’affichage.

Note

Si vous ajoutez une source de connaissances Dataverse avant de configurer vos colonnes Texte multilignes et Fichier dans Power Apps, le système peut prendre jusqu’à deux jours pour compléter le traitement de la demande. Pour accélérer, envisagez d’ajouter à nouveau les connaissances Dataverse après avoir configuré le champ pour la recherche.

Limitations connues

Fonctionnalité	Limitation
Tables par source de connaissances	Actuellement, jusqu’à 15 tableaux.
Authentication	Les tables Dataverse en tant que sources de connaissances vous obligent à définir l'authentification de votre agent sur Authenticate avec Microsoft. Les deux autres options, Aucune authentification et authentification manuellement ne sont pas prises en charge.
Tables virtuelles	Seules les tables virtuelles utilisant le fournisseur de données Finance et Opérations peuvent être sélectionnées.
Pièces jointes (aperçu)	Les tableaux, images et textes dans des langages non organisationnels ne sont pas pris en charge.

Synonymes et glossaire des sources Dataverse

Lorsque vous modifiez une source de connaissances Dataverse, vous ne voyez pas de contrôles pour les synonymes et le glossaire. Les sources Dataverse utilisent les métadonnées de tableaux et les descriptions de colonnes dans Dataverse pour la correspondance en temps de recherche, donc vous n'ajoutez pas de listes de synonymes séparées ou d'entrées de glossaire dans Copilot Studio pour ces sources.

Pour améliorer la façon dont votre agent trouve les bonnes lignes dans une source Dataverse :

Ajoutez des noms de colonnes et des descriptions clairs dans la table Dataverse elle-même.
Mettez à jour le nom et la description de la source sur la puce source de connaissances afin que l’agent puisse identifier quand utiliser la source.
Testez avec des questions représentatives dans l’onglet Aperçu pour confirmer que l’agent sélectionne la source Dataverse lorsque prévu.
Utilisez des compétences pour aider votre agent à comprendre le vocabulaire courant.

Résolution des problèmes

La plupart des problèmes liés aux tables Dataverse relèvent des catégories suivantes :

Issue	Résolution
Dataverse n’est pas proposé, ou aucune table ne peut être ajoutée	Assurez-vous que la recherche Dataverse est activée dans votre environnement. Pour plus d’informations : Configurer la recherche Dataverse pour votre environnement.
Un tableau spécifique manque dans la liste	Assurez-vous d’avoir les autorisations appropriées pour accéder aux données sous-jacentes. Des permissions manquantes ou insuffisantes peuvent empêcher les tables d’être visibles ou sélectionnables lors de la configuration. Pour en savoir plus, voir Attribuer un rôle de sécurité à un utilisateur.
L’agent ignore la source et répond de façon générique	Assurez-vous que la source de connaissances a un nom et une description clairs. La description aide l’orchestration de l’agent et l’aide à comprendre le contexte de la source de connaissances. Confirmez également que l’agent utilise Authenticate avec Microsoft.
Les notes ou fichiers joints n’apparaissent jamais dans les réponses	Assurez-vous que les colonnesde texte et de fichier multiligne sont configurées comme recherchables dans la vue de recherche rapide du tableau. Pour plus d’informations : Configurer la recherche Dataverse pour votre environnement.

Lorsque Dataverse, Dynamics 365 et les sources de fichiers téléchargées ne sont pas disponibles

Si le paramètre de recherche et d’index Dataverse pour votre environnement est réglé sur un mode qui ne supporte pas la connaissance de l’agent, la boîte de dialogue Ajouter des connaissances affiche une bannière d’action admin. Tant que ce paramètre est en vigueur, les comportements de l’addition et du temps de récupération sont affectés :

Vous ne pouvez pas ajouter de nouvelles sources Dataverse, Dynamics 365 ou Fichiers chargés aux agents de l’environnement.
Les sources de ces types que vous avez ajoutées avant le changement de paramètre restent configurées sur l’agent, mais l’agent ne pourra peut-être pas les récupérer depuis elles.

Les créateurs de Copilot Studio ne peuvent pas changer ce cadre eux-mêmes. Demandez à votre administrateur de mettre à jour le paramètre de recherche et d’index Dataverse de l’environnement vers un mode qui prend en charge la connaissance de l’agent. Vous n’avez pas besoin de supprimer ou de réajouter les sources existantes — après la mise à jour du paramètre, la bannière se vide complètement, la récupération reprend, et vous pouvez ajouter de nouvelles sources.