Snabb start: skapa, träna och publicera QnA Maker kunskaps basQuickstart: Create, train, and publish your QnA Maker knowledge base

Du kan skapa en QnA Maker-kunskapsbas (KB) av eget innehåll, till exempel vanliga frågor eller produkthandböcker.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. Den här artikeln innehåller ett exempel på hur du skapar en QnA Maker kunskaps bas från en enkel webb sida med vanliga frågor och svar för att besvara frågor QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

FörutsättningarPrerequisites

  • Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.
  • En QnA Maker resurs som skapats i Azure Portal.A QnA Maker resource created in the Azure portal. Kom ihåg Azure Active Directory ID, prenumeration, QnA-resurs namn som du valde när du skapade resursen.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Skapa din första QnA Maker kunskaps basCreate your first QnA Maker knowledge base

  1. Logga in på QnAMaker.AI -portalen med dina Azure-autentiseringsuppgifter.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. I QnA Maker-portalen väljer du skapa en kunskaps bas.In the QnA Maker portal, select Create a knowledge base.

  3. På sidan skapa hoppar du över steg 1 om du redan har din QNA Maker-resurs.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Om du inte har skapat resursen ännu väljer du skapa en QNA-tjänst.If you haven't created the resource yet, select Create a QnA service. Du dirigeras till Azure-portalen för att konfigurera en QnA Maker-tjänst i din prenumeration.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Kom ihåg Azure Active Directory ID, prenumeration, QnA-resurs namn som du valde när du skapade resursen.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    När du är klar med att skapa resursen i Azure Portal går du tillbaka till QnA Maker Portal, uppdaterar sidan webbläsare och fortsätter till steg 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. I steg 3väljer du din Active Directory, prenumeration, tjänst (resurs) och språket för alla kunskaps baser som skapats i tjänsten.In Step 3, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Skärm bild av att välja en QnA Maker tjänst kunskaps bas

  5. I steg 3namnger du kunskaps basen mitt exempel på QNA KB.In Step 3, name your knowledge base My Sample QnA KB.

  6. I steg 4konfigurerar du inställningarna med följande tabell:In Step 4, configure the settings with the following table:

    InställningSetting VärdeValue
    Aktivera extrahering av flera adresser från URL: er, PDF-eller docx-filer.Enable multi-turn extraction from URLs, .pdf or .docx files. MarkeradChecked
    Standard svars textDefault answer text Quickstart - default answer not found.
    + Lägg till URL+ Add URL https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting
    CHI2TEST – ChatChit-chat Välj ProfessionalSelect Professional
  7. I steg 5väljer du skapa din KB.In Step 5, Select Create your KB.

    Extraherings processen tar en stund att läsa dokumentet och identifiera frågor och svar.The extraction process takes a few moments to read the document and identify questions and answers.

    När QnA Maker har skapat kunskaps basen öppnas sidan kunskaps bas .After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. Du kan redigera innehållet i kunskaps basen på den här sidan.You can edit the contents of the knowledge base on this page.

Lägg till en ny fråga och svars uppsättningAdd a new question and answer set

  1. På sidan Redigera på QNA Maker-portalen väljer du + Lägg till QNA-paret från kontext verktygsfältet.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  2. Lägg till följande fråga:Add the following question:

    How many Azure services are used by a knowledge base?

  3. Lägg till svaret som formaterats med markdown:Add the answer formatted with markdown:

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

    Lägg till frågan som text och svaret formaterat med markdown.

    Markdown-symbolen, * används för punkter.The markdown symbol, *, is used for bullet points. \nAnvänds för en ny rad.The \n is used for a new line.

    På sidan Redigera visas markdown.The Edit page shows the markdown. När du använder test panelen senare ser du att markdown visas som den ska.When you use the Test panel later, you will see the markdown displayed properly.

Spara och övaSave and train

I det övre högra hörnet väljer du Spara och träna för att spara dina ändringar och träna QNA Maker.In the upper right, select Save and train to save your edits and train QnA Maker . Redigeringarna försvinner om de inte sparas.Edits aren't kept unless they're saved.

Testa kunskaps basenTest the knowledge base

  1. I den QnA Maker portalen, i det övre högra hörnet, väljer du test för att testa att ändringarna du gjort har genomförts.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Ange ett exempel på en användar fråga i text rutan.Enter an example user query in the textbox.

    How many Azure services are used by a knowledge base?

    Ange ett exempel på en användar fråga i text rutan.

  3. Välj Granska för att undersöka svaret i detalj.Select Inspect to examine the response in more detail. Test fönstret används för att testa dina ändringar i kunskaps basen innan du publicerar din kunskaps bas.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Välj testa igen för att stänga test panelen.Select Test again to close the Test panel.

Publicera kunskapsbasenPublish the knowledge base

När du publicerar en kunskaps bas flyttas innehållet i kunskaps basen från test indexet till ett prod index i Azure Search.When you publish a knowledge base, the contents of your knowledge base moves from the test index to a prod index in Azure search.

Skärm bild av hur du flyttar innehållet i kunskaps basen

  1. I QnA Maker Portal väljer du publicera.In the QnA Maker portal, select Publish. Bekräfta sedan genom att välja Publicera på sidan.Then to confirm, select Publish on the page.

    QnA Maker-tjänsten har nu publicerats.The QnA Maker service is now successfully published. Du kan använda slutpunkten i ditt program eller din robotkod.You can use the endpoint in your application or bot code.

    Skärm bild av lyckad publicering

Skapa en robotCreate a bot

När du har publicerat kan du skapa en robot från publicerings sidan:After publishing, you can create a bot from the Publish page:

  • Du kan skapa flera robotar snabbt, allt som pekar på samma kunskaps bas för olika regioner eller prissättnings planer för enskilda robotar.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Om du bara vill ha en robot för kunskaps basen använder du länken Visa alla robotar på Azure Portal för att visa en lista över din aktuella robotar.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.

När du gör ändringar i kunskaps basen och återpublicerar behöver du inte vidta några åtgärder i bot-roboten.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Den har redan kon figurer ATS för att fungera med kunskaps basen och fungerar med alla framtida ändringar i kunskaps basen.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Varje gång du publicerar en kunskaps bas uppdateras alla robotar som är anslutna till den automatiskt.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. På sidan publicera i QNA Maker-portalen väljer du skapa bot.In the QnA Maker portal, on the Publish page, select Create bot. Den här knappen visas bara när du har publicerat kunskaps basen.This button appears only after you've published the knowledge base.

    Skärm bild som visar hur du skapar en robot

  2. En ny flik i webbläsaren öppnas för Azure Portal med sidan för att skapa Azure Bot Service.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Konfigurera Azure bot service.Configure the Azure bot service. Robot-och QnA Maker kan dela Web App Service-planen, men kan inte dela webbappen.The bot and QnA Maker can share the web app service plan, but can't share the web app. Det innebär att appens namn måste vara ett annat än namnet på appen för tjänsten QNA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • Gör följandeDo
      • Ändra bot-referens – om den inte är unik.Change bot handle - if it is not unique.
      • Välj SDK-språk.Select SDK Language. När bot har skapats kan du ladda ned koden till din lokala utvecklings miljö och fortsätta utvecklings processen.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • Gör inte följandeDon't
      • ändra följande inställningar i Azure Portal när du skapar bot-roboten.change the following settings in the Azure portal when creating the bot. De är i förväg ifyllda för din befintliga kunskaps bas:They are pre-populated for your existing knowledge base:
        • QnA auth-nyckelQnA Auth Key
        • App Service-plan och platsApp service plan and location
  3. När roboten har skapats öppnar du bot-tjänstens resurs.After the bot is created, open the Bot service resource.

  4. Under bot-hanteringväljer du test i Web Chat.Under Bot Management, select Test in Web Chat.

  5. Skriv följande i Chat-prompten för att skriva ditt meddelande:At the chat prompt of Type your message, enter:

    Azure services?

    Chatt-roboten svarar med ett svar från din kunskaps bas.The chat bot responds with an answer from your knowledge base.

    Ange en användar fråga i test-webbchatten.

Vad gjorde du?What did you accomplish?

Du har skapat en ny kunskaps bas, lagt till en offentlig URL i kunskaps basen, lagt till ditt eget QnA-par, tränat, testat och publicerat kunskaps basen.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.

När du har publicerat kunskaps basen har du skapat en robot och testat roboten.After publishing the knowledge base, you created a bot, and tested the bot.

Detta skedde om några minuter utan att behöva skriva någon kod eller rensa innehållet.This was all accomplished in a few minutes without having to write any code or clean the content.

Rensa resurserClean up resources

Om du inte fortsätter med nästa snabb start tar du bort QnA Maker-och bot Framework-resurserna i Azure Portal.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Nästa stegNext steps

Mer information:For more information: