Gérer les ressources QnA MakerManage QnA Maker resources

Avant de pouvoir créer des bases de connaissances QnA Maker, vous devez tout d’abord configurer un service QnA Maker dans Azure.Before you can create any QnA Maker knowledge bases, you must first set up a QnA Maker service in Azure. Toute personne disposant d’autorisations pour créer des ressources dans un abonnement peut configurer un service QnA Maker.Anyone with authorization to create new resources in a subscription can set up a QnA Maker service.

Veillez à bien assimiler les concepts suivants avant de créer votre ressource :A solid understanding of the following concepts is helpful before creating your resource:

Créer un nouveau service QnA MakerCreate a new QnA Maker service

Cette procédure permet de créer les ressources Azure nécessaires pour gérer le contenu de la base de connaissances.This procedure creates the Azure resources needed to manage the knowledge base content. Une fois ces étapes terminées, vous trouverez les clés d’abonnement dans la page Clés de la ressource dans la portail Azure.After you complete these steps, you'll find the subscription keys on the Keys page for the resource in the Azure portal.

  1. Connectez-vous au portail Azure et créez une ressource QnA Maker.Sign in to the Azure portal and create a QnA Maker resource.

  2. Sélectionnez Créer après avoir lu les conditions générales :Select Create after you read the terms and conditions:

    Créer un nouveau service QnA Maker

  3. Dans QnA Maker, sélectionnez les niveaux et les régions appropriés :In QnA Maker, select the appropriate tiers and regions:

    Créer un service QnA Maker - Niveau tarifaire et régions

    • Dans le champ Nom, renseignez un nom unique pour identifier ce service QnA Maker.In the Name field, enter a unique name to identify this QnA Maker service. Ce nom identifie également le point de terminaison QnA Maker auquel vos bases de connaissances seront associées.This name also identifies the QnA Maker endpoint that your knowledge bases will be associated with.

    • Choisissez l’abonnement dans lequel la ressource QnA Maker sera déployée.Choose the Subscription under which the QnA Maker resource will be deployed.

    • Sélectionnez le Niveau tarifaire pour les services d’administration de QnA Maker (portail et API de gestion).Select the Pricing tier for the QnA Maker management services (portal and management APIs). Voir plus d’informations sur la tarification des références SKU.See more details about SKU pricing.

    • Créez un nouveau Groupe de ressources (recommandé) ou utilisez un groupe de ressources existant dans lequel déployer cette ressource QnA Maker.Create a new Resource group (recommended) or use an existing one in which to deploy this QnA Maker resource. QnA Maker crée plusieurs ressources Azure.QnA Maker creates several Azure resources. Lorsque vous créez un groupe de ressources pour conserver ces ressources, vous pouvez facilement les rechercher, les gérer et les supprimer par le biais du nom du groupe de ressources.When you create a resource group to hold these resources, you can easily find, manage, and delete these resources by the resource group name.

    • Sélectionnez un Emplacement du groupe de ressources.Select a Resource group location.

    • Choisissez le Niveau tarifaire de recherche du service Recherche cognitive Azure.Choose the Search pricing tier of the Azure Cognitive Search service. Si l’option de niveau Gratuit est indisponible (semble grisée), cela signifie que vous disposez déjà d’un service gratuit déployé dans votre abonnement.If the Free tier option is unavailable (appears dimmed), it means you already have a free service deployed through your subscription. Dans ce cas, vous devrez commencer par le niveau De base.In that case, you'll need to start with the Basic tier. Consultez les Détails de la tarification du service Recherche cognitive Azure.See Azure Cognitive Search pricing details.

    • Choisissez l’emplacement de recherche où vous souhaitez déployer les index du service Recherche cognitive Azure.Choose the Search location where you want Azure Cognitive Search indexes to be deployed. Les restrictions relatives à l’emplacement de stockage des données client vous aideront à déterminer l’emplacement que vous choisissez pour la Recherche cognitive Azure.Restrictions on where customer data must be stored will help determine the location you choose for Azure Cognitive Search.

    • Dans le champ Nom de l’application, entrez un nom pour votre instance Azure App Service.In the App name field, enter a name for your Azure App Service instance.

    • Par défaut, App Service utilise le niveau Standard (S1).By default, App Service defaults to the standard (S1) tier. Vous pouvez modifier le plan après sa création.You can change the plan after creation. Consultez des informations supplémentaires sur la tarification d’App Service.Learn more about App Service pricing.

    • Choisissez l’emplacement du site web où App Service sera déployé.Choose the Website location where App Service will be deployed.

      Notes

      Emplacement de recherche peut être différent de Emplacement du site web.The Search Location can differ from the Website Location.

    • Choisissez si vous souhaitez activer Application Insights ou non.Choose whether or not you want to enable Application Insights. Si Application Insights est activé, QnA Maker collecte les données de télémétrie sur le trafic, les journaux d’activité de conversation et les erreurs.If Application Insights is enabled, QnA Maker collects telemetry on traffic, chat logs, and errors.

    • Choisissez l’emplacement d’Application Insights où la ressource Application Insights sera déployée.Choose the App insights location where the Application Insights resource will be deployed.

    • Pour réduire vos coûts, vous pouvez partager certaines des ressources Azure créées pour QnA Maker, mais pas toutes.For cost savings measures, you can share some but not all Azure resources created for QnA Maker.

  4. Une fois tous les champs validés, sélectionnez Créer.After all the fields are validated, select Create. L’exécution de ce processus peut prendre plusieurs minutes.The process can take a few minutes to complete.

  5. Une fois le déploiement terminé, vous verrez les ressources suivantes créées dans votre abonnement :After deployment is completed, you'll see the following resources created in your subscription:

    Service QnA Maker créé par une ressource

    La ressource avec le type Cognitive Services a vos clés d’abonnement.The resource with the Cognitive Services type has your subscription keys.

Rechercher des clés de création dans le portail AzureFind authoring keys in the Azure portal

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.You can view and reset your authoring keys from the Azure portal, where you created the QnA Maker resource. Ces clés sont parfois appelées clés d’abonnement.These keys may be referred to as subscription keys.

  1. Accédez à la ressource QnA Maker dans le portail Azure et sélectionnez la ressource qui a le type Cognitive Services :Go to the QnA Maker resource in the Azure portal and select the resource that has the Cognitive Services type:

    Liste des ressources QnA Maker

  2. Accédez à Clés :Go to Keys:

    Clé d’abonnement

Rechercher des clés de point de terminaison de requête dans le portail QnA MakerFind query endpoint keys in the QnA Maker portal

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.The endpoint is in the same region as the resource because the endpoint keys are used to make a call to the knowledge base.

Les clés de point de terminaison peuvent être gérées à partir du portail QnA Maker.Endpoint keys can be managed from the QnA Maker portal.

  1. Connectez-vous au portail QnA Maker, accédez à votre profil, puis sélectionnez Paramètres de service :Sign in to the QnA Maker portal, go to your profile, and then select Service settings:

    Clé de point de terminaison

  2. Affichez ou réinitialisez vos clés :View or reset your keys:

    Gestionnaire de la clé de point de terminaisonEndpoint key manager

    Notes

    Actualisez vos clés si vous pensez qu’elles ont été compromises.Refresh your keys if you think they've been compromised. Cette opération peut nécessiter des modifications correspondantes de votre code de bot ou d’application cliente.This may require corresponding changes to your client application or bot code.

Mettre à niveau la référence SKU de QnA MakerUpgrade QnA Maker SKU

Si vous souhaitez avoir plus de questions et de réponses dans votre base de connaissances, au-delà de votre niveau actuel, mettez à niveau votre niveau tarifaire du service QnA Maker.When you want to have more questions and answers in your knowledge base, beyond your current tier, upgrade your QnA Maker service pricing tier.

Pour mettre à niveau la référence SKU de gestion de QnA Maker :To upgrade the QnA Maker management SKU:

  1. Accédez à votre ressource QnA Maker dans le portail Azure et sélectionnez Niveau tarifaire.Go to your QnA Maker resource in the Azure portal, and select Pricing tier.

    Ressource QnA Maker

  2. Choisissez la référence SKU appropriée et appuyez sur Sélectionner.Choose the appropriate SKU and press Select.

    Tarification de QnA Maker

Mise à niveau du service d’applicationUpgrade App Service

Lorsque votre base de connaissances doit répondre à un plus grand nombre de demandes de votre application client, mettez à niveau le niveau tarifaire d’App Service.When your knowledge base needs to serve more requests from your client app, upgrade your App Service pricing tier.

Vous pouvez effectuer un scale-up ou un scale-out du service d’application.You can scale up or scale out App Service.

Accédez à la ressource App Service dans le portail Azure et sélectionnez l’option Scale-up ou Scale-out en fonction des besoins.Go to the App Service resource in the Azure portal, and select the Scale up or Scale out option as required.

Mise à l'échelle du service d’application QnA Maker

Mettre à niveau le service Recherche cognitive AzureUpgrade the Azure Cognitive Search service

Si vous prévoyez de disposer de plusieurs bases de connaissances, mettez à niveau votre niveau tarifaire du service Recherche cognitive Azure.If you plan to have many knowledge bases, upgrade your Azure Cognitive Search service pricing tier.

Il n’est actuellement pas possible d’effectuer une mise à niveau sur place de la référence SKU de la recherche Azure.Currently, you can't perform an in-place upgrade of the Azure search SKU. Toutefois, vous pouvez créer une ressource de recherche Azure avec la référence SKU souhaitée, restaurer les données vers la nouvelle ressource, puis la lier à la pile QnA Maker.However, you can create a new Azure search resource with the desired SKU, restore the data to the new resource, and then link it to the QnA Maker stack. Pour ce faire, procédez comme suit :To do this, follow these steps:

  1. Créez une ressource de recherche Azure dans le portail Azure et sélectionnez la référence SKU souhaitée.Create a new Azure search resource in the Azure portal, and select the desired SKU.

    Ressources de recherche QnA Maker Azure

  2. Restaurez les index de votre ressource de recherche Azure d’origine vers la nouvelle.Restore the indexes from your original Azure search resource to the new one. Consultez l’exemple de code de restauration de sauvegarde.See the backup restore sample code.

  3. Une fois que les données sont restaurées, accédez à votre nouvelle ressource de recherche Azure, sélectionnez Clés, puis notez le Nom et la Clé d’administration :After the data is restored, go to your new Azure search resource, select Keys, and write down the Name and the Admin key:

    Clés de recherche QnA Maker Azure

  4. Pour lier la nouvelle ressource de recherche Azure à la pile QnA Maker, accédez à l’instance App Service de QnA Maker.To link the new Azure search resource to the QnA Maker stack, go to the QnA Maker App Service instance.

    Instance du service d’application QnA Maker

  5. Sélectionnez Paramètres d'application et modifiez les paramètres dans les champs AzureSearchName et AzureSearchAdminKey à partir de l’étape 3.Select Application settings and modify the settings in the AzureSearchName and AzureSearchAdminKey fields from step 3.

    Paramètre de service d’application QnA Maker

  6. Redémarrez l’instance App Service.Restart the App Service instance.

    Redémarrage de l’instance d’App Service de QnA Maker

Téléchargement des dernières mises à jour du RuntimeGet the latest runtime updates

Le runtime QnAMaker fait partie de l’instance Azure App Service, qui est déployé quand vous créez un service QnAMaker dans le portail Azure.The QnAMaker runtime is part of the Azure App Service instance that's deployed when you create a QnAMaker service in the Azure portal. Des mises à jour du runtime sont effectuées régulièrement.Updates are made periodically to the runtime. L’instance QnA Maker App Service est en mode de mise à jour automatique à partir de la publication de l’extension de site d’avril 2019 (version 5+).The QnA Maker App Service instance is in auto-update mode after the April 2019 site extension release (version 5+). Cette mise à jour a déjà été conçue pour éviter le moindre temps d’arrêt pendant les mises à niveau.This update is designed to take care of ZERO downtime during upgrades.

Vous pouvez vérifier votre version actuelle à l’adresse https://www.qnamaker.ai/UserSettings.You can check your current version at https://www.qnamaker.ai/UserSettings. Si votre version est antérieure à la version 5.x, vous devez redémarrer App Service pour appliquer les dernières mises à jour :If your version is older than version 5.x, you must restart App Service to apply the latest updates:

  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 QnAMakerQnAMaker Azure resource group

  2. Sélectionnez l’instance d’App Service et ouvrez la section Vue d’ensemble.Select the App Service instance and open the Overview section.

    Instance de l’App Service QnAMakerQnAMaker App Service instance

  3. Redémarrez App Service.Restart App Service. Le processus de mise à jour doit se terminer en quelques secondes.The update process should finish in a couple of seconds. Les applications ou bots dépendants qui utilisent ce service QnAMaker ne sont pas disponibles pour les utilisateurs finaux durant le redémarrage.Any dependent applications or bots that use this QnAMaker service will be unavailable to end users during this restart period.

    Redémarrage de l’instance d’App Service de QnAMaker

Configurer QnA Maker pour utiliser une autre ressource de Recherche cognitiveConfigure QnA Maker to use different Cognitive Search resource

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.

La ressource App Service de QnA Maker utilise la ressource Recherche cognitive.QnA Maker's App Service resource uses the Cognitive Search resource. Pour modifier la ressource Recherche cognitive qu’utilise QnA Maker, vous devez modifier le paramètre sur le Portail Azure.In order to change the Cognitive Search resource used by QnA Maker, you need to change the setting in the Azure portal.

  1. Récupérez la Clé d’administration et le Nom de la ressource Recherche cognitive que QnA Maker doit utiliser.Get the Admin key and Name of the Cognitive Search resource you want QnA Maker to use.

  2. Connectez-vous au Portail Azure et recherchez l’App Service associé à votre ressource QnA Maker.Sign in to the Azure portal and find the App Service associated with your QnA Maker resource. Les deux portent le même nom.Both with have the same name.

  3. Sélectionnez Paramètres, puis Configuration.Select Settings, then Configuration. Cela permet d’afficher tous les paramètres existants de l’App Service de QnA Maker.This will display all existing settings for the QnA Maker's App Service.

    Capture d’écran du portail Azure montrant les paramètres de configuration d’App ServiceScreenshot of Azure portal showing App Service configuration settings

  4. Modifiez les valeurs des clés suivantes :Change the values for the following keys:

    • AzureSearchAdminKeyAzureSearchAdminKey
    • AzureSearchNameAzureSearchName
  5. Pour utiliser les nouveaux paramètres, vous devez redémarrer l’App Service.To use the new settings, you need to restart the App service. Sélectionnez Vue d’ensemble, puis Redémarrer.Select Overview, then select Restart.

    Capture d’écran de Portail Azure redémarrant App Service après modification des paramètres de configurationScreenshot of Azure portal restarting App Service after configuration settings change

Si vous créez un service QnA par le biais de modèles Azure Resource Manager, vous pouvez créer toutes les ressources et contrôler la création de l’App Service pour utiliser un service de recherche existant.If you create a QnA service through Azure Resource Manager templates, you can create all resources and control the App Service creation to use an existing Search service.

En savoir plus sur la configuration des paramètres de l’application App Service .Learn more about how to configure the App Service Application settings.

Configurer le paramètre d’inactivité d’App Service pour éviter le délai d’expirationConfigure App service idle setting to avoid timeout

Le service d’application, qui sert le runtime de prédiction QnA Maker pour une base de connaissances publiée, a une configuration de délai d’inactivité, qui utilise par défaut le délai d’expiration automatique si le service est inactif.The app service, which serves the QnA Maker prediction runtime for a published knowledge base, has an idle timeout configuration, which defaults to automatically timeout if the service is idle. Pour QnA Maker, cela signifie que votre API generateAnswer de runtime des prédictions expire parfois après des périodes sans trafic.For QnA Maker, this means your prediction runtime generateAnswer API occasionally times out after periods of no traffic.

Pour que l’application de point de terminaison de prédiction soit chargée même en l’absence de trafic, définissez la valeur d’inactivité sur Toujours activé.In order to keep the prediction endpoint app loaded even when there is no traffic, set the idle to always on.

  1. Connectez-vous au portail Azure.Sign in to the Azure portal.

  2. Recherchez et sélectionnez le service d’application de votre ressource QnA Maker.Search for and select your QnA Maker resource's app service. Il aura le même nom que la ressource QnA Maker, mais il aura un type différent d’App Service.It will have the same name as the QnA Maker resource but it will have a different type of App Service.

  3. Recherchez Paramètres puis sélectionnez Configuration.Find Settings then select Configuration.

  4. Dans le volet de configuration, sélectionnez Paramètres généraux, recherchez Toujours activé, puis sélectionnez Activé comme valeur.On the Configuration pane, select General settings, then find Always on, and select On as the value.

    Dans le volet de configuration, sélectionnez Paramètres généraux, puis recherchez Toujours activé, et sélectionnez la valeur Activé.On the Configuration pane, select General settings, then find Always on, and select On as the value.

  5. Sélectionnez Enregistrer pour enregistrer la configuration.Select Save to save the configuration.

  6. Vous êtes invité à redémarrer l’application pour qu’elle utilise le nouveau paramètre.You are asked if you want to restart the app to use the new setting. Sélectionnez Continuer.Select Continue.

En savoir plus sur la configuration des Paramètres généraux de l’App Service .Learn more about how to configure the App Service General settings.

Configurer App Service Environment pour héberger le service d’application QnA MakerConfigure App Service Environment to host Qna Maker App Service

App Service Environment peut être utilisé pour héberger le service d’application QnA Maker.The App Service Environment can be used to host QnA Maker app service. Si App Service Environment est interne, vous devez suivre les étapes suivantes :If the App Service Environment is internal, then you need to follow these steps:

  1. Créez un service d’application et un service Recherche Azure.Create an app service and an azure search service.
  2. Exposez le service d’application sur un DNS public et placez l’étiquette de service QnA Maker : CognitiveServicesManagement dans une liste verte ou conservez-la côté Internet.Expose the app service on a public DNS and whitelist QnA Maker service tag: CognitiveServicesManagement, or keep it internet facing.
  3. Créez une instance de service cognitif QnA Maker (Microsoft.CognitiveServices/accounts) à l’aide d’Azure Resource Manager, où le point de terminaison QnA Maker doit être défini sur App Service Environment.Create a QnA Maker cognitive service instance (Microsoft.CognitiveServices/accounts) using Azure Resource Manager, where QnA Maker endpoint should be set to App Service Environment.

Continuité d'activité avec Traffic ManagerBusiness continuity with traffic manager

L’objectif principal du plan de continuité d’activité est de créer un point de terminaison de base de connaissances résilient qui garantit qu’il n’y a aucun temps d’arrêt du bot ou de l’application qui la consomme.The primary objective of the business continuity plan is to create a resilient knowledge base endpoint, which would ensure no down time for the Bot or the application consuming it.

Plan de continuité d’activité QnA MakerQnA Maker bcp plan

L’idée générale représentée plus haut est la suivante :The high-level idea as represented above is as follows:

  1. Configurez deux services QnA Maker parallèles dans des régions Azure associées.Set up two parallel QnA Maker services in Azure paired regions.

  2. Sauvegardez votre service d'application QnA Maker principal et restaurez-le dans la configuration secondaire.Backup your primary QnA Maker App service and restore it in the secondary setup. Ainsi, les deux configurations fonctionneront avec les mêmes nom d'hôte et clés.This will ensure that both setups work with the same hostname and keys.

  3. Synchronisez les index de recherche Azure principal et secondaire. Utilisez l’exemple GitHub ici pour savoir comment sauvegarder/restaurer les index Azure.Keep the primary and secondary Azure search indexes in sync. Use the GitHub sample here to see how to backup-restore Azure indexes.

  4. Sauvegardez Application Insights avec exportation continue.Back up the Application Insights using continuous export.

  5. Une fois que les piles principale et secondaire ont été configurées, utilisez Gestionnaire de trafic pour configurer les deux points de terminaison et définir une méthode de routage.Once the primary and secondary stacks have been set up, use traffic manager to configure the two endpoints and set up a routing method.

  6. Vous devez créer un certificat Transport Layer Security (TLS), anciennement Secure Sockets Layer (SSL), pour le point de terminaison de votre gestionnaire de trafic.You would need to create a Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), certificate for your traffic manager endpoint. Liez le certificat TLS/SSL dans vos services d’application.Bind the TLS/SSL certificate in your App services.

  7. Enfin, utilisez le point de terminaison du gestionnaire de trafic dans votre bot ou dans votre application.Finally, use the traffic manager endpoint in your Bot or App.

Supprimer les ressources AzureDelete Azure resources

Si vous supprimez l’une des ressources Azure utilisées pour vos bases de connaissances QnA Maker, celles-ci ne fonctionneront plus.If you delete any of the Azure resources used for your QnA Maker knowledge bases, the knowledge bases will no longer function. Avant de supprimer des ressources, veillez à exporter vos bases de connaissances à partir de la page Paramètres.Before deleting any resources, make sure you export your knowledge bases from the Settings page.

Étapes suivantesNext steps

Découvrez-en plus sur App Service et le service de recherche.Learn more about the App service and Search service.