Ressources Azure pour QnA MakerAzure resources for QnA Maker

QnA Maker utilise plusieurs sources Azure, dont chacune a un objectif différent.QnA Maker uses several Azure sources, each with a different purpose. 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.Understanding how they are used individually allows you to plan for and select the correct pricing tier or know when to change your pricing tier. Comprendre comment elles sont utilisées en combinaison vous permet d’épingler et de résoudre des problèmes quand ils se produisent.Understanding how they are used in combination allows you to find and fix problems when they occur.

Planification des ressourcesResource planning

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.When you first develop a QnA Maker knowledge base, in the prototype phase, it is common to have a single QnA Maker resource for both testing and production.

Lorsque vous passez à la phase de développement du projet, vous devez prendre en compte les aspects suivants :When you move into the development phase of the project, you should consider:

  • nombre de langues que votre système de base de connaissances doit prendre en charge ;how many languages your knowledge base system will hold
  • nombre de régions dans lesquelles ou à partir desquelles votre base de connaissances doit être accessible ;how many regions you need your knowledge base to be available in/from
  • nombre de documents dans chaque domaine que votre système doit contenir.how many documents in each domain your system will hold

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.Plan to have a single QnA Maker resource hold all knowledge bases that have the same language, the same region and the same subject domain combination.

Considérations relatives au niveau tarifairePricing tier considerations

En général, il existe trois paramètres dont vous devez tenir compte :Typically there are three parameters you need to consider:

  • Débit dont vous avez besoin à partir du service :The throughput you need from the service:

    • sélectionnez le plan App Service approprié en fonction de vos besoins.Select the appropriate App Plan for your App service based on your needs. Vous pouvez faire monter en puissance ou faire descendre en puissance l’application.You can scale up or down the App.
    • Ceci doit également influencer votre sélection de la référence SKU de la Recherche cognitive Azure. Voir ici pour plus d’informations.This should also influence your Azure Cognitive Search SKU selection, see more details here. En outre, vous devrez peut-être ajuster la capacité de la Recherche cognitive capacité avec des réplicas.Additionally, you may need to adjust Cognitive Search capacity with replicas.
  • Taille et nombre de bases de connaissances : Choisissez la référence SKU Recherche Azure adaptée à votre scénario.Size and the number of knowledge bases: Choose the appropriate Azure search SKU for your scenario. 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.Typically, you decide number of knowledge bases you need based on number of different subject domains. Un domaine (pour une langue) doit se trouver dans une base de connaissances.Once subject domain (for a single language) should be in one knowledge base.

    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.You can publish N-1 knowledge bases in a particular tier, where N is the maximum indexes allowed in the tier. Vérifiez également la taille maximale et le nombre de documents autorisés par niveau.Also check the maximum size and the number of documents allowed per tier.

    Par exemple, si votre niveau comporte 15 index autorisés, vous pouvez publier 14 bases de connaissances (1 index par base de connaissances publiée).For example, if your tier has 15 allowed indexes, you can publish 14 knowledge bases (1 index per published knowledge base). Le quinzième index est utilisé pour toutes les bases de connaissances à des fins de création et de test.The fifteenth index is used for all the knowledge bases for authoring and testing.

  • 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.Number of documents as sources: The free SKU of the QnA Maker management service limits the number of documents you can manage via the portal and the APIs to 3 (of 1 MB size each). La référence SKU Standard n’a aucune limite en termes de nombre de documents que vous pouvez gérer.The standard SKU has no limits to the number of documents you can manage. Vous trouverez plus de détails ici.See more details here.

Le tableau suivant vous donne des indications d’ordre général.The following table gives you some high-level guidelines.

Administration de QnA MakerQnA Maker Management App ServiceApp Service Recherche cognitive AzureAzure Cognitive Search LimitesLimitations
ExpérimentationExperimentation Référence SKU GratuiteFree SKU Niveau GratuitFree Tier Niveau GratuitFree Tier Publier jusqu’à 2 Ko, taille de 50 MoPublish Up to 2 KBs, 50 MB size
Environnement de test/développementDev/Test Environment Référence SKU standardStandard SKU PartagéShared De baseBasic Publier jusqu’à 14 Ko, taille de 2 GoPublish Up to 14 KBs, 2 GB size
Environnement de productionProduction Environment Référence SKU standardStandard SKU De baseBasic StandardStandard Publier jusqu’à 49 Ko, taille de 25 GoPublish Up to 49 KBs, 25 GB size
RPS cibleTarget QPS App ServiceApp Service Recherche cognitive AzureAzure Cognitive Search
33 S1, 1 instanceS1, 1 Instance S1, 1 instanceS1, 1 Instance
5050 S3, 10 instancesS3, 10 Instances S1, 12 instancesS1, 12 Instances
8080 S3, 10 instancesS3, 10 Instances S3, 12 instancesS3, 12 Instances
100100 P3V2, 10 instancesP3V2, 10 Instances S3, 12 instances, 3 partitionsS3, 12 Instances, 3 Partitions
200 à 250200 to 250 P3V2, 20 instancesP3V2, 20 Instances S3, 12 instances, 3 partitionsS3, 12 Instances, 3 Partitions

Quand modifier un niveau tarifaireWhen to change a pricing tier

Mettre à niveauUpgrade MotifReason
Mise à niveau de la référence SKU de gestion de QnA MakerUpgrade QnA Maker management SKU Vous souhaitez avoir plus de paires de questions-réponses ou sources de documents dans votre base de connaissances.You want to have more QnA pairs or document sources in your knowledge base.
Mettre à niveau la référence SKU App Service et vérifier le niveau de la Recherche cognitive et créer des réplicas de Recherche cognitiveUpgrade App Service SKU and check Cognitive Search tier and create Cognitive Search replicas Votre base de connaissances doit traiter plus de demandes de votre application cliente, comme un bot de conversation.Your knowledge base needs to serve more requests from your client app, such as a chat bot.
Mettre à niveau le service Recherche cognitive AzureUpgrade Azure Cognitive Search service Vous envisagez de disposer de nombreuses bases de connaissances.You plan to have many knowledge bases.

Procurez-vous les dernières mises à jour du runtime en mettant à jour votre App Service dans le portail Azure.Get the latest runtime updates by updating your App Service in the Azure portal.

Considérations relatives à l’affection de noms aux ressourcesResource naming considerations

Le nom de la ressource QnA Maker, tel que qna-westus-f0-b, est également utilisé pour nommer les autres ressources.The resource name for the QnA Maker resource, such as qna-westus-f0-b, is also used to name the other resources.

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.The Azure portal create window allows you to create a QnA Maker resource and select the pricing tiers for the other resources.

Capture d’écran du Portail Azure pour la création de ressource QnA MakerScreenshot of Azure portal for QnA Maker resource creation

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.After the resources are created, they have the same name, except for the optional Application Insights resource, which postpends characters to the name.

Capture d’écran de la liste des ressources sur le portail AzureScreenshot of Azure portal resource listing

Conseil

Créez un groupe de ressources lorsque vous créez une ressource QnA Maker.Create a new resource group when you create a QnA Maker resource. Cela vous permet de voir toutes les ressources associées à la ressource QnA Maker lors d’une recherche par groupe de ressources.That allows you to see all resources associated with the QnA Maker resource when searching by resource group.

Conseil

Utilisez une convention d’affectation de noms pour indiquer les niveaux tarifaires dans le nom de la ressource ou du groupe de ressources.Use a naming convention to indicate pricing tiers within the name of the resource or the resource group. 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.When you receive errors from creating a new knowledge base, or adding new documents, the Cognitive Search pricing tier limit is a common issue.

Objectifs des ressourcesResource purposes

Chaque ressource Azure créée avec QnA Maker a un objectif spécifique :Each Azure resource created with QnA Maker has a specific purpose:

  • Ressource QnA MakerQnA Maker resource
  • Ressource Recherche cognitiveCognitive Search resource
  • App ServiceApp Service
  • Service de plan d’applicationApp Plan Service
  • Service Application InsightsApplication Insights Service

Ressource Recherche cognitiveCognitive Search resource

La ressource Recherche cognitive est utilisée pour :The Cognitive Search resource is used to:

  • Stocker les paires de questions-réponsesStore the QnA pairs
  • fournir le classement initial (ranker #1) des paires de questions-réponses lors du runtimeProvide the initial ranking (ranker #1) of the QnA pairs at runtime

Utilisation de l’indexIndex usage

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.The resource keeps one index to act as the test index and the remaining indexes correlate to one published knowledge base each.

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.A resource priced to hold 15 indexes, will hold 14 published knowledge bases, and one index is used for testing all the knowledge bases. 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.This test index is partitioned by knowledge base so that a query using the interactive test pane will use the test index but only return results from the specific partition associated with the specific knowledge base.

Utilisation de la langueLanguage usage

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.The first knowledge base created in the QnA Maker resource is used to determine the single language set for the Cognitive Search resource and all its indexes. Vous ne pouvez avoir qu’une seule langue définie pour un service QnA Maker.You can only have one language set for a QnA Maker service.

Ressource QnA MakerQnA Maker resource

La ressource QnA Maker donne accès aux API de création et de publication, ainsi qu’à la deuxième couche de classement (ranker #2) basé sur le traitement en langage naturel des paires de questions-réponses au moment de l’exécution.The QnA Maker resource provides access to the authoring and publishing APIs as well as the natural language processing (NLP) based second ranking layer (ranker #2) of the QnA pairs at runtime.

Le deuxième classement applique des filtres intelligents qui peuvent inclure des métadonnées et des invites de suivi.The second ranking applies intelligent filters that can include metadata and follow-up prompts.

Paramètres de configuration de ressources QnA MakerQnA Maker resource configuration settings

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.When you create a new knowledge base in the QnA Maker portal, the Language setting is the only setting that is applied at the resource level. Vous sélectionnez la langue lorsque vous créez la première base de connaissances pour la ressource.You select the language when you create the first knowledge base for the resource.

App service et plan App serviceApp service and App service plan

Votre application cliente utilise l’App service pour accéder aux bases de connaissances publiées via le point de terminaison du runtime.The App service is used by your client application to access the published knowledge bases via the runtime endpoint.

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.To query the published knowledge base, all published knowledge bases use the same URL endpoint, but specify the knowledge base ID within the route.

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

Application InsightsApplication Insights

La fonctionnalité Application Insights est utilisée pour collecter les journaux de conversation et la télémétrie.Application Insights is used to collect chat logs and telemetry. Pour plus d’informations sur votre service, voir les requêtes Kusto communes.Review the common Kusto queries for information about your service.

Partager des services avec QnA MakerShare services with QnA Maker

QnA Maker crée plusieurs ressources Azure.QnA Maker creates several Azure resources. 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 :To reduce management and benefit from cost sharing, use the following table to understand what you can and can't share:

ServiceService PartagerShare MotifReason
Cognitive ServicesCognitive Services XX Impossible à la baseNot possible by design
Plan App ServiceApp Service plan Espace disque fixe alloué à un plan App Service.Fixed disk space allocated for an App Service plan. 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.If other apps that sharing the same App Service plan use significant disk space, the QnAMaker App Service instance will encounter problems.
App ServiceApp Service XX Impossible à la baseNot possible by design
Application InsightsApplication Insights Peut être partagéCan be shared
Service de rechercheSearch service 1. testkb est un nom réservé pour le service QnAMaker ; il ne peut pas être utilisé par d’autres.1. testkb is a reserved name for the QnAMaker service; it can't be used by others.
2. Le nom de carte de synonymes synonym-map est réservé au service QnAMaker.2. Synonym map by the name synonym-map is reserved for the QnAMaker service.
3. Le nombre de bases de connaissances publiées est limité par le niveau de service de recherche.3. The number of published knowledge bases is limited by Search service tier. Si des index gratuits sont disponibles, les autres services peuvent les utiliser.If there are free indexes available, other services can use them.

Utilisation d’un service Recherche cognitive uniqueUsing a single Cognitive Search service

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.If you create a QnA service and its dependencies (such as Search) through the portal, a Search service is created for you and linked to the QnA Maker service. 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.After these resources are created, you can update the App Service setting to use a previously existing Search service and remove the one you just created.

Découvrez comment configurer QnA Maker pour utiliser une ressource Service cognitif différente de celle créée dans le cadre du processus de création de ressource QnA Maker.Learn how to configure QnA Maker to use a different Cognitive Service resource than the one created as part of the QnA Maker resource creation process.

Région du service de gestionManagement service region

Le service de gestion de QnA Maker est utilisé uniquement pour le portail QnA Maker et pour le traitement initial des données.The management service of QnA Maker is used only for the QnA Maker portal and for initial data processing. Ce service est disponible uniquement dans la région USA Ouest.This service is available only in the West US region. Il n’y a pas de stockage de données de clients dans ce service aux USA Ouest.No customer data is stored in this West US service.

Clés dans QnA MakerKeys in 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.Your QnA Maker service deals with two kinds of keys: authoring keys and query endpoint keys used with the runtime hosted in the App service.

Si vous recherchez votre clé d’abonnement, la terminologie a changé.If you are looking for your subscription key, the terminology has changed.

Utilisez ces clés lorsque vous adressez des demandes au service via des API.Use these keys when making requests to the service through APIs.

Gestion des clés

NomName EmplacementLocation ObjectifPurpose
Clé de créationAuthoring key Azure portalAzure portal ces clés sont utilisées pour accéder aux API du service d’administration QnA Maker.These keys are used to access the QnA Maker management service APIs. Ces API vous permettent de modifier les questions et réponses dans votre base de connaissances, et de publier votre base de connaissances.These APIs let you edit the questions and answers in your knowledge base, and publish your knowledge base. Ces clés sont créées lorsque vous créez un service QnA Maker.These keys are created when you create a new QnA Maker service.

Recherchez ces clés dans la ressource Cognitive Services de la page Clés.Find these keys on the Cognitive Services resource on the Keys page.
Clé de point de terminaison de requêteQuery endpoint key Portail QnA MakerQnA Maker portal 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.These keys are used to query the published knowledge base endpoint to get a response for a user question. 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.You typically use this query endpoint in your chat bot or in the client application code that connects to the QnA Maker service. Ces clés sont créées lorsque vous publiez votre base de connaissances QnA Maker.These keys are created when you publish your QnA Maker knowledge base.

Recherchez ces clés dans la page Paramètres du service.Find these keys in the Service settings page. Recherchez cette page à partir du menu de l’utilisateur en haut à droite de la page dans le menu déroulant.Find this page from the user's menu in the upper right of the page on the drop-down menu.

Clés d’abonnementSubscription keys

Les expressions clé de création et clé de point de terminaison de requête sont rectificatives.The terms authoring and query endpoint key are corrective terms. L’expression utilisée précédemment était clé d’abonnement.The previous term was subscription key. Si vous lisez une autre documentation faisant référence à des clés d’abonnement, celles-ci correspondent aux clés de création et de point de terminaison de requête (utilisées dans le runtime).If you see other documentation referring to subscription keys, these are equivalent to authoring and query endpoint keys (used in the runtime).

Pour savoir quelle clé vous devez trouver, vous devez savoir à quoi la clé permet d’accéder, à la gestion de la base de connaissances ou à l’interrogation de la base de connaissances.You must know what the key is accessing, knowledge base management or knowledge base querying, to know which key you need to find.

  • Protégez la ressource Cognitive Services contre l’accès public en configurant le réseau virtuel.Protect Cognitive Service Resource from public access by configuring the virtual network.
  • Protégez App Service (Runtime QnA) contre l’accès public :Protect App Service (QnA Runtime) from public access:
    • Autorisez le trafic uniquement à partir des adresses IP Cognitive Services.Allow traffic only from Cognitive Service IPs. Celles-ci sont déjà incluses dans l’étiquette de service « CognitiveServicesManagement ».These are already included in Service Tag "CognitiveServicesManagement". Les API de création (création/mise à jour de base de connaissances) peuvent ainsi appeler le service d’application et mettre à jour le service Recherche Azure en conséquence.This is required for Authoring APIs (Create/Update KB) to invoke the app service and update Azure Search service accordingly.
    • Assurez-vous que vous autorisez également d’autres points d’entrée, tels que Bot Service ou le portail QnA Maker (éventuellement votre réseau d’entreprise), pour accéder à l’API de prédiction « GenerateAnswer ».Make sure you also allow other entry points like Bot service, QnA Maker portal (may be your corpnet) etc. for prediction "GenerateAnswer" API access.
    • Consultez d’autres informations sur les étiquettes de service.Check out more information about service tags.

Étapes suivantesNext steps