Rychlý Start: vytvoření, výuka a publikování znalostní báze QnA Maker Knowledge BaseQuickstart: Create, train, and publish your QnA Maker knowledge base

Znalostní bázi služby QnA Maker můžete vytvořit s použitím vlastního obsahu, jako jsou nejčastější dotazy nebo příručky k produktům.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. Tento článek obsahuje příklad vytvoření QnA Maker znalostní báze z jednoduché webové stránky s nejčastějšími dotazy pro odpovědi na otázky QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

PožadavkyPrerequisites

  • Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.If you don't have an Azure subscription, create a free account before you begin.
  • QnA Maker prostředek vytvořený v Azure Portal.A QnA Maker resource created in the Azure portal. Mějte na paměti, že vaše Azure Active Directory ID, předplatné a název prostředku QnA jste zvolili při vytváření prostředku.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Vytvoření prvního QnA Maker znalostní báze Knowledge BaseCreate your first QnA Maker knowledge base

  1. Přihlaste se k portálu QnAMaker.AI pomocí svých přihlašovacích údajů Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. Na portálu QnA Maker vyberte vytvořit znalostní bázi.In the QnA Maker portal, select Create a knowledge base.

  3. Na stránce vytvořit přeskočte Krok 1 , pokud již máte prostředek QnA maker.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Pokud jste prostředek ještě nevytvořili, vyberte vytvořit službu QnA.If you haven't created the resource yet, select Create a QnA service. Budete přesměrování na Azure Portal, kde můžete nastavit službu QnA Maker ve vašem předplatném.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Mějte na paměti, že vaše Azure Active Directory ID, předplatné a název prostředku QnA jste zvolili při vytváření prostředku.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    Až skončíte s vytvářením prostředku v Azure Portal, vraťte se na portál QnA Maker, aktualizujte stránku prohlížeče a pokračujte krokem 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. V kroku 2 vyberte službu Active Directory, předplatné, službu (prostředek) a jazyk pro všechny znalostní báze vytvořené ve službě.In Step 2, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Snímek obrazovky s výběrem znalostní báze služby QnA Maker

  5. V kroku 3 pojmenujte svůj znalostní báze Moje ukázková QnA KB.In Step 3, name your knowledge base My Sample QnA KB.

  6. V kroku 4 nakonfigurujte nastavení pomocí následující tabulky:In Step 4, configure the settings with the following table:

    NastaveníSetting HodnotaValue
    Povolí vícenásobné extrakce z adres URL, souborů PDF a DOCX.Enable multi-turn extraction from URLs, .pdf or .docx files. ZaškrtnutoChecked
    Vícenásobné zapnutí výchozího textuMulti-turn default text Vybrat a možnostSelect and option
    + Přidat adresu URL+ Add URL https://www.microsoft.com/en-us/software-download/faq
    PovídáníChit-chat Vybrat ProfessionalSelect Professional
  7. V kroku 5 vyberte vytvořit znalostní báze.In Step 5, Select Create your KB.

    Pro extrakci dokumentu a identifikaci otázek a odpovědí trvá proces extrakce chvíli.The extraction process takes a few moments to read the document and identify questions and answers.

    Jakmile QnA Maker úspěšně vytvoří znalostní bázi, otevře se stránka znalostní báze .After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. Na této stránce můžete upravit obsah znalostní báze.You can edit the contents of the knowledge base on this page.

Přidat novou sadu otázek a odpovědíAdd a new question and answer set

  1. Na portálu QnA Maker na stránce Upravit vyberte + Přidat dvojici QnA z panelu nástrojů kontextu.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  2. Přidejte následující otázku:Add the following question:

    How many Azure services are used by a knowledge base?

  3. Přidejte odpověď formátovanou pomocí Markdownu:Add the answer formatted with markdown:

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

    Přidejte otázku jako text a odpověď formátovanou pomocí Markdownu.

    Symbol Markdownu se * používá pro body odrážek.The markdown symbol, *, is used for bullet points. \nPoužívá se pro nový řádek.The \n is used for a new line.

    Na stránce pro Úpravy se zobrazí Markdownu.The Edit page shows the markdown. Když použijete testovací panel později, zobrazí se Markdownu správně.When you use the Test panel later, you will see the markdown displayed properly.

Uložení a natrénováníSave and train

V pravém horním rohu vyberte Uložit a výuka a uložte úpravy a výukové QnA maker.In the upper right, select Save and train to save your edits and train QnA Maker. Úpravy se nezachovají, pokud se neuloží.Edits aren't kept unless they're saved.

Testování znalostní bázeTest the knowledge base

  1. Na portálu QnA Maker v pravém horním rohu vyberte test , abyste otestovali, že provedené změny se projevily.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. Do textového pole zadejte ukázkový dotaz uživatele.Enter an example user query in the textbox.

    I want to know the difference between 32 bit and 64 bit Windows

    Do textového pole zadejte ukázkový dotaz uživatele.

  3. Pokud chcete odpověď prozkoumat podrobněji, vyberte Inspect (Prozkoumat).Select Inspect to examine the response in more detail. Testovací okno slouží k otestování změn ve znalostní bázi před publikováním znalostní báze.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Vyberte znovu test pro zavření testovacího panelu.Select Test again to close the Test panel.

Publikování znalostní bázePublish the knowledge base

Když publikujete znalostní bázi, obsah znalostní báze se přesune z test indexu do prod indexu ve službě Azure Search.When you publish a knowledge base, the contents of your knowledge base move from the test index to a prod index in Azure search.

Snímek obrazovky s přesunutím obsahu znalostní báze

  1. Na portálu QnA Maker vyberte publikovat.In the QnA Maker portal, select Publish. Pak publikování potvrďte tím, že na stránce vyberete Publish (Publikovat).Then to confirm, select Publish on the page.

    Služba QnA Maker je teď úspěšně publikovaná.The QnA Maker service is now successfully published. Koncový bod můžete použít v kódu aplikace nebo chatbota.You can use the endpoint in your application or bot code.

    Snímek obrazovky s úspěšným publikováním

Vytvoření robotaCreate a bot

Po publikování můžete vytvořit robota ze stránky publikování :After publishing, you can create a bot from the Publish page:

  • Můžete rychle vytvořit několik robotyů, které ukazují na stejnou znalostní bázi pro různé oblasti nebo cenové tarify pro jednotlivé roboty.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Pokud potřebujete jenom jednu robota pro znalostní bázi, použijte zobrazení všechny roboty na odkaz Azure Portal k zobrazení seznamu aktuálního roboty.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.

Když provedete změny ve znalostní bázi a znovu publikujete, nemusíte s robotem dělat další akce.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Je už nakonfigurovaná pro práci se znalostní bázeí a funguje se všemi budoucími změnami ve znalostní bázi.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Pokaždé, když publikujete znalostní bázi, jsou automaticky aktualizovány všechny roboty připojené k ní.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. Na QnA Makerovém portálu na stránce publikovat vyberte vytvořit robot.In the QnA Maker portal, on the Publish page, select Create bot. Toto tlačítko se zobrazí až po publikování znalostní báze.This button appears only after you've published the knowledge base.

    Snímek obrazovky s vytvořením robota

  2. Otevře se nová karta prohlížeče pro Azure Portal se stránkou pro vytvoření Azure Bot Service.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Nakonfigurujte službu Azure bot Service.Configure the Azure bot service. Robot a QnA Maker můžou sdílet plán služby Web App Service, ale nemůžou webovou aplikaci sdílet.The bot and QnA Maker can share the web app service plan, but can't share the web app. To znamená, že název aplikace pro robot se musí lišit od názvu aplikace pro službu QnA maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • Správný postupDo
      • Změnit popisovač robota – Pokud není jedinečnýChange bot handle - if it is not unique.
      • Vyberte jazyk sady SDK.Select SDK Language. Po vytvoření robota si můžete kód stáhnout do svého místního vývojového prostředí a pokračovat v procesu vývoje.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • Chybný postupDon't
      • Při vytváření robota změňte následující nastavení v Azure Portal.change the following settings in the Azure portal when creating the bot. Jsou předem vyplněné pro stávající znalostní bázi:They are pre-populated for your existing knowledge base:
        • QnA ověřovací klíčQnA Auth Key
        • Plán a umístění služby App ServiceApp service plan and location
  3. Po vytvoření robota otevřete prostředek služby bot .After the bot is created, open the Bot service resource.

  4. V části Správa robota vyberte test na webu chat.Under Bot Management, select Test in Web Chat.

  5. Na příkazovém řádku chatu Zadejte zprávu:At the chat prompt of Type your message, enter:

    Azure services?

    Robotka chatu odpoví odpověď z vaší znalostní báze.The chat bot responds with an answer from your knowledge base.

    Zadejte uživatelský dotaz do testovacího webového chatu.

Co jste provedli?What did you accomplish?

Vytvořili jste novou znalostní bázi, Přidali jste do znalostní báze veřejnou adresu URL, Přidali jste vlastní dvojici QnA, školením, otestováním a publikováním znalostní báze.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.

Po zveřejnění znalostní báze jste vytvořili robota a otestovali robota.After publishing the knowledge base, you created a bot, and tested the bot.

To bylo provedeno za několik minut, aniž byste museli psát kód nebo vyčistit obsah.This was all accomplished in a few minutes without having to write any code or clean the content.

Vyčištění prostředkůClean up resources

Pokud nebudete pokračovat dalším rychlým startem, odstraňte prostředky QnA Maker a robot Framework v Azure Portal.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Další krokyNext steps

Další informace najdete tady:For more information: