Démarrer avec l’intégration de la compréhension du langage conversationnel

Cet article vous montre comment intégrer un modèle CLU à un agent.

Prerequisites

• Modèle CLU entièrement formé, y compris les intentions de toutes les rubriques système et pour toutes les rubriques personnalisées que vous souhaitez créer
• Clé et URL de prédiction pour le modèle déployé
• Nom du projet et nom du déploiement CLU
• Clé de compte pour Cognitive Services
• URL de site pour Azure AI Language
• Un compte Copilot Studio
• Un agent Copilot Studio configuré pour utiliser l’orchestration classique
• Connecteur de langage Copilot Studio configuré pour utiliser les informations d’identification fournies par le créateur

Préparer votre projet CLU

1. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.

2. Créez une ressource de langage dans Language Studio, avec la fonctionnalité Compréhension du langage courant activée.

   Pour garantir que votre agent Copilot Studio fonctionne correctement, le modèle CLU que vous créez doit avoir des intentions pour toutes les rubriques système et pour toutes les rubriques personnalisées que vous ajoutez à votre agent.

3. Définissez les entités que votre agent Copilot Studio doit utiliser.

4. Entraîner et déployer le projet CLU dans la même région que votre assistant Copilot Studio.

Préparer votre assistant

1. Accédez à la page Paramètres pour votre assistant. Les paramètres de la catégorie IA Générative s’affichent.

2. Si l’orchestration générative est activée, basculez vers l’orchestration classique : sous Orchestration, sélectionnez Non.

3. Sélectionnez Language Understanding dans le volet latéral.

4. Sélectionnez Utiliser les CLN Azure prédéfinis.

5. Si votre environnement n’est pas encore connecté à Azure AI Language ou si vous souhaitez utiliser une nouvelle connexion, sélectionnez Gérer les connexions, accédez à Power Apps et créez une connexion CLU.

6. Sélectionnez la connexion CLU souhaitée.

7. Cliquez sur Enregistrer. Une fenêtre s’affiche, vous invitant à enregistrer un instantané de votre agent avant de supprimer toutes les expressions de déclencheur existantes pour vos rubriques.

8. Sélectionnez Enregistrer l’instantané, puis enregistrez l’archive ZIP obtenue (botContent.zip), à l’emplacement souhaité. L’archive ZIP contient un seul fichier YAML (botContent.yml) avec le contenu de votre agent, y compris les expressions de déclencheur et les messages.

9. Sélectionnez Oui, supprimez mes expressions de déclencheur, puis sélectionnez Continuer.

10. Entrez les informations de nom et de déploiement de modèle pour le projet Azure AI Language approprié, puis sélectionnez Enregistrer. Une fois cette opération terminée, vous pouvez voir une nouvelle rubrique système nommée Analyser le texte. Cette rubrique est connectée à votre modèle CLU et son objectif est de reconnaître les intentions et les entités dans les conversations entre les clients et votre agent.

    Note

    La modification de la configuration de compréhension du langage pour votre assistant vers Microsoft Copilot Studio CLN supprime la rubrique système Analyser le texte. Cela vous oblige également à ajouter manuellement des exemples de phrases pour les rubriques actuellement mappées à des intentions externes.

Mapper les intentions et les entités CLU

Dans votre agent Copilot Studio, commencez à associer des rubriques existantes aux intentions CLU. Vous pouvez mapper manuellement des intentions et des entités, ou effectuer un mappage en bloc.

Mapper manuellement des intentions CLU aux rubriques

1. Accédez à la page Rubriques pour votre agent.

2. Sélectionnez la rubrique souhaitée.

3. Dans le nœud Déclencheur, sélectionnez Modifier. Le panneau Expressions s’affiche.

4. Sous Nom de l’intention, entrez le nom de l’intention CLU que vous souhaitez associer à ce sujet. Le nom de l’intention apparaît sur le nœud Déclencheur sous intention externe.

   Note

   Le nom de l’intention CLU doit être tapé exactement comme stocké dans le modèle CLU, y compris l'incident correspondant.

5. Cliquez sur Enregistrer.

6. Répétez ces étapes pour toute rubrique restante que vous souhaitez mapper à une intention CLU externe.

Mapper manuellement les entités

1. Accédez à la page Paramètres pour votre assistant.

2. Sélectionnez Entités.

3. Sélectionnez Ajouter une entité>Inscrire une entité externe.

4. Dans le panneau qui s’ouvre, entrez le nom souhaité et une description (facultatif).

5. Pour le type de données, sélectionnez À partir d’exemples de données.

6. Sélectionnez Obtenir le schéma à partir de l’exemple JSON, entrez un extrait de code JSON pour votre entité CLU, puis sélectionnez Confirmer. Recherchez des exemples d’extraits JSON lors de l’inscription d’entité pour l’intégration de la compréhension du langage courant.

7. Sélectionnez Enregistrer, puis fermez le panneau.

8. Répétez ces étapes pour toute entité restante que vous souhaitez mapper à une entité CLU externe.

Effectuer un mappage en bloc

1. Accédez à la page Paramètres pour votre assistant.

2. Sélectionnez Compréhension du langage.

3. Sélectionnez Ajouter des rubriques et des entités à partir de données de modèle. L'assistant Ajouter des intentions et des entités apparaît.

4. Sélectionnez Choisir un fichier pour sélectionner le fichier avec vos données de modèle CLU.

   Vos données de modèle s’affichent dans le volet Aperçu .

5. Cliquez sur Suivant. L’écran Mapper les rubriques existantes s’affiche.

6. Sélectionnez l’intention CLU souhaitée pour chaque rubrique.

7. Passez en revue vos sélections, puis sélectionnez Suivant. L’écran Créer de nouvelles rubriques s’affiche, affichant les intentions qui ne sont pas mappées à une rubrique existante.

8. Si vous le souhaitez, créez une rubrique pour chacune de ces intentions : sous Créer une rubrique, entrez un nom pour chaque rubrique que vous souhaitez créer.

   Note

   L’Assistant ignore tous les champs que vous laissez vides.

9. Cliquez sur Suivant. L’écran Inscrire des entités s’affiche, affichant les entités CLU de votre fichier de données de modèle.

10. Sélectionnez le type de données approprié pour les entités que vous souhaitez utiliser, puis sélectionnez Suivant. L’écran Révision s’affiche.

11. Passez en revue les mappages dans les rubriques existantes, les nouvelles rubriques et l’onglet Nouvelles entités , puis sélectionnez Enregistrer.

12. Passez en revue les informations de l’écran Réussite , puis sélectionnez Terminé.

Une fois cette procédure terminée, vous pouvez accéder à la page Rubriques pour passer en revue vos rubriques. Pour plus d’informations, voir Gérer les rubriques.

Créer une connexion CLU dans Power Apps

1. Dans Power Apps, si la page Connexions n’est pas déjà en focus, sélectionnez Connexions dans le volet gauche.

2. Sélectionnez Nouvelle connexion.

3. Sélectionnez Azure Cognitive Service for Language (utilisez le champ de recherche pour affiner la liste si nécessaire). Une fenêtre apparaît pour vous demander les informations d’authentification.

4. Pour le type d’authentification, sélectionnez Clé d’API et entrez la clé de compte requise.

5. Entrez l’URL du site racine approprié, le cas échéant.

6. Cliquez sur Créer. La nouvelle connexion, portant le nom par défaut « Azure Cognitive Service for Language », apparaît dans la liste des connexions de votre environnement.

7. Sélectionnez les trois points (⋮) en regard de cette connexion, puis sélectionnez Modifier.

8. Dans la fenêtre qui s’affiche, remplacez le nom d’affichage par défaut par autre chose, pour distinguer cette connexion des autres connexions CLU, puis sélectionnez Mettre à jour.

Contenu associé

• Vue d’ensemble de l’intégration de la compréhension du langage courant
• Enregistrement d’entité pour l’intégration de la compréhension du langage courant