Configurer des agents dans Copilot Studio Kit

Pour tester des agents Copilot Studio personnalisés, créez un enregistrement de configuration de l’agent qui inclut les informations requises pour se connecter aux agents et exécuter des tests.

Les types de configuration suivants sont pris en charge :

• Automatisation des tests : permet de tester en bloc des agents personnalisés.
• Indicateurs de performance clés de conversation : analyse les transcriptions de conversation d'agents personnalisés sélectionnés et génère des enregistrements de KPI de conversation.
• Synchronisation de fichiers : active la synchronisation sélective du contenu à partir d’emplacements SharePoint vers la base de connaissances de l’agent personnalisé en tant que fichiers.

Vous pouvez prendre en charge plusieurs types de configuration dans un enregistrement de configuration d’agent unique. Dans la vue Configuration de l’agent, seules les sections de configuration appropriées s’affichent.

Créer un enregistrement de configuration d'agent

1. Accédez à l’application Copilot Studio Kit.

2. Accédez à Agents.

3. Créez un nouvel enregistrement de configuration d'agent.

4. Entrez les informations suivantes, requises pour tous les types de configuration :

   Nom de colonne	Obligatoire	Descriptif
   Nom	Oui	Nom de la configuration de l’agent. Le nom n’a pas besoin de correspondre à l’agent que vous ciblez.
   Type(s) de configuration	Oui	Sélectionnez un ou plusieurs types de configuration.

5. Suivez les étapes de configuration qui suivent pour chaque type de configuration que vous avez sélectionné.

Configurer un nouvel agent pour Test Automation

1. Sélectionnez Test Automation dans Type(s) de Configuration.

2. En plus de la configuration de base, fournissez les informations suivantes :

   Nom de colonne	Obligatoire	Descriptif
   Region	Oui	Région où l’agent est déployé. Requis pour cibler le point de terminaison d’API Direct Line approprié.
   Terminal de jeton	Dépend de	Si Sécurité des canaux n’est pas utilisé ni appliqué, utilisez le point de terminaison du jeton disponible dans le canal de l’application Courrier électronique.
   Sécurité du canal	Dépend de	Activez cette option si la sécurité du canal Web et Direct Line est activée pour vous assurer qu’un jeton peut être obtenu en échange d’un secret. Note: La sécurité du canal doit être activée si l’authentification utilisateur est activée.
   Emplacement Secret	Dépend de	Lorsque Channel Security est coché, choisissez l’emplacement où stocker le secret du canal Direct Line. Dataverse stocke le secret dans une colonne sécurisée, tandis qu’Azure Key Vault utilise une variable d’environnement de type secret et stocke le secret dans Azure Key Vault.
   Secret	Dépend de	Lorsque Dataverse est sélectionné comme emplacement secret, cette colonne stocke le secret du canal Direct Line.
   Variable d’environnement	Dépend de	Lorsque Key Vault est sélectionné comme emplacement secret, cette colonne stocke le nom du schéma pour la variable d’environnement de type secret qui lie le secret Azure Key Vault. Suivez les étapes de configuration des secrets dans Azure Key Vault.
   Authentification utilisateur	Dépend de	Sélectionnez Entra ID v2 si l’authentification utilisateur est requise. Pour utiliser l’authentification Microsoft, suivez les étapes décrites dans Configurer l’authentification Microsoft pour les tests de Copilot Studio Kit Remarque :Channel Security doit être activé si l’authentification de l’utilisateur est activée.
   ID du client	Dépend de	Entrez l’ID d’application (client) de l’application créée pour activer l’authentification de l’utilisateur final pour l’agent personnalisé. Pour plus d’informations, consultez Configurer l’authentification utilisateur avec l’ID Microsoft Entra.
   ID de locataire	Dépend de	Entrez l’ID de locataire de l’application créée pour activer l’authentification de l’utilisateur final pour l’agent personnalisé.
   Emplacement secret (authentification de l’utilisateur)	Dépend de	Lorsque l’authentification utilisateur est sélectionnée, choisissez l’emplacement où vous préférez stocker la clé secrète client. Dataverse stocke le secret dans une colonne sécurisée, tandis que Key Vault nécessite une variable d’environnement de type secret et stocke le secret dans Azure Key Vault.
   Clé secrète client	Dépend de	Entrez la clé secrète client que vous avez créée lors de l’activation de la prise en charge de l’authentification. Par exemple : KitAuthApp secret.
   Étendue	Dépend de	Entrez l’étendue personnalisée que vous avez créée lors de l’activation de la prise en charge de l’authentification. Utilisez le format d’URI de portée complète ; par exemple : api://1234-4567/scope.name.
   Enrichir avec Azure Application Insights	Dépend de	Activez cette option pour enrichir les résultats des tests Generative Answers avec les données de télémétrie Azure Application Insights. Note: Pour enrichir les résultats des tests à partir d’Application Insights, vous devez inscrire l’application dans le même locataire que la ressource Application Insights. La ressource Application Insights et l’application peuvent se trouver dans un autre locataire que l’agent personnalisé que vous testez. Découvrez comment inscrire l’application et obtenir les informations requises pour la ressource Application Insights. Vérifiez que l’agent personnalisé est configuré pour envoyer des données de télémétrie à la ressource Application Insights et qu’il correspond à la configuration de l’agent dans Copilot Studio Kit. En savoir plus sur la connexion de votre agent personnalisé à Application Insights.
   App Insights Client ID	Dépend de	Entrez l’ID d’application (client) de l’application qui est autorisé à lire les données à partir de la ressource Application Insights.
   ID d’application App Insights	Dépend de	Entrez l’AppId de votre ressource Application Insights. Consultez Les étapes de localisation d’AppId.
   Emplacement du secret d'App Insights	Dépend de	Choisissez l’emplacement où stocker le secret d’application Application Insights. Dataverse stocke le secret dans une colonne sécurisée, tandis qu’Azure Key Vault nécessite une variable d’environnement de type secret et stocke le secret dans Azure Key Vault.
   ID de locataire App Insights	Dépend de	Entrez l’ID de locataire de la ressource Application Insights et l’application.
   App Insights Secret	Dépend de	Lorsque Dataverse est sélectionné comme emplacement secret, cette colonne stocke le secret de l’application App Insights.
   Variable d’environnement d’App Insights	Dépend de	Lorsque Key Vault est sélectionné comme emplacement secret, cette colonne stocke le nom du schéma pour la variable d’environnement de type secret qui lie le secret d’application App Insights.
   Enrichir avec des transcriptions de conversation	Non	Activez cette option pour enrichir les résultats des tests avec les données des transcriptions de conversation stockées dans Dataverse. Note: Pour que Copilot Studio Kit récupère les enregistrements de transcription de conversation à partir d’autres environnements Power Platform, la connexion Microsoft Dataverse utilisée lors de la configuration de la solution doit avoir Read accès aux ConversationTranscript enregistrements de table dans les environnements cibles. Vous pouvez uniquement cibler des environnements au sein du même locataire.
   Dataverse URL	Dépend de	Lorsque l’option Enrichir avec les transcriptions de conversation est activée, entrez l’URL de l’environnement Dataverse (par exemple). https://org123.crm.dynamics.com Vous pouvez obtenir l’URL dans Copilot Studio à partir des paramètres () en sélectionnant les détails de session. Recherchez l’URL de l’instance.
   Copier la transcription complète	Non	Lorsque l’option Enrichir avec les transcriptions de conversation est activée, cette option copie le json de transcription de conversation complet sous forme de pièce jointe à l’enregistrement de résultat de test pour une analyse plus approfondie.
   Analyser les réponses générées	Non	Lorsque vous activez cette option, un modèle de langage volumineux (LLM) analyse les tests générés par l’IA. Il compare la réponse à un exemple de réponse ou d’instructions de validation.
   Fournisseur d’IA générative	Dépend de	Lorsque l'analyse des réponses générées est activée, spécifiez le modèle LLM utilisé pour l’analyse. Note: Actuellement, seul AI Builder est pris en charge.

3. Cliquez sur Enregistrer.

Configurer un nouvel agent pour les indicateurs de performance clés de la conversation

1. Sélectionnez KPIs de conversation dans types de configuration.

2. En plus de la configuration de base, fournissez les informations suivantes :

   Nom de colonne	Obligatoire	Descriptif
   Dataverse URL	Oui	URL dataverse où se trouvent les transcriptions de conversation et l’agent. Par exemple : https://organizationname.crm.dynamics.com
   ID d’assistant	Oui	ID de bot de l’agent personnalisé que vous ciblez. Vous trouverez cette valeur dans Copilot Studio à partir des paramètres () en sélectionnant les détails de session. Recherche l’ID Copilot.
   Copier la transcription complète	Non	Obligatoire si vous souhaitez inspecter la conversation dans le visualiseur de transcription (onglet Transcription sur l’enregistrement de l’indicateur de performance clé de la conversation). Lorsque cette option est activée, la transcription complète de la conversation est copiée et associée à l’enregistrement KPI.
   Variables suivies	Non	Vous pouvez spécifier jusqu’à cinq variables personnalisées à suivre à partir des conversations (par exemple, score net promoteur personnalisé ou NPS). Le format est un tableau JSON. Exemple : [ Activity. Channel, Activity.Type ]
   Composants de l’agent	Non	Champ en lecture seule rempli avec les composants de l’agent spécifiés, tels que les rubriques, les sources de connaissances, etc.

3. Cliquez sur Enregistrer.

Configurer un nouvel agent pour la synchronisation de fichiers

1. Sélectionnez Synchronisation de fichiers à partir du ou des types de configuration.

2. Entrez les informations suivantes en plus de la configuration de base :

   Nom de la colonne	Obligatoire	Descriptif
   ID de l’agent (ID de bot)	Oui	ID de bot de l’agent personnalisé que vous ciblez. Vous trouverez cet ID dans Copilot Studio à partir des paramètres () en sélectionnant les détails de la session. Recherchez l’ID Copilot.
   Dataverse URL	Oui	URL dataverse où se trouve l’agent personnalisé et le contenu est synchronisé. Par exemple : https://organizationnname.crm.dynamics.com. Obtenez l’URL dans Copilot Studio à partir des détails de la session. Recherchez l’URL de l’instance.

3. Ajoutez au moins une configuration d’indexeur de fichiers et entrez les informations suivantes :

   Nom de la colonne	Obligatoire	Descriptif
   Nom	Oui	Nom de la configuration de l’indexeur de fichiers. Par exemple : documents RH.
   Configuration de l’assistant	Oui	Configuration de l’agent auquel appartient cet enregistrement. Cette valeur est automatiquement remplie si vous créez un enregistrement via la vue de configuration de l’agent.
   Adresse du site	Oui	Adresse du site SharePoint à partir duquel vous synchronisez le contenu. Par exemple : https://organizationname.sharepoint.com/sites/sitename
   Nom de la bibliothèque	Oui	Bibliothèque dans le site SharePoint à partir duquel vous synchronisez le contenu. Exemple : Documents
   Inclure des éléments imbriqués	Oui	Spécifie si la synchronisation de contenu est limitée à l’emplacement exact que vous spécifiez (Non) ou si les éléments enfants de cet emplacement sont également inclus dans la synchronisation (Oui, par défaut).
   Limiter les entrées au dossier	Non	Spécifiez éventuellement un dossier dans la bibliothèque à synchroniser. Exemple : /HR-documents
   Requête de filtre de fichiers SharePoint	Non	Spécifiez éventuellement des filtres à utiliser lors de la sélection de fichiers à synchroniser. Laissez vide pour aucun filtrage supplémentaire. Exemple : PublicContent eq 'true'
   Inclure des pages SharePoint	Non	Incluez éventuellement des pages SharePoint dans la synchronisation.
   Requête de filtre de pages SharePoint	Non	Spécifiez éventuellement des filtres à utiliser lors de la sélection de pages à synchroniser. Laissez vide pour aucun filtrage supplémentaire. Exemple : PublicContent eq 'true'

4. Si vous le souhaitez, vous pouvez valider votre configuration de l’indexeur de fichiers en sélectionnant Valider la connexion dans la barre de commandes.

5. Cliquez sur Enregistrer.

Étape suivante