Démarrage rapide : Créer, entraîner et publier votre base de connaissances QnA MakerQuickstart: Create, train, and publish your QnA Maker knowledge base

Vous pouvez créer une base de connaissances QnA Maker à partir de votre propre contenu, tel que des Questions fréquentes (FAQ) ou des manuels.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. Cet article inclut un exemple de création d’une base de connaissances QnA Maker à partir d’une simple page web de questions fréquentes (FAQ), pour répondre à des questions sur QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

PrérequisPrerequisites

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.
  • Une ressource QnA Maker créée dans le portail Azure.A QnA Maker resource created in the Azure portal. Rappelez-vous l’ID Azure Active Directory, l’abonnement et le nom de ressource QnA que vous avez sélectionnés au moment de créer la ressource.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Créer votre première base de connaissances QnA MakerCreate your first QnA Maker knowledge base

  1. Connectez-vous au portail QnAMaker.ai avec vos informations d’identification Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. Dans le portail QnA Maker, sélectionnez Créer une base de connaissances.In the QnA Maker portal, select Create a knowledge base.

  3. Dans la page Créer, ignorez l’étape 1 si vous disposez déjà de votre ressource QnA Maker.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Si vous n’avez pas encore créé la ressource, sélectionnez Créer un service QnA.If you haven't created the resource yet, select Create a QnA service. Vous êtes dirigé vers le portail Azure pour configurer un service QnA Maker dans votre abonnement.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Rappelez-vous l’ID Azure Active Directory, l’abonnement et le nom de ressource QnA que vous avez sélectionnés au moment de créer la ressource.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    Lorsque vous avez terminé de créer la ressource dans le portail Azure, revenez au portail QnA Maker, actualisez la page du navigateur et passez à l’étape 2.When you are done creating the resource in the Azure portal, return to the QnA Maker portal, refresh the browser page, and continue to Step 2.

  4. À l’étape 3, sélectionnez votre annuaire Active Directory, votre abonnement, votre service (ressource) et la langue de toutes les bases de connaissances créées dans le service.In Step 3, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Capture d’écran de la sélection d’une base de connaissances du service QnA Maker

  5. À l’étape 3, nommez votre base de connaissances My Sample QnA KB.In Step 3, name your knowledge base My Sample QnA KB.

  6. À l’étape 4, configurez les paramètres à l’aide du tableau suivant :In Step 4, configure the settings with the following table:

    ParamètreSetting ValeurValue
    Enable multi-turn extraction from URLs, .pdf or .docx files (Activer l’extraction multitour à partir d’URL, de fichier .pdf ou .docx)Enable multi-turn extraction from URLs, .pdf or .docx files. ActivéChecked
    Texte de réponse par défautDefault answer text Quickstart - default answer not found.
    + Ajouter une URL+ Add URL https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting
    Échange de conversation (chit-chat)Chit-chat Sélectionnez Professional.Select Professional
  7. À l’étape 5, sélectionnez Create your KB (Créer votre base de connaissances).In Step 5, Select Create your KB.

    Le processus d’extraction prend quelques minutes pour lire le document et identifier les questions et réponses.The extraction process takes a few moments to read the document and identify questions and answers.

    Une fois que QnA Maker a créé la base de connaissances, la page Knowledge base (Base de connaissances) s’ouvre.After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. Vous pouvez modifier le contenu de la base de connaissances dans cette page.You can edit the contents of the knowledge base on this page.

Ajouter une nouvelle série de questions et réponsesAdd a new question and answer set

  1. Sur le portail QnA Maker, dans la page Edit (Modifier), sélectionnez + Add QnA pair (Ajouter une paire QnA) dans la barre d’outils contextuelle.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  2. Ajoutez la question suivante :Add the following question:

    How many Azure services are used by a knowledge base?

  3. Ajoutez la réponse mise en forme avec la syntaxe Markdown :Add the answer formatted with markdown:

    * Azure QnA Maker service\n* Azure Cognitive Search\n* Azure web app\n* Azure app plan

    Ajoutez la question sous forme de texte et la réponse mise en forme avec la syntaxe Markdown.

    Le symbole Markdown, *, est utilisé pour les éléments à puce.The markdown symbol, *, is used for bullet points. Le symbole \n est utilisée pour une nouvelle ligne.The \n is used for a new line.

    La page Modifier affiche la syntaxe Markdown.The Edit page shows the markdown. Quand vous utiliserez le panneau Test ultérieurement, la syntaxe Markdown s’affichera correctement.When you use the Test panel later, you will see the markdown displayed properly.

Enregistrer et entraînerSave and train

Dans le coin supérieur droit, sélectionnez Save and train (Enregistrer et entraîner) pour enregistrer vos modifications et entraîner QnA Maker.In the upper right, select Save and train to save your edits and train QnA Maker . Les modifications ne sont conservées que si elles sont enregistrées.Edits aren't kept unless they're saved.

Tester la base de connaissancesTest the knowledge base

  1. Dans le portail QnA Maker, en haut à droite, sélectionnez Test pour vérifier que les modifications apportées ont pris effet.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Entrez un exemple de requête d’utilisateur dans la zone de texte.Enter an example user query in the textbox.

    How many Azure services are used by a knowledge base?

    Entrez un exemple de requête d’utilisateur dans la zone de texte.

  3. Sélectionnez Inspect pour examiner la réponse plus en détail.Select Inspect to examine the response in more detail. La fenêtre de test est utilisée pour tester les changements que vous apportez à la base de connaissances avant de la publier.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Sélectionnez à nouveau Test (Tester) pour fermer le panneau Test.Select Test again to close the Test panel.

Publier la base de connaissancesPublish the knowledge base

Quand vous publiez une base de connaissances, son contenu passe de l’index test à un index prod dans la Recherche Azure.When you publish a knowledge base, the contents of your knowledge base moves from the test index to a prod index in Azure search.

Capture d’écran du déplacement du contenu de votre base de connaissances

  1. Dans le portail QnA Maker, sélectionnez Publish (Publier).In the QnA Maker portal, select Publish. Ensuite, pour confirmer, sélectionnez Publish dans la page.Then to confirm, select Publish on the page.

    Le service QnA Maker est désormais correctement publié.The QnA Maker service is now successfully published. Vous pouvez utiliser le point de terminaison dans votre code d’application ou de bot.You can use the endpoint in your application or bot code.

    Capture d’écran de la réussite de la publication

Créer un botCreate a bot

Après la publication, vous pouvez créer un bot à partir de la page Publish (Publier) :After publishing, you can create a bot from the Publish page:

  • Vous pouvez créer plusieurs bots rapidement, tous pointant vers la même base de connaissances pour différentes régions ou différents plans tarifaires pour les bots individuels.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Si vous ne voulez qu’un seul bot pour la base de connaissances, utilisez le lien Afficher tous vos bots sur le portail Azure pour voir la liste de vos bots actuel.If you want only one bot for the knowledge base, use the View all your bots on the Azure portal link to view a list of your current bots.

Quand vous apportez des modifications à la base de connaissances et que vous republiez, aucune autre action n’est nécessaire avec le bot.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Il est déjà configuré pour fonctionner avec la base de connaissances et il fonctionne avec toutes les modifications futures de la base de connaissances.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Chaque fois que vous publiez une base de connaissances, tous les bots qui y sont connectés sont automatiquement mis à jour.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. Dans le portail QnA Maker, dans la page Publish, sélectionnez Create bot.In the QnA Maker portal, on the Publish page, select Create bot. Ce bouton apparaît seulement une fois que vous avez publié la base de connaissances.This button appears only after you've published the knowledge base.

    Capture d’écran de la création d’un bot

  2. Un nouvel onglet de navigateur s’ouvre pour le portail Azure, avec la page de création d’Azure Bot Service.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configurez le service bot Azure.Configure the Azure bot service. Le bot et QnA Maker peuvent partager le plan du service Web App, mais ils ne peuvent pas partager l’application web.The bot and QnA Maker can share the web app service plan, but can't share the web app. Cela signifie que le nom de l’application pour le bot doit être différent du nom de l’application pour le service QnA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • À faireDo
      • Changer le descripteur du bot, s’il n’est pas unique.Change bot handle - if it is not unique.
      • Sélectionner le langage du SDK.Select SDK Language. Une fois le bot créé, vous pouvez télécharger le code dans votre environnement de développement local et poursuivre le processus de développement.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • À ne pas faireDon't
      • Modifiez les paramètres suivants sur le portail Azure au moment de créer le bot.change the following settings in the Azure portal when creating the bot. Ils sont préremplis pour votre base de connaissances existante :They are pre-populated for your existing knowledge base:
        • Clé d’authentification QnAQnA Auth Key
        • Plan et emplacement App ServiceApp service plan and location
  3. Une fois le bot créé, ouvrez la ressource Service Bot.After the bot is created, open the Bot service resource.

  4. Sous Gestion du bot, sélectionnez Tester dans le Web Chat.Under Bot Management, select Test in Web Chat.

  5. À l’invite de chat Tapez votre message, entrez :At the chat prompt of Type your message, enter:

    Azure services?

    Le chatbot répond avec une réponse provenant de votre base de connaissances.The chat bot responds with an answer from your knowledge base.

    Entrez une requête d’utilisateur dans le web chat de test.

Qu’avez-vous fait ?What did you accomplish?

Vous avez créé une base de connaissances, ajouté une URL publique à la base de connaissances, ajouté votre propre paire de Q/R, entraîné, testé puis publié la base de connaissances.You created a new knowledge base, added a public URL to the knowledge base, added your own QnA pair, trained, tested, and published the knowledge base.

Après avoir publié la base de connaissances, vous avez créé un bot et testé celui-ci.After publishing the knowledge base, you created a bot, and tested the bot.

Tout cela a été fait en quelques minutes sans avoir à écrire de code ni à supprimer le contenu.This was all accomplished in a few minutes without having to write any code or clean the content.

Nettoyer les ressourcesClean up resources

Si vous ne passez pas au démarrage rapide suivant, supprimez les ressources de QnA Maker et de Bot Framework dans le portail Azure.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Étapes suivantesNext steps

Pour plus d'informations :For more information: