Ressources Azure pour QnA Maker

QnA Maker utilise plusieurs sources Azure, dont chacune a un objectif différent. Comprendre comment elles sont utilisées individuellement vous permet de planifier et de sélectionner le niveau tarifaire approprié ou de savoir quand modifier celui-ci. Comprendre comment elles sont utilisées en combinaison vous permet d’épingler et de résoudre des problèmes quand ils se produisent.

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.

Planification des ressources

La première fois que vous développez une base de connaissances QnA Maker, lors de la phase prototypage, il est courant d’avoir une seule ressource QnA Maker pour les tests et la production.

Lorsque vous passez à la phase de développement du projet, vous devez prendre en compte les aspects suivants :

• Combien de langues que votre système de base de connaissances doit-il prendre en charge ?
• Dans combien de régions votre base de connaissances doit-elle être accessible ?
• Combien de documents dans chaque domaine votre système doit-il contenir ?

Prévoyez d’avoir une ressource QnA Maker unique contenant toutes les bases de connaissances ayant en commun la langue, la région et la combinaison de domaines.

Considérations relatives au niveau tarifaire

En général, il existe trois paramètres dont vous devez tenir compte :

• Débit dont vous avez besoin à partir du service :

  • sélectionnez le plan App Service approprié en fonction de vos besoins. Vous pouvez faire monter en puissance ou faire descendre en puissance l’application.
  • Ceci doit également influencer votre sélection de la référence SKU de la Recherche cognitive Azure. Voir ici pour plus d’informations. En outre, vous devrez peut-être ajuster la capacité de la Recherche cognitive capacité avec des réplicas.

• Taille et nombre de bases de connaissances : Choisissez la référence SKU Recherche Azure adaptée à votre scénario. En règle générale, vous fixez le nombre de bases de connaissances dont vous avez besoin en fonction du nombre de domaines différents. Un domaine (pour une langue) doit se trouver dans une base de connaissances.

Votre ressource de service Azure Search doit avoir été créée après le janvier 2019 et ne peut pas se trouver dans le niveau gratuit (partagé). Il n’existe aucune prise en charge pour configurer des clés gérées par le client dans le portail Azure.

Important

Vous pouvez publier N-1 bases de connaissances dans un niveau spécifique, où N correspond au nombre maximal d’index autorisé dans le niveau. Vérifiez également la taille maximale et le nombre de documents autorisés par niveau.

Par exemple, si votre niveau comporte 15 index autorisés, vous pouvez publier 14 bases de connaissances (un index par base de connaissances publiée). Le quinzième index est utilisé pour toutes les bases de connaissances à des fins de création et de test.

• Nombre de documents comme sources : la référence SKU gratuite du service de gestion QnA Maker limite à 3 le nombre de documents (d’une taille de 1 Mo chacun) que vous pouvez gérer via le portail et les API. La référence SKU Standard n’a aucune limite en termes de nombre de documents que vous pouvez gérer. Vous trouverez plus de détails ici.

Le tableau suivant vous donne des indications d’ordre général.

	Administration de QnA Maker	App Service	Azure AI Search	Limites
Expérimentation	Référence SKU Gratuite	Niveau Gratuit	Niveau Gratuit	Publier jusqu’à 2 Ko, taille de 50 Mo
Environnement Dev/Test	Référence SKU standard	Partagé	De base	Publier jusqu’à 14 Ko, taille de 2 Go
Environnement de production	Référence SKU standard	De base	standard	Publier jusqu’à 49 Ko, taille de 25 Go

Paramètres recommandés

RPS cible	App Service	Azure AI Search
3	S1, un réplica	S1, un réplica
50	S3, 10 réplicas	S1, 12 réplicas
80	S3, 10 réplicas	S3, 12 réplicas
100	P3V2, 10 réplicas	S3, 12 réplicas, 3 partitions
200 à 250	P3V2, 20 réplicas	S3, 12 réplicas, 3 partitions

Quand modifier un niveau tarifaire

Mettre à niveau	Motif
Mise à niveau de la référence SKU de gestion de QnA Maker	Vous souhaitez avoir plus de paires de questions-réponses ou sources de documents dans votre base de connaissances.
Mettre à niveau la référence SKU App Service et vérifier le niveau d’Azure AI Search et créer des réplicas de Recherche cognitive	Votre base de connaissances doit traiter plus de demandes de votre application cliente, comme un bot de conversation.
Améliorer le service Azure AI Search	Vous envisagez de disposer de nombreuses bases de connaissances.

Procurez-vous les dernières mises à jour du runtime en mettant à jour votre App Service dans le portail Azure.

Clés dans QnA Maker

Votre service QnA Maker gère deux types de clés : clés de création et clés de point de terminaison de requête utilisées avec le runtime hébergé dans App service.

Utilisez ces clés lorsque vous adressez des demandes au service via des API.

Nom	Emplacement	Objectif
Clé de création/d’abonnement	Azure portal	ces clés sont utilisées pour accéder aux API du service d’administration QnA Maker. Ces API vous permettent de modifier les questions et réponses dans votre base de connaissances, et de publier votre base de connaissances. Ces clés sont créées lorsque vous créez un service QnA Maker. Recherchez ces clés dans la ressource Azure AI services de la page Clés et point de terminaison.
Clé de point de terminaison de requête	Portail QnA Maker	Ces clés sont utilisées pour interroger le point de terminaison de base de connaissances publié afin d’obtenir une réponse à une question d’utilisateur. En général, vous utilisez ce point de terminaison de requête dans votre bot conversationnel ou dans le code de l’application cliente qui se connecte au service QnA Maker. Ces clés sont créées lorsque vous publiez votre base de connaissances QnA Maker. Recherchez ces clés dans la page Paramètres du service. Recherchez cette page à partir du menu de l’utilisateur en haut à droite de la page dans le menu déroulant.

Rechercher des clés de création dans le portail Azure

Vous pouvez afficher et réinitialiser vos clés de création à partir du portail Azure où la ressource QnA Maker a été créée.

1. Accédez à la ressource QnA Maker dans le Portail Azure, puis sélectionnez la ressource qui a le type Azure AI services :

   

2. Accédez aux clés et point de terminaison :

   

Rechercher des clés de point de terminaison de requête dans le portail QnA Maker

Le point de terminaison se trouve dans la même région que la ressource, car les clés de point de terminaison sont utilisées pour appeler la base de connaissances.

Les clés de point de terminaison peuvent être gérées à partir du portail QnA Maker.

1. Connectez-vous au portail QnA Maker, accédez à votre profil, puis sélectionnez Paramètres de service :

   

2. Affichez ou réinitialisez vos clés :

   

   Notes

   Actualisez vos clés si vous pensez qu’elles ont été compromises. Cette opération peut nécessiter des modifications correspondantes de votre code de bot ou d’application cliente.

Région du service de gestion

Le service de gestion de QnA Maker est utilisé uniquement pour le portail QnA Maker et pour le traitement initial des données. Ce service est disponible uniquement dans la région USA Ouest. Il n’y a pas de stockage de données de clients dans ce service aux USA Ouest.

Considérations relatives à l’affection de noms aux ressources

Le nom de la ressource QnA Maker, tel que qna-westus-f0-b, est également utilisé pour nommer les autres ressources.

La fenêtre Créer du portail Azure vous permet de créer une ressource QnA Maker et de sélectionner les niveaux tarifaires des autres ressources.

Une fois les ressources créées, elles portent le même nom, à l’exception de la ressource facultative Application Insights, qui ajoute des caractères à la fin du nom.

Conseil

Créez un groupe de ressources lorsque vous créez une ressource QnA Maker. Cela vous permet de voir toutes les ressources associées à la ressource QnA Maker lors d’une recherche par groupe de ressources.

Conseil

Utilisez une convention d’affectation de noms pour indiquer les niveaux tarifaires dans le nom de la ressource ou du groupe de ressources. Si vous recevez des erreurs lors de la création d’une base de connaissances ou de l’ajout de documents, la limite de niveau tarifaire de Recherche cognitive est un problème courant.

Objectifs des ressources

Chaque ressource Azure créée avec QnA Maker a un objectif spécifique :

• Ressource QnA Maker
• Ressource Recherche cognitive
• App Service
• Service de plan d’application
• Service Application Insights

Ressource QnA Maker

La ressource QnA Maker permet d’accéder aux API de création et de publication.

Paramètres de configuration de ressources QnA Maker

Lorsque vous créez une base de connaissances dans le portail QnA Maker, le paramètre Langue est le seul appliqué au niveau de la ressource. Vous sélectionnez la langue lorsque vous créez la première base de connaissances pour la ressource.

Ressource Recherche cognitive

La ressource Recherche cognitive est utilisée pour :

• Stocker les paires de questions-réponses
• fournir le classement initial (ranker #1) des paires de questions-réponses lors du runtime

Utilisation de l’index

La ressource conserve un index faisant office d’index de test. Chacun des index restants est mis en corrélation avec une base de connaissances publiée.

Une ressource tarifée pour contenir 15 index contient 14 bases de connaissances publiées, et un index est utilisé pour tester toutes les bases de connaissances. Cet index de test est partitionné par la base de connaissances afin qu’une requête utilisant le volet de test interactif utilise l’index de test, mais retourne uniquement les résultats de la partition associée à la base de connaissances.

Utilisation de la langue

La première base de connaissances créée dans la ressource QnA Maker est utilisée pour déterminer la langue unique définie pour la ressource Recherche cognitive et tous ses index. Vous ne pouvez avoir qu’une seule langue définie pour un service QnA Maker.

Utilisation d’un service Recherche cognitive unique

Si vous créez un service QnA et ses dépendances (par exemple, la recherche) via le portail, un service de recherche est créé pour vous et lié au service QnA Maker. Une fois ces ressources créées, vous pouvez mettre à jour le paramètre App Service pour utiliser un service de recherche existant au préalable et supprimer celui que vous venez de créer.

Découvrez comment configurer QnA Maker pour utiliser une ressource Azure AI services différente de celle créée lors du processus de création de ressource QnA Maker.

App service et plan App service

Votre application cliente utilise l’App service pour accéder aux bases de connaissances publiées via le point de terminaison du runtime. App Service inclut la couche de deuxième classement basée sur le traitement en langage naturel (ranker n° 2) des paires QnA au moment de l’exécution. Le deuxième classement applique des filtres intelligents qui peuvent inclure des métadonnées et des invites de suivi.

Pour interroger la base de connaissances publiée, toutes les bases de connaissances publiées utilisent le même point de terminaison d’URL, mais spécifient l’ID de la base de connaissances dans l’itinéraire.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

La fonctionnalité Application Insights est utilisée pour collecter les journaux de conversation et la télémétrie. Pour plus d’informations sur votre service, voir les requêtes Kusto communes.

Partager des services avec QnA Maker

QnA Maker crée plusieurs ressources Azure. Pour alléger la gestion et profiter du partage des coûts, utilisez le tableau suivant pour comprendre ce que vous pouvez et ne pouvez pas partager :

Service	Partager	Motif
Azure AI services	X	Impossible à la base
Plan App Service	✔	Espace disque fixe alloué à un plan App Service. Si d’autres applications qui partagent le même plan App Service utilisent une quantité d’espace disque significative, l’instance QnAMaker App Service rencontrera des problèmes.
App Service	X	Impossible à la base
Application Insights	✔	Peut être partagé
Service de recherche	✔	1. testkb est un nom réservé pour le service QnAMaker ; il ne peut pas être utilisé par d’autres. 2. Le nom de carte de synonymes synonym-map est réservé au service QnAMaker. 3. Le nombre de bases de connaissances publiées est limité par le niveau de service de recherche. Si des index gratuits sont disponibles, les autres services peuvent les utiliser.

Étapes suivantes

• En savoir plus sur la base de connaissances QnA Maker
• Comprendre un cycle de vie de base de connaissances
• Examiner les limites du service et de la base de connaissances