Migrer de QnA Maker vers les réponses aux questions personnalisées

Notes

Vous pouvez également migrer vers Azure OpenAI.

La réponse à une question personnalisée, une fonctionnalité d’Azure AI Language, a été introduite en mai 2021 avec plusieurs nouvelles capacités, dont une meilleure pertinence à l’aide d’un ranker de Deep Learning, des réponses précises et une prise en charge régionale de bout en bout. Chaque projet de réponses aux questions personnalisées est équivalent à une base de connaissances dans QnA Maker. Vous pouvez facilement migrer des bases de connaissances d’une ressource QnA Maker vers des projets de réponses aux questions personnalisées au sein d’une ressource de langue. Vous pouvez également choisir de migrer des bases de connaissances de plusieurs ressources QnA Maker vers une ressource de langue spécifique.

Pour migrer les bases de connaissances, le compte qui effectue la migration a besoin d’un accès Contributeur à l’instance QnA Maker et à la ressource de langue sélectionnées. Quand une base de connaissances est migrée, les détails suivants sont copiés dans le nouveau projet de réponses aux questions personnalisées :

  • Paires QnA, notamment les suggestions d’apprentissage actif.
  • Synonymes et réponse par défaut de la ressource QnA Maker.
  • Le nom de la base de connaissances est copié dans le champ Description du projet.

Les paramètres au niveau des ressources, tels que le contrôle d’accès en fonction du rôle (RBAC), ne sont pas migrés vers la nouvelle ressource. Ces paramètres au niveau des ressources doivent être reconfigurés pour la ressource de langue après la migration. Vous devez également réactiver l’analytique pour la ressource de langue.

Étapes de migration des kits SDK

Ce Guide de migration de SDK est destiné à aider à la migration vers la nouvelle bibliothèque de client de réponses aux questions, Azure.AI.Language.QuestionAnswering, à partir de l’ancienne bibliothèque, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Il contient notamment des comparaisons côte à côte d’opérations similaires entre les deux packages.

Étapes de migration des bases de connaissances

Vous pouvez suivre les étapes ci-dessous pour migrer les bases de connaissances :

  1. Créez une ressource de langue avec les réponses aux questions personnalisées activées à l’avance. Lorsque vous créez la ressource de langue dans le portail Azure, vous voyez l’option permettant d’activer les réponses aux questions personnalisées. Lorsque vous sélectionnez cette option et que vous continuez, vous êtes invité à indiquer les détails de Recherche Azure pour enregistrer les bases de connaissances.

  2. Si vous souhaitez ajouter des bases de connaissances en plusieurs langues à votre ressource de langue, visitez Language Studio pour créer votre premier projet de réponses aux questions personnalisées et sélectionnez la première option, comme indiqué ci-dessous. Les paramètres de langue de la ressource de langue ne peuvent être spécifiés que lors de la création d’un projet. Si vous souhaitez migrer des bases de connaissances existantes dans une langue unique vers la ressource de langue, vous pouvez ignorer cette étape.

    Capture d’écran de l’écran Choisir la langue de l’interface utilisateur

  3. Accédez à https://www.qnamaker.ai et sélectionnez Démarrer la migration dans la note de migration de la page de la base de connaissances. Une boîte de dialogue s’ouvre pour lancer la migration.

    Bouton Démarrer la migration qui apparaît dans une bannière sur qnamaker.ai

  4. Renseignez les détails nécessaires pour lancer la migration. Le locataire est sélectionné automatiquement. Vous pouvez choisir de changer de locataire.

    Migrer QnAMaker avec la zone de sélection rouge autour de l’option de sélection de locataire

  5. Sélectionnez la ressource QnA Maker, qui contient les bases de connaissances à migrer.

    Migrer QnAMaker avec la zone de sélection rouge autour de l’option de sélection de ressource QnAMaker

  6. Sélectionnez la ressource de langue vers laquelle vous souhaitez migrer les bases de connaissances. Vous ne pouvez voir que les ressources de langue pour lesquelles des réponses aux questions personnalisées sont activées. Le paramètre de langue de la ressource de langue s’affiche dans les options. Vous ne pouvez pas migrer des bases de connaissances en plusieurs langues de ressources QnA Maker vers une ressource de langue si le paramètre de langue n’est pas spécifié.

    Migrer QnAMaker avec la zone de sélection rouge autour de l’option de ressource de langue. La ressource actuellement sélectionnée contient les informations indiquant que la langue n’est pas spécifiée

    Si vous souhaitez migrer des bases de connaissances en plusieurs langues vers la ressource de langue, vous devez activer le paramètre de langue multiple lors de la création du premier projet de réponses aux questions personnalisées pour la ressource de langue. Pour ce faire, suivez les instructions de l’étape 2. Si le paramètre de langue de la ressource de langue n’est pas spécifié, la langue de la ressource QnA Maker sélectionnée lui est attribuée.

  7. Sélectionnez toutes les bases de connaissances que vous souhaitez migrer > sélectionnez Suivant.

    Migrer QnAMaker avec la zone de sélection rouge autour de l’option de sélection de la base de connaissances avec une liste déroulante affichant trois noms de la base de connaissances

  8. Vous pouvez examiner les bases de connaissances que vous envisagez de migrer. Il peut y avoir des erreurs de validation dans les noms de projet, car nous suivons des règles de validation plus strictes pour les projets de réponses aux questions personnalisées. Pour résoudre ces erreurs qui surviennent en raison de caractères non valides, cochez la case (en rouge), puis sélectionnez Suivant. Il s’agit d’une méthode en un clic pour remplacer les caractères problématiques dans le nom par des caractères acceptés. S’il existe un doublon, un nouveau nom de projet unique est généré par le système.

    Attention

    Si vous migrez une base de connaissances portant le même nom qu’un projet qui existe déjà dans la ressource de langue cible, le contenu du projet est remplacé par le contenu de la base de connaissances sélectionnée.

    Capture d’écran d’un message d’erreur indiquant que les noms de projets ne peuvent pas contenir de caractères spéciaux

  9. Après avoir résolu les erreurs de validation, sélectionnez Démarrer la migration

    Capture d’écran avec suppression des caractères spéciaux

  10. La migration peut prendre quelques minutes. N’annulez pas la migration pendant qu’elle est en cours. Vous pouvez accéder aux projets migrés dans Language Studio après la migration.

    Capture d’écran de bases de connaissances dont la migration a abouti, montrant les informations qu’il est possible de publier à l’aide de Language Studio.

    Si la migration d’une base de connaissances vers des projets de réponses aux questions personnalisées échoue, une erreur s’affiche. Les erreurs de migration les plus courantes se produisent dans les cas suivants :

    • Vos ressources source et cible ne sont pas valides.
    • Vous essayez de migrer une base de connaissances vide.
    • Vous avez atteint la limite d’une instance Recherche Azure liée à vos ressources cibles.

    Capture d’écran d’un échec de migration avec un exemple d’erreur

    Une fois ces erreurs résolues, vous pouvez relancer la migration.

  11. La migration copie uniquement les instances de test de vos bases de connaissances. Une fois la migration terminée, vous devez déployer manuellement les bases de connaissances pour copier l’index de test dans l’index de production.

Étapes suivantes