Résolution des problèmes pour QnA MakerTroubleshooting for 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.The curated list of the most frequently asked questions regarding the QnA Maker service will help you adopt the service faster and with better results.

Gérer les prédictionsManage predictions

Comment améliorer les performances de débit pour les prédictions de requête ?How can I improve the throughput performance for query predictions?

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.Answer: Throughput performance issues indicate you need to scale up for both your App service and your Cognitive Search. Envisagez d’ajouter un réplica à votre recherche cognitive pour améliorer les performances.Consider adding a replica to your Cognitive Search to improve performance.

Apprenez-en davantage sur les niveaux tarifaires.Learn more about pricing tiers.

Comment obtenir le point de terminaison du service QnAMaker ?How to get the QnAMaker service endpoint

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.Answer: QnAMaker service endpoint is useful for debugging purposes when you contact QnAMaker Support or UserVoice. Le point de terminaison est une URL qui se présente sous la forme suivante : https://your-resource-name.azurewebsites.net.The endpoint is a URL in this form: https://your-resource-name.azurewebsites.net.

  1. Accédez à votre service QnAMaker (groupe de ressources) dans le portail Azure.Go to your QnAMaker service (resource group) in the Azure portal

    Groupe de ressources Azure QnAMaker sur le portail Azure

  2. Sélectionnez l’App Service associé à la ressource QnA Maker.Select the App Service associated with the QnA Maker resource. Les noms sont généralement identiques.Typically, the names are the same.

    Sélectionner l’App Service QnAMaker

  3. L’URL du point de terminaison est disponible dans la section Vue d’ensemble.The endpoint URL is available in the Overview section

    Point de terminaison QnAMaker

Gestion de la base de connaissancesManage the knowledge base

J’ai accidentellement supprimé une partie de mon QnA Maker, que dois-je faire ?I accidentally deleted a part of my QnA Maker, what should I do?

Réponse : Ne supprimez pas les services Azure créés avec la ressource QnA Maker, tels que la recherche ou l’application web.Answer: Do not delete any of the Azure services created along with the QnA Maker resource such as Search or Web App. Ceux-ci sont nécessaires pour que QnA Maker fonctionne. Si vous en supprimez un, QnA Maker cessera de fonctionne correctement.These are necessary for QnA Maker to work, if you delete one, QnA Maker will stop working correctly.

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.All deletes are permanent, including question and answer pairs, files, URLs, custom questions and answers, knowledge bases, or Azure resources. Assurez-vous d’exporter votre base de connaissances à partir de la page Paramètres avant de supprimer la moindre de ses parties.Make sure you export your knowledge base from the Settings page before deleting any part of your knowledge base.

Pourquoi mes URL/mes fichiers n’extraient-ils pas les paires de question-réponse ?Why is my URL(s)/file(s) not extracting question-answer pairs?

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.Answer: It's possible that QnA Maker can't auto-extract some question-and-answer (QnA) content from valid FAQ URLs. Dans ce cas, vous pouvez coller le contenu QnA dans un fichier .txt et voir si l’outil peut l’ingérer.In such cases, you can paste the QnA content in a .txt file and see if the tool can ingest it. Vous pouvez également ajouter manuellement du contenu à votre base de connaissances par le biais du portail QnA Maker.Alternately, you can editorially add content to your knowledge base through the QnA Maker portal.

Quelle taille maximale peut avoir une base de connaissances ?How large a knowledge base can I create?

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.Answer: The size of the knowledge base depends on the SKU of Azure search you choose when creating the QnA Maker service. Lisez plus d’informations ici.Read here for more details.

Pourquoi rien ne s’affiche dans la liste déroulante quand j’essaie de créer une base de connaissances ?Why can't I see anything in the drop-down when I try to create a new knowledge base?

Réponse : Vous n’avez encore jamais créé de services QnA Maker dans Azure.Answer: You haven't created any QnA Maker services in Azure yet. Lisez cet article pour apprendre à le faire.Read here to learn how to do that.

Comment partager une base de connaissances avec d’autres utilisateurs ?How do I share a knowledge base with others?

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.Answer: Sharing works at the level of a QnA Maker service, that is, all knowledge bases in the service will be shared. Lisez ici comment collaborer sur une base de connaissances.Read here how to collaborate on a knowledge base.

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 ?Can you share a knowledge base with a contributor that is not in the same AAD tenant, to modify a knowledge base?

Réponse : Le partage est basé sur le contrôle d’accès en fonction du rôle Azure (RBAC).Answer: Sharing is based on Azure role-based access control (RBAC). Si vous pouvez partager n’importe quelle ressource dans Azure avec un autre utilisateur, vous pouvez également partager QnA Maker.If you can share any resource in Azure with another user, you can also share 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 ?If you have an App Service Plan with 5 QnAMaker knowledge bases. Can you assign read/write rights to 5 different users so each of them can access only 1 QnAMaker knowledge base?

Réponse : Vous pouvez partager l’ensemble d’un service QnAMaker, mais pas des bases de connaissances individuelles.Answer: You can share an entire QnAMaker service, not individual knowledge bases.

Comment puis-je modifier le message par défaut si aucune bonne correspondance n’est trouvée ?How can I change the default message when no good match is found?

Réponse : Le message par défaut fait partie des paramètres dans votre App Service.Answer: The default message is part of the settings in your App service.

  • Accédez à votre ressource App Service dans le portail AzureGo to your App service resource in the Azure portal

appservice qnamaker

  • Cliquez sur l’option ParamètresClick on the Settings option

paramètres d’appservice qnamaker

  • Modifiez la valeur du paramètre DefaultAnswerChange the value of the DefaultAnswer setting
  • Redémarrer votre App serviceRestart your App service

redémarrer appservice qnamaker

Pourquoi mon lien SharePoint n’est-il pas extrait ?Why is my SharePoint link not getting extracted?

Réponse : Pour plus d’informations, consultez la section Emplacements des sources de données.Answer: See Data source locations for more information.

Les mises à jour apportées à ma base de connaissances ne sont pas reflétées lors de la publication. Pourquoi ?The updates that I made to my knowledge base are not reflected on publish. Why not?

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.Answer: Every edit operation, whether in a table update, test, or setting, needs to be saved before it can be published. Veillez à cliquer sur le bouton Enregistrer et entraîner après chaque opération de modification.Be sure to click the Save and train button after every edit operation.

La base de connaissances prend-elle en charge les données enrichies ou le contenu multimédia ?Does the knowledge base support rich data or multimedia?

Réponse :Answer:

Extraction automatique de contenu multimédia pour les fichiers et URLMultimedia auto-extraction for files and URLs

  • URL - Fonctionnalités de conversion HTML en Markdown limitées.URLS - limited HTML-to-Markdown conversion capability.
  • Fichiers - Non pris en chargeFiles - not supported

Texte de réponse dans MarkdownAnswer text in 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.Once QnA pairs are in the knowledge base, you can edit an answer's markdown text to include links to media available from public URLs.

QnA Maker prend-il en charge les langues autres que l’anglais ?Does QnA Maker support non-English languages?

Réponse : Affichez plus d’informations sur les langues prises en charge.Answer: See more details about supported languages.

Si vous avez du contenu dans plusieurs langues, veillez à créer un service distinct pour chaque langue.If you have content from multiple languages, be sure to create a separate service for each language.

Gérer le serviceManage service

Quand dois-je redémarrer mon instance d’App Service ?When should I restart my app service?

Réponse : 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 de la page Paramètres utilisateur.Answer: Refresh your app service when the caution icon is next to the version value for the knowledge base in the Endpoint keys table on the User Settings page.

J’ai supprimé mon service de recherche existant. Comment puis-je résoudre ce problème ?I deleted my existing Search service. How can I fix this?

Réponse : Si vous supprimez un index Recherche cognitive Azure, l’opération est définitive et l’index ne peut pas être récupéré.Answer: If you delete an Azure Cognitive Search index, the operation is final and the index cannot be recovered.

J’ai supprimé l’index `testkb` de mon service de recherche. Comment puis-je résoudre ce problème ?I deleted my `testkb` index in my Search service. How can I fix this?

Réponse : Vos anciennes données ne peuvent pas être récupérées.Answer: Your old data can't be recovered. Créez une ressource QnA Maker, puis recréez votre base de connaissances.Create a new QnA Maker resource and create your knowledge base again.

Quand dois-je actualiser mes clés de point de terminaison ?When should I refresh my endpoint keys?

Réponse : Actualisez vos clés de point de terminaison si vous pensez qu’elles ont été compromises.Answer: Refresh your endpoint keys if you suspect that they have been compromised.

Puis-je utiliser la même ressource Recherche cognitive Azure pour des bases de connaissances utilisant plusieurs langues ?Can I use the same Azure Cognitive Search resource for knowledge bases using multiple languages?

Réponse : Pour utiliser plusieurs langues et plusieurs bases de connaissances, l’utilisateur doit créer une ressource QnA Maker pour chaque langue.Answer: To use multiple language and multiple knowledge bases, the user has to create an QnA Maker resource for each language. Cette opération crée un service de recherche Azure distinct par langue.This will create a separate Azure search service per language. 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.Mixing different language knowledge bases in a single Azure search service will result in degraded relevance of results.

Comment changer le nom de la ressource Recherche cognitive Azure utilisée par QnA Maker ?How can I change the name of the Azure Cognitive Search resource used by QnA Maker?

Réponse : Le nom de la ressource Recherche cognitive Azure est le nom de ressource QnA Maker avec des lettres aléatoires ajoutées à la fin.Answer: The name of the Azure Cognitive Search resource is the QnA Maker resource name with some random letters appended at the end. De ce fait, il est difficile de faire la distinction entre plusieurs ressources de recherche pour QnA Maker.This makes it hard to distinguish between multiple Search resources for QnA Maker. Créez un service de recherche distinct (en le nommant comme vous le souhaitez), puis connectez-le à votre service QnA.Create a separate search service (naming it the way you would like to) and connect it to your QnA Service. La procédure est similaire à celle que vous devez effectuer pour mettre à niveau une Recherche Azure.The steps are similar to the steps you need to do to upgrade an Azure search.

Quand QnA Maker retourne `Runtime core is not initialized,`, comment résoudre le problème ?When QnA Maker returns `Runtime core is not initialized,` how do I fix it?

Réponse : L’espace disque pour votre App Service est peut-être plein.Answer: The disk space for your app service might be full. Étapes pour corriger l’espace disque :Steps to fix your disk space:

  1. Dans le portail Azure, sélectionnez le service App Service de votre QnA Maker, puis arrêtez le service.In the Azure portal, select your QnA Maker's App service, then stop the service.

  2. Tout en restant sur App Service, sélectionnez Outils de développement, Outils avancés, puis OK.While still on the App service, select Development Tools, then Advanced Tools, then Go. Une nouvelle fenêtre de navigateur s’ouvre.This opens a new browser window.

  3. Sélectionnez Console de débogage, puis CMD pour ouvrir un outil en ligne de commande.Select Debug console, then CMD to open a command line tool.

  4. Accédez au répertoire site/wwwroot/Data/QnAMaker/ .Navigate to the site/wwwroot/Data/QnAMaker/ directory.

  5. Supprimez tous les dossiers dont le nom commence par rd.Remove all the folders whose name begins with rd.

    Ne supprimez pas les éléments suivants :Do not delete the following:

    • Fichier KbIdToRankerMappings.txtKbIdToRankerMappings.txt file
    • Fichier EndpointSettings.jsonEndpointSettings.json file
    • Dossier EndpointKeysEndpointKeys folder
  6. Démarrez App Service.Start the App service.

  7. Accédez à votre base de connaissances pour vérifier qu’elle fonctionne maintenant.Access your knowledge base to verify it works now.

Intégration aux autres services tels que les botsIntegrate with other services including Bots

Dois-je utiliser Bot Framework pour pouvoir utiliser QnA Maker ?Do I need to use Bot Framework in order to use QnA Maker?

Réponse : Non, vous n’avez pas besoin d’utiliser Bot Framework avec QnA Maker.Answer: No, you do not need to use the Bot Framework with QnA Maker. Toutefois, QnA Maker est proposé parmi plusieurs modèles dans  Azure Bot Service.However, QnA Maker is offered as one of several templates in Azure Bot Service. Bot Service permet le développement rapide de bot intelligent via Microsoft Bot Framework et s’exécute dans un environnement serverless.Bot Service enables rapid intelligent bot development through Microsoft Bot Framework, and it runs in a server-less environment.

Comment puis-je créer un bot avec QnA Maker ?How can I create a new bot with QnA Maker?

Réponse : Suivez les instructions de cette documentation pour créer votre bot avec Azure Bot Service.Answer: Follow the instructions in this documentation to create your Bot with Azure Bot Service.

Comment faire pour utiliser une base de connaissances différente avec un Azure Bot Service existant ?How do I use a different knowledge base with an existing Azure bot service?

Réponse : Vous devez disposer des informations suivantes concernant votre base de connaissances :Answer: You need to have the following information about your knowledge base:

  • ID de la base de connaissances.Knowledge base ID.
  • 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.Knowledge base's published endpoint custom subdomain name, known as host, found on Settings page after you publish.
  • Clé de point de terminaison publié de la base de connaissances : affiché sur la page Paramètres après la publication.Knowledge base's published endpoint key - found on Settings page after you publish.

Avec ces informations, accédez au service d’application de votre bot sur le portail Azure.With this information, go to your bot's app service in the Azure portal. Sous Paramètres -> Configuration -> paramètre d’application, modifiez les valeurs suivantes.Under Settings -> Configuration -> Application settings, change those values.

La clé de point de terminaison de la base de connaissances est étiquetée QnAAuthkey dans le service ABS.The knowledge base's endpoint key is labeled QnAAuthkey in the ABS service.

Plusieurs applications clientes peuvent-elles partager une même base de connaissances ?Can two or more client applications share a knowledge base?

Réponse : Oui, la base de connaissances peut être interrogée par un nombre quelconque de clients.Answer: Yes, the knowledge base can be queried from any number of clients. Si la réponse de la base de connaissances est lente ou expire, envisagez s’élever niveau du service d’application associé à la base de connaissances.If the response from the knowledge base appears to be slow or time out, consider upgrading the service tier for the app service associated with the knowledge base.

Comment incorporer le service QnA Maker dans mon site web ?How do I embed the QnA Maker service in my website?

Réponse : Procédez comme suit pour incorporer le service QnA Maker en tant que contrôle de conversation web dans votre site web :Answer: Follow these steps to embed the QnA Maker service as a web-chat control in your website:

  1. Créez votre bot de FAQ en suivant les instructions ici.Create your FAQ bot by following the instructions here.
  2. Activez la conversation web en suivant ces étapesEnable the web chat by following the steps here

Stockage des donnéesData storage

Où se trouve l’emplacement de stockage et quelles données sont stockées ?What data is stored and where is it stored?

Réponse :Answer:

Lorsque vous avez créé votre service QnA Maker, vous avez sélectionné une région Azure.When you create your QnA Maker service, you selected an Azure region. Vos bases de connaissances et vos fichiers journaux sont stockés dans cette région.Your knowledge bases and log files are stored in this region.