Résolution des problèmes pour QnA Maker

La liste organisée des questions fréquentes concernant le service QnA Maker vous aidera à adopter le service plus rapidement et avec de meilleurs résultats.

Notes

Le service QnA Maker sera mis hors service le 31 mars 2025. Une version plus récente de la fonctionnalité de questions et réponses est désormais disponible dans le cadre d’Azure AI Language. Pour obtenir des réponses aux questions au sein du service de langage, consultez Réponses aux questions. À partir du 1er octobre 2022 vous ne pourrez plus créer de nouvelles ressources QnA Maker. Pour plus d’informations sur la migration de bases de connaissances QnA Maker existantes vers Réponses aux questions, consultez le Guide de migration.

Gérer les prédictions

Comment améliorer les performances de débit pour les prédictions de requête ?

Réponse : Les problèmes de performances de débit indiquent que vous devez monter en puissance pour votre service d’application et votre recherche cognitive. Envisagez d’ajouter un réplica à votre recherche cognitive pour améliorer les performances.

Apprenez-en davantage sur les niveaux tarifaires.

Comment obtenir le point de terminaison du service QnAMaker ?

Réponse : Le point de terminaison du service QnAMaker est utile pour le débogage quand vous contactez le support technique de QnAMaker ou UserVoice. Le point de terminaison est une URL qui se présente sous la forme suivante : https://your-resource-name.azurewebsites.net.

  1. Accédez à votre service QnAMaker (groupe de ressources) dans le portail Azure.

    QnAMaker Azure resource group in Azure portal

  2. Sélectionnez l’App Service associé à la ressource QnA Maker. Les noms sont généralement identiques.

    Select QnAMaker App Service

  3. L’URL du point de terminaison est disponible dans la section Vue d’ensemble.

    QnAMaker endpoint

Gestion de la base de connaissances

J’ai accidentellement supprimé une partie de mon QnA Maker, que dois-je faire ?

Réponse : Ne supprimez pas les services Azure créés avec la ressource QnA Maker, tels que la recherche ou l’application web. Ceux-ci sont nécessaires pour que QnA Maker fonctionne. Si vous en supprimez un, QnA Maker cessera de fonctionne correctement.

Toutes les suppressions sont définitives et s’appliquent notamment aux paires questions et réponses, fichiers, URL, questions et réponses personnalisées, bases de connaissances ou ressources Azure. Assurez-vous d’exporter votre base de connaissances à partir de la page Paramètres avant de supprimer la moindre de ses parties.

Pourquoi mes URL/mes fichiers n’extraient-ils pas les paires de question-réponse ?

Réponse : Il est possible que QnA Maker ne puisse pas extraire automatiquement du contenu question-réponse (QnA) à partir des URL de FAQ valides. Dans ce cas, vous pouvez coller le contenu QnA dans un fichier .txt et voir si l’outil peut l’ingérer. Vous pouvez également ajouter manuellement du contenu à votre base de connaissances par le biais du portail QnA Maker.

Quelle taille maximale peut avoir une base de connaissances ?

Réponse : La taille de la base de connaissances dépend de la référence SKU de Recherche Azure que vous choisissez lors de la création du service QnA Maker. Lisez plus d’informations ici.

Pourquoi rien ne s’affiche dans la liste déroulante quand j’essaie de créer une base de connaissances ?

Réponse : Vous n’avez encore jamais créé de services QnA Maker dans Azure. Lisez cet article pour apprendre à le faire.

Comment partager une base de connaissances avec d’autres utilisateurs ?

Réponse : Le partage fonctionne au niveau d’un service QnA Maker, autrement dit, toutes les bases de connaissances dans le service seront partagées. Lisez ici comment collaborer sur une base de connaissances.

Est-il possible de partager une base de connaissances avec un contributeur qui ne se trouve pas dans le même locataire AAD, dans le but de la modifier ?

Réponse : Le partage est basé sur le contrôle d’accès en fonction du rôle Azure. Si vous pouvez partager n’importe quelle ressource dans Azure avec un autre utilisateur, vous pouvez également partager QnA Maker.

Si vous avez un plan App Service avec cinq bases de connaissances QnAMaker. Est-il possible d’attribuer des droits de lecture/d’écriture à cinq utilisateurs différents afin que chacun d’eux ne puisse accéder qu’à une seule base de connaissances QnAMaker ?

Réponse : Vous pouvez partager l’ensemble d’un service QnAMaker, mais pas des bases de connaissances individuelles.

Comment puis-je modifier le message par défaut si aucune bonne correspondance n’est trouvée ?

Réponse : Le message par défaut fait partie des paramètres dans votre App Service.

  • Accédez à votre ressource App Service dans le portail Azure

qnamaker appservice

  • Sélectionnez l’option Paramètres.

qnamaker appservice settings

  • Modifiez la valeur du paramètre DefaultAnswer
  • Redémarrer votre App service

qnamaker appservice restart

Pourquoi mon lien SharePoint n’est-il pas extrait ?

Réponse : Pour plus d’informations, consultez la section Emplacements des sources de données.

Les mises à jour apportées à ma base de connaissances ne sont pas reflétées lors de la publication. Pourquoi ?

Réponse : Toute opération de modification, qu’elle soit effectuée dans une mise à jour de table, un test ou un paramètre, doit être enregistrée avant d’être publiée. Veillez à sélectionner le bouton Enregistrer et effectuer l’apprentissage après chaque opération de modification.

La base de connaissances prend-elle en charge les données enrichies ou le contenu multimédia ?

Réponse :

Extraction automatique de contenu multimédia pour les fichiers et URL

  • URL - Fonctionnalités de conversion HTML en Markdown limitées.
  • Fichiers - Non pris en charge

Texte de réponse dans Markdown

Une fois que les paires de Q/R sont dans la base de connaissances, vous pouvez modifier le texte Markdown d’une réponse de manière à inclure des liens vers des médias disponibles depuis des URL publiques.

QnA Maker prend-il en charge les langues autres que l’anglais ?

Réponse : Affichez plus d’informations sur les langues prises en charge.

Si vous avez du contenu dans plusieurs langues, veillez à créer un service distinct pour chaque langue.

Gérer le service

Quand dois-je redémarrer mon instance d’App Service ?

Actualisez votre instance d’App Service lorsque l’icône d’avertissement apparaît en regard du numéro de version de la base de connaissances dans le tableau Clés de point de terminaison sur la page Paramètres utilisateurpage.

J’ai supprimé mon service de recherche existant. Comment puis-je résoudre ce problème ?

Réponse : si vous supprimez un index Azure AI Search, l’opération est définitive et l’index ne peut pas être récupéré.

J’ai supprimé mon index « testkb » dans mon service de recherche. Comment puis-je résoudre ce problème ?

Réponse : Si vous avez supprimé l’index testkb dans votre service Search, vous pouvez restaurer les données à partir de la dernière base de connaissances publiée. Utilisez l’outil de récupération RestoreTestKBIndex disponible sur GitHub.

e reçois l’erreur suivante : Vérifiez si les paramètres CORS du service d’application QnA Maker autorisent https://www.qnamaker.ai ou s’il existe des restrictions réseau spécifiques à l’organisation. Comment la résoudre ?

Réponse : Dans la section API du volet du service d’application, remplacez le paramètre CORS par * ou « https://www.qnamaker.ai" ; Si cela ne résout pas le problème, recherchez d’éventuelles restrictions spécifiques à l’organisation.

Quand dois-je actualiser mes clés de point de terminaison ?

Réponse : Actualisez vos clés de point de terminaison si vous pensez qu’elles ont été compromises.

Puis-je utiliser la même ressource Azure AI Search pour des bases de connaissances utilisant plusieurs langues ?

Réponse : Pour pouvoir utiliser plusieurs langues et plusieurs bases de connaissances, l’utilisateur doit créer une ressource QnA Maker pour chaque langue. Cette opération crée un service de recherche Azure distinct par langue. La combinaison de bases de connaissances en différentes langues dans un même service de recherche Azure entraîne une détérioration de la pertinence des résultats.

Comment changer le nom de la ressource Azure AI Search utilisée par QnA Maker ?

Réponse : le nom de la ressource Azure AI Search est le nom de ressource QnA Maker avec des lettres aléatoires ajoutées à la fin. De ce fait, il est difficile de faire la distinction entre plusieurs ressources de recherche pour QnA Maker. Créez un service de recherche distinct (en le nommant comme vous le souhaitez), puis connectez-le à votre service QnA. La procédure est similaire à celle que vous devez effectuer pour mettre à niveau une Recherche Azure.

Lorsque QnA Maker retourne «Runtime Core n’est pas initialisé», comment le corriger ?

Réponse : L’espace disque pour votre App Service est peut-être plein. Étapes pour corriger l’espace disque :

  1. Dans le portail Azure, sélectionnez le service App Service de votre QnA Maker, puis arrêtez le service.

  2. Tout en restant sur App Service, sélectionnez Outils de développement, Outils avancés, puis OK. Une nouvelle fenêtre de navigateur s’ouvre.

  3. Sélectionnez Console de débogage, puis CMD pour ouvrir un outil en ligne de commande.

  4. Accédez au répertoire site/wwwroot/Data/QnAMaker/ .

  5. Supprimez tous les dossiers dont le nom commence par rd.

    Ne supprimez pas les éléments suivants :

    • Fichier KbIdToRankerMappings.txt
    • Fichier EndpointSettings.json
    • Dossier EndpointKeys
  6. Démarrez App Service.

  7. Accédez à votre base de connaissances pour vérifier qu’elle fonctionne maintenant.

Pourquoi Application Insights ne fonctionne pas ?

Réponse : Vérifiez la procédure ci-dessous et effectuez les mises à jour nécessaires pour corriger le problème :

  1. Dans Service d’application -> groupe Paramètres -> section Configuration -> Paramètres de l’application -> Nom vérifiez que le paramètre « UserAppInsightsKey » est configuré correctement et défini sur le GUID (« clé d’Instrumentation ») sous l’onglet de vue d’ensemble d’Application Insights.

  2. Dans Service d’application -> groupe Paramètres -> section « Application Insights » -> vérifiez qu’Application Insights est activé et connecté à la ressource Application Insights respective.

Application Insights est activé, mais il ne fonctionne pas correctement, pourquoi ?

Réponse : Veuillez suivre les étapes ci-dessous :

  1. Copiez la valeur de « Nom « APPINSIGHTS_INSTRUMENTATIONKEY » » dans le nom « UserAppInsightsKey » en remplaçant la valeur éventuellement présente.

  2. Si la clé « UserAppInsightsKey » n’existe pas dans les paramètres de l’application, ajoutez une nouvelle clé avec ce nom et copiez la valeur.

  3. Enregistrez-la ; cette opération redémarre automatiquement le service d’application. Cela devrait résoudre le problème.

Intégration aux autres services tels que les bots

Dois-je utiliser Bot Framework pour pouvoir utiliser QnA Maker ?

Réponse : Non, vous n’avez pas besoin d’utiliser Bot Framework avec QnA Maker. Toutefois, QnA Maker est proposé parmi plusieurs modèles dans Azure AI Bot Service. Bot Service permet le développement rapide de bot intelligent via Microsoft Bot Framework et s’exécute dans un environnement serverless.

Comment puis-je créer un bot avec QnA Maker ?

Réponse : suivez les instructions de cette documentation pour créer votre bot avec Azure AI Bot Service.

Comment faire pour utiliser une base de connaissances différente avec un Azure AI Bot Service existant ?

Réponse : Vous devez disposer des informations suivantes concernant votre base de connaissances :

  • ID de la base de connaissances.
  • Nom de sous-domaine personnalisé du point de terminaison publié de la base de connaissances, appelé host et présent dans la page Paramètres après la publication.
  • Clé de point de terminaison publié de la base de connaissances : affiché sur la page Paramètres après la publication.

Avec ces informations, accédez au service d’application de votre bot sur le portail Azure. Sous Paramètres -> Configuration -> paramètre d’application, modifiez les valeurs suivantes.

La clé de point de terminaison de la base de connaissances est étiquetée QnAAuthkey dans le service ABS.

Deux ou plusieurs applications clientes peuvent-elles partager une base de connaissances ?

Réponse : Oui, la base de connaissances peut être interrogée par un nombre quelconque de clients. Si la réponse de la base de connaissances est lente ou a expiré, envisagez de passer au niveau de service supérieur pour le service d’application associé à la base de connaissances.

Comment incorporer le service QnA Maker dans mon site web ?

Réponse : Procédez comme suit pour incorporer le service QnA Maker en tant que contrôle de conversation web dans votre site web :

  1. Créez votre bot de FAQ en suivant les instructions ici.
  2. Activez la conversation web en suivant ces étapes

Stockage des données

Où se trouve l’emplacement de stockage et quelles données sont stockées ?

Réponse :

Lorsque vous avez créé votre service QnA Maker, vous avez sélectionné une région Azure. Vos bases de connaissances et vos fichiers journaux sont stockés dans cette région.