Краткое руководство. Создание, обучение и публикация базы знаний QnA MakerQuickstart: Create, train, and publish your QnA Maker knowledge base

Базу знаний QnA Maker можно создать из собственного содержимого, например часто задаваемых вопросов или руководств по продукции.You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. В этой статье описано, как создать базу знаний QnA Maker на основе простой веб-страницы с часто задаваемыми вопросами, чтобы ответить на вопросы QnA Maker.This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions QnA Maker.

Предварительные требованияPrerequisites

  • Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.If you don't have an Azure subscription, create a free account before you begin.
  • Ресурс QnA Maker, созданный на портале Azure.A QnA Maker resource created in the Azure portal. Запишите идентификатор Azure Active Directory, подписку и имя ресурса QnA, выбранное при создании ресурса.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

Создание первой базы знаний QnA MakerCreate your first QnA Maker knowledge base

  1. Войдите на портал QnAMaker.ai, используя учетные данные Azure.Sign in to the QnAMaker.ai portal with your Azure credentials.

  2. На портале QnA Maker выберите Create a knowledge base (Создать базу знаний).In the QnA Maker portal, select Create a knowledge base.

  3. Пропустите шаг 1 на странице создания, если у вас уже есть ресурс QnA Maker.On the Create page, skip Step 1 if you already have your QnA Maker resource.

    Если вы еще не создали ресурс, выберите Create a QnA service (Создать службу QnA).If you haven't created the resource yet, select Create a QnA service. Откроется портал Azure для настройки службы QnA Maker в вашей подписке.You are directed to the Azure portal to set up a QnA Maker service in your subscription. Запишите идентификатор Azure Active Directory, подписку и имя ресурса QnA, выбранное при создании ресурса.Remember your Azure Active Directory ID, Subscription, QnA resource name you selected when you created the resource.

    Завершив создание ресурса на портале Azure, вернитесь на портал QnA Maker, обновите страницу браузера и продолжайте с шага 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. На шаге 3 выберите Active Directory, подписку, службу (ресурс) и язык для всех баз знаний, созданных в службе.In Step 3, select your Active directory, subscription, service (resource), and the language for all knowledge bases created in the service.

    Снимок экрана с выбранной базой данных и службой QnA Maker

  5. На шаге 3 назовите свою базу знаний Мой пример базы знаний QnA.In Step 3, name your knowledge base My Sample QnA KB.

  6. На шаге 4 настройте параметры, используя значения из приведенной ниже таблицы.In Step 4, configure the settings with the following table:

    ПараметрSetting ЗначениеValue
    Enable multi-turn extraction from URLs, .pdf or .docx files (Включить многоэтапное извлечение из URL-адресов, файлов .pdf или .docx)Enable multi-turn extraction from URLs, .pdf or .docx files. Флажок установленChecked
    Текст ответа по умолчаниюDefault answer text Quickstart - default answer not found.
    Добавление URL-адреса+ Add URL https://docs.microsoft.com/azure/cognitive-services/qnamaker/troubleshooting
    Chit-chat (Беседа)Chit-chat Выберите значение Professional (Профессиональная)Select Professional
  7. На шаге 5выберите создать базу знаний.In Step 5, Select Create your KB.

    Процесс извлечения, во время которого прочитывается документ и определяются вопросы и ответы, занимает несколько минут.The extraction process takes a few moments to read the document and identify questions and answers.

    Когда QnA Maker успешно создаст базы знаний, откроется страница Knowledge base (База знаний).After QnA Maker successfully creates the knowledge base, the Knowledge base page opens. На этой странице можно изменить содержимое базы знаний.You can edit the contents of the knowledge base on this page.

Добавление нового набора вопросов и ответовAdd a new question and answer set

  1. На портале QnA Maker на странице Edit (Изменение) выберите + Add QnA pair (+ Добавить пару "вопрос — ответ") на контекстной панели инструментов.In the QnA Maker portal, on the Edit page, select + Add QnA pair from the context toolbar.

  2. Добавьте следующий вопрос:Add the following question:

    How many Azure services are used by a knowledge base?

  3. Добавьте ответ, отформатированный с помощью markdown:Add the answer formatted with markdown:

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

    Добавьте вопрос в виде текста и ответа, отформатированного с помощью markdown.

    Символ markdown (*) используется для пунктов маркированного списка.The markdown symbol, *, is used for bullet points. Символ \n используется для новой строки.The \n is used for a new line.

    На странице Edit (Изменение) отображается markdown.The Edit page shows the markdown. При использовании панели Test (Проверка) в дальнейшем вы увидите, что markdown отображается правильно.When you use the Test panel later, you will see the markdown displayed properly.

Сохранение и обучениеSave and train

В правом верхнем углу выберите Сохранить и обучить, чтобы сохранить изменения и обучить QnA Maker.In the upper right, select Save and train to save your edits and train QnA Maker . Изменения не вступят в силу, если они не сохранены.Edits aren't kept unless they're saved.

Проверка базы знанийTest the knowledge base

  1. На портале QnA Maker в правом верхнем углу выберите Test (Тестировать), чтобы проверить, вступили ли в силу внесенные изменения.In the QnA Maker portal, in the upper right, select Test to test that the changes you made took effect.

  2. В текстовом поле введите пример пользовательского запроса.Enter an example user query in the textbox.

    How many Azure services are used by a knowledge base?

    В текстовом поле введите пример пользовательского запроса.

  3. Выберите Inspect (Проверить), чтобы более подробно изучить ответ.Select Inspect to examine the response in more detail. Окно тестирования используется для проверки изменений, внесенных в базу знаний, перед публикацией своей базы знаний.The test window is used to test your changes to the knowledge base before publishing your knowledge base.

  4. Выберите панель Test (Проверка) еще раз, чтобы закрыть панель Test (Проверка).Select Test again to close the Test panel.

Публикация базы знанийPublish the knowledge base

При публикации базы знаний содержимое этой базы знаний переносится из указателя test в указатель prod в службе поиска 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.

Снимок экрана с перемещением содержимого базы знаний

  1. На портале QnA Maker выберите Publish (Опубликовать).In the QnA Maker portal, select Publish. Затем, чтобы подтвердить, выберите Опубликовать на странице.Then to confirm, select Publish on the page.

    Служба QnA Maker успешно опубликована.The QnA Maker service is now successfully published. Конечную точку можно использовать в коде приложения или бота.You can use the endpoint in your application or bot code.

    Снимок экрана с успешной публикацией

Создание ботаCreate a bot

После публикации можно создать бота на странице Publish (Публикация):After publishing, you can create a bot from the Publish page:

  • Можно создать несколько ботов, которые будут работать с одной базой знаний, для разных регионов или тарифных планов.You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots.
  • Если нужен только один бот для базы знаний, перейдите по ссылке View all your bots on the Azure portal (Просмотреть всех ботов на портале Azure), чтобы просмотреть список текущих ботов.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.

При внесении изменений в базу знаний и ее повторной публикации не требуется предпринимать какие-либо действия с ботом.When you make changes to the knowledge base and republish, you don't need to take further action with the bot. Он уже настроен для работы с базой знаний и будет учитывать все ее последующие изменения.It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. При каждой публикации базы знаний все боты, подключенные к ней, обновляются автоматически.Every time you publish a knowledge base, all the bots connected to it are automatically updated.

  1. На портале QnA Maker, на странице Publish (Публикация) выберите Create bot (Создать бота).In the QnA Maker portal, on the Publish page, select Create bot. Эта кнопка отображается только после публикации базы знаний.This button appears only after you've published the knowledge base.

    Снимок экрана с созданием бота

  2. В новой вкладке браузера откроется страница создания службы Azure Bot на портале Azure.A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Настройте службу Azure Bot.Configure the Azure bot service. Бот и QnA Maker могут иметь общий план службы веб-приложений, но не могут совместно использовать одно веб-приложение.The bot and QnA Maker can share the web app service plan, but can't share the web app. Это означает, что имя приложения для бота должно отличаться от имени приложения для службы QnA Maker.This means the app name for the bot must be different from the app name for the QnA Maker service.

    • ЗапрещаDo
      • Измените дескриптор бота, если он не уникален.Change bot handle - if it is not unique.
      • Выберите язык пакета SDK.Select SDK Language. После создания программы-робота можно загрузить код в локальную среду разработки и продолжить разработку.Once the bot is created, you can download the code to your local development environment and continue the development process.
    • Не рекомендуетсяDon't
      • Создавая бот, не изменяйте приведенные ниже параметры на портале Azure.change the following settings in the Azure portal when creating the bot. Их значения автоматически заполняются для базы знаний:They are pre-populated for your existing knowledge base:
        • ключ проверки подлинности QnA;QnA Auth Key
        • расположение и план службы приложений;App service plan and location
  3. После создания бота откройте ресурс Bot service (Служба бота).After the bot is created, open the Bot service resource.

  4. В разделе Управление Botвыберите проверить в веб-чате.Under Bot Management, select Test in Web Chat.

  5. В приглашении чата Type your message (Тип сообщения), введите:At the chat prompt of Type your message, enter:

    Azure services?

    Чат-бот ответит, используя ответ из базы знаний.The chat bot responds with an answer from your knowledge base.

    Введите запрос пользователя в тестовый веб-чат.

Что вы сделалиWhat did you accomplish?

Вы создали новую базу знаний, добавили общедоступный URL-адрес к базе знаний, добавили собственную пару QnA, обученную, проверенную и опубликованную базу знаний.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.

После публикации базы знаний вы создали бот и проверили его.After publishing the knowledge base, you created a bot, and tested the bot.

Это сделано всего за несколько минут без написания кода или очистки содержимого.This was all accomplished in a few minutes without having to write any code or clean the content.

Очистка ресурсовClean up resources

Если вы не переходите к следующему краткому руководству, удалите ресурсы платформы QnA Maker и Bot на портале Azure.If you are not continuing to the next quickstart, delete the QnA Maker and Bot framework resources in the Azure portal.

Дальнейшие действияNext steps

Дополнительные сведенияFor more information: