Управление ресурсами QnA MakerManage QnA Maker resources

Перед созданием базы знаний службы QnA Maker необходимо настроить эту службу в Azure.Before you can create any QnA Maker knowledge bases, you must first set up a QnA Maker service in Azure. Настроить службу QnA Maker может любой пользователь с правами на создание ресурсов в подписке.Anyone with authorization to create new resources in a subscription can set up a QnA Maker service.

Перед созданием ресурса полезно ознакомиться со следующими концепциями.A solid understanding of the following concepts is helpful before creating your resource:

Создание службы QnA MakerCreate a new QnA Maker service

Эта процедура создает ресурсы Azure, необходимые для управления содержимым базы знаний.This procedure creates the Azure resources needed to manage the knowledge base content. После выполнения этих действий вы найдете ключи подписки на странице ключи для ресурса в портал Azure.After you complete these steps, you'll find the subscription keys on the Keys page for the resource in the Azure portal.

  1. Войдите в портал Azure и создайте ресурс QnA Maker .Sign in to the Azure portal and create a QnA Maker resource.

  2. Выберите создать после прочтения условий:Select Create after you read the terms and conditions:

    Создание службы QnA Maker

  3. В QnA Makerвыберите соответствующие уровни и регионы.In QnA Maker, select the appropriate tiers and regions:

    Создание службы QnA Maker — ценовая категория и регионы

    • В поле имя введите уникальное имя для указания этой службы QnA Maker.In the Name field, enter a unique name to identify this QnA Maker service. Это имя также определяет конечную точку QnA Maker, с которой будут связаны базы знаний.This name also identifies the QnA Maker endpoint that your knowledge bases will be associated with.

    • Выберите подписку , в которой будет развернут ресурс QnA Maker.Choose the Subscription under which the QnA Maker resource will be deployed.

    • Выберите ценовую категорию для служб управления QnA Maker (API портала и управления).Select the Pricing tier for the QnA Maker management services (portal and management APIs). См. Дополнительные сведения о ценах на SKU.See more details about SKU pricing.

    • Создайте новую группу ресурсов (рекомендуется) или используйте существующую, чтобы развернуть этот QnA Maker ресурс.Create a new Resource group (recommended) or use an existing one in which to deploy this QnA Maker resource. QnA Maker создает несколько ресурсов Azure.QnA Maker creates several Azure resources. При создании группы ресурсов для хранения этих ресурсов можно легко находить эти ресурсы, управлять ими и удалять их по имени группы ресурсов.When you create a resource group to hold these resources, you can easily find, manage, and delete these resources by the resource group name.

    • Выберите расположение группы ресурсов.Select a Resource group location.

    • Выберите ценовую категорию поиска для службы когнитивный Поиск Azure.Choose the Search pricing tier of the Azure Cognitive Search service. Если параметр уровень Free недоступен (отображается серым цветом), это означает, что у вас уже есть бесплатная служба, развернутая через подписку.If the Free tier option is unavailable (appears dimmed), it means you already have a free service deployed through your subscription. В этом случае необходимо начать с уровня "базовый".In that case, you'll need to start with the Basic tier. См. сведения о ценах на когнитивный Поиск Azure.See Azure Cognitive Search pricing details.

    • Выберите место поиска , в котором должны развертываться индексы когнитивный Поиск Azure.Choose the Search location where you want Azure Cognitive Search indexes to be deployed. Ограничения на место хранения данных клиента помогут определить расположение, выбранное для Когнитивный поиск Azure.Restrictions on where customer data must be stored will help determine the location you choose for Azure Cognitive Search.

    • В поле имя приложения введите имя экземпляра службы приложений Azure.In the App name field, enter a name for your Azure App Service instance.

    • По умолчанию служба приложений по умолчанию имеет уровень Standard (S1).By default, App Service defaults to the standard (S1) tier. Вы можете изменить выбранный план после создания службы.You can change the plan after creation. Дополнительные сведения о ценах на службу приложений.Learn more about App Service pricing.

    • Выберите расположение веб-сайта , в котором будет развернута служба приложений.Choose the Website location where App Service will be deployed.

      Примечание

      Расположение поиска может отличаться от расположения веб-сайта.The Search Location can differ from the Website Location.

    • Выберите, следует ли включить Application Insights.Choose whether or not you want to enable Application Insights. Если Application Insights включена, QnA Maker собирает данные телеметрии по трафику, журналам чата и ошибкам.If Application Insights is enabled, QnA Maker collects telemetry on traffic, chat logs, and errors.

    • Выберите расположение app Insights , в котором будет развернут ресурс Application Insights.Choose the App insights location where the Application Insights resource will be deployed.

    • Для экономии затрат вы можете предоставить общий доступ к некоторым (не всем) ресурсам Azure, созданным для QnA Maker.For cost savings measures, you can share some but not all Azure resources created for QnA Maker.

  4. После проверки всех полей выберите создать.After all the fields are validated, select Create. Процесс создания может занять несколько минут.The process can take a few minutes to complete.

  5. После завершения развертывания вы увидите следующие ресурсы, созданные в вашей подписке:After deployment is completed, you'll see the following resources created in your subscription:

    Ресурс, созданный в службе QnA Maker

    У ресурса с типом Cognitive Services есть ключи подписки .The resource with the Cognitive Services type has your subscription keys.

Поиск ключей разработки в портал AzureFind authoring keys in the Azure portal

Вы можете просматривать и сбрасывать ключи разработки из портал Azure, где был создан QnA Maker ресурс.You can view and reset your authoring keys from the Azure portal, where you created the QnA Maker resource. Эти ключи могут называться ключами подписки.These keys may be referred to as subscription keys.

  1. Перейдите к ресурсу QnA Maker в портал Azure и выберите ресурс с типом Cognitive Services :Go to the QnA Maker resource in the Azure portal and select the resource that has the Cognitive Services type:

    Список ресурсов QnA Maker

  2. К ключам:Go to Keys:

    Ключ подписки

Поиск ключей конечной точки запроса на портале QnA MakerFind query endpoint keys in the QnA Maker portal

Конечная точка находится в том же регионе, что и ресурс, так как ключи конечной точки используются для выполнения вызова к базе знаний.The endpoint is in the same region as the resource because the endpoint keys are used to make a call to the knowledge base.

Ключами конечной точки можно управлять на портале QnA Maker.Endpoint keys can be managed from the QnA Maker portal.

  1. Войдите на портал QnA Maker, перейдите к своему профилю и выберите Параметры службы:Sign in to the QnA Maker portal, go to your profile, and then select Service settings:

    Ключ конечной точки

  2. Просмотр или сброс ключей:View or reset your keys:

    Диспетчер ключей конечных точекEndpoint key manager

    Примечание

    Обновите ключи, если считаете, что они скомпрометированы.Refresh your keys if you think they've been compromised. Для этого может потребоваться внести соответствующие изменения в код клиентского приложения или бота.This may require corresponding changes to your client application or bot code.

Обновление ресурсовUpdate the resources

Узнайте, как обновить ресурсы, используемые базой знаний.Learn how to upgrade the resources used by your knowledge base.

Обновление SKU QnA MakerUpgrade QnA Maker SKU

Если вы хотите получить больше вопросов и ответов в базе знаний, помимо текущего уровня, обновите ценовую категорию службы 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.

Чтобы обновить номер SKU для управления службой QnA Maker, сделайте следующее:To upgrade the QnA Maker management SKU:

  1. Перейдите к ресурсу QnA Maker на портале Azure и выберите Ценовая категория.Go to your QnA Maker resource in the Azure portal, and select Pricing tier.

    Ресурс QnA Maker

  2. Определите соответствующий номер SKU и нажмите Выбрать.Choose the appropriate SKU and press Select.

    Цены на QnA Maker

Обновление службы приложенийUpgrade App Service

Если ваша база знаний должна обслуживать больше запросов из клиентского приложения, обновите ценовую категорию службы приложений.When your knowledge base needs to serve more requests from your client app, upgrade your App Service pricing tier.

Вы можете увеличить или уменьшить масштаб службы приложений.You can scale up or scale out App Service.

Перейдите к ресурсу службы приложений в портал Azure и выберите вариант увеличения или уменьшения масштаба, как требуется.Go to the App Service resource in the Azure portal, and select the Scale up or Scale out option as required.

Масштабирование службы приложений QnA Maker

Обновление службы Когнитивный поиск AzureUpgrade the Azure Cognitive Search service

Если вы планируете использовать множество баз знаний, обновите ценовую категорию службы Когнитивный поиск Azure.If you plan to have many knowledge bases, upgrade your Azure Cognitive Search service pricing tier.

Сейчас невозможно выполнить обновление на месте для номера SKU поиска Azure.Currently, you can't perform an in-place upgrade of the Azure search SKU. Но можно создать новый ресурс Поиска Azure с требуемым номером SKU, восстановить туда данные, а затем привязать его к стеку 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. Для этого выполните следующие действия:To do this, follow these steps:

  1. Создайте новый ресурс службы "Поиск Azure" в портал Azure и выберите нужный номер SKU.Create a new Azure search resource in the Azure portal, and select the desired SKU.

    Ресурс Поиска Azure в QnA Maker

  2. Восстановите индексы из исходного ресурса Поиска Azure на новый.Restore the indexes from your original Azure search resource to the new one. См. пример кода для восстановления резервной копии.See the backup restore sample code.

  3. После восстановления данных перейдите к новому ресурсу поиска Azure, выберите ключии запишите имя и ключ администратора:After the data is restored, go to your new Azure search resource, select Keys, and write down the Name and the Admin key:

    Ключи поиска Azure в QnA Maker

  4. Чтобы связать новый ресурс службы "Поиск Azure" с QnA Makerным стеком, перейдите к QnA Makerному экземпляру служб приложений.To link the new Azure search resource to the QnA Maker stack, go to the QnA Maker App Service instance.

    Экземпляр службы приложений QnA Maker

  5. Выберите Параметры приложения и измените параметры в полях азуресеарчнаме и азуресеарчадминкэй из шага 3.Select Application settings and modify the settings in the AzureSearchName and AzureSearchAdminKey fields from step 3.

    QnA Maker параметр службы приложений

  6. Перезапустите экземпляр службы приложений.Restart the App Service instance.

    Перезапуск экземпляра службы приложений QnA Maker

Получение последних обновлений среды выполненияGet the latest runtime updates

Среда выполнения QnAMaker является частью экземпляра службы приложений Azure, который разворачивается при создании службы QnAMaker в портал 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. Периодически устанавливаются обновления для этой среды выполнения.Updates are made periodically to the runtime. QnA Maker экземпляр службы приложений находится в режиме автоматического обновления после выпуска расширения сайта от апреля 2019 (версия 5 +).The QnA Maker App Service instance is in auto-update mode after the April 2019 site extension release (version 5+). Это обновление предназначено для того, чтобы принимать во внимание время простоя при обновлении.This update is designed to take care of ZERO downtime during upgrades.

Текущую версию можно проверить по адресу https://www.qnamaker.ai/UserSettings .You can check your current version at https://www.qnamaker.ai/UserSettings. Если версия старше версии 5. x, необходимо перезапустить службу приложений, чтобы установить последние обновления:If your version is older than version 5.x, you must restart App Service to apply the latest updates:

  1. Перейдите к службе QnAMaker (Группа ресурсов) в портал Azure.Go to your QnAMaker service (resource group) in the Azure portal.

    Группа ресурсов Azure для QnA MakerQnAMaker Azure resource group

  2. Выберите экземпляр службы приложений и откройте раздел Обзор .Select the App Service instance and open the Overview section.

    Экземпляр службы приложений QnAMakerQnAMaker App Service instance

  3. Перезапустите службу приложений.Restart App Service. Процесс обновления должен завершиться через пару секунд.The update process should finish in a couple of seconds. Все зависимые приложения или программы-роботы, использующие эту службу QnAMaker, будут недоступны конечным пользователям в течение этого периода перезапуска.Any dependent applications or bots that use this QnAMaker service will be unavailable to end users during this restart period.

    Перезапуск экземпляра службы приложений QnAMaker

Когнитивный поиск вниманиеCognitive Search consideration

Когнитивный поиск, как отдельный ресурс, имеет несколько различных конфигураций, о которых следует знать.Cognitive Search, as a separate resource, has some different configurations you should be aware of.

Настройка QnA Maker для использования другого Когнитивный поиск ресурсаConfigure QnA Maker to use different Cognitive Search resource

Если вы создаете службу QnA и ее зависимости (например, поиск) на портале, служба поиска создается и связывается со службой 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. После создания этих ресурсов можно обновить параметр службы приложений, чтобы использовать ранее существующую службу поиска, и удалить только что созданную.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.

Ресурс службы приложений QnA Maker использует ресурс когнитивный Поиск.QnA Maker's App Service resource uses the Cognitive Search resource. Чтобы изменить Когнитивный поиск ресурс, используемый QnA Maker, необходимо изменить параметр в портал Azure.In order to change the Cognitive Search resource used by QnA Maker, you need to change the setting in the Azure portal.

  1. Получите ключ администратора и имя ресурса когнитивный Поиск, который QnA Maker будет использовать.Get the Admin key and Name of the Cognitive Search resource you want QnA Maker to use.

  2. Войдите в портал Azure и найдите службу приложений , связанную с ресурсом QnA Maker.Sign in to the Azure portal and find the App Service associated with your QnA Maker resource. Оба с имеют одинаковое имя.Both with have the same name.

  3. Выберите Параметры, а затем Конфигурация.Select Settings, then Configuration. Отобразятся все существующие параметры для службы приложений QnA Maker.This will display all existing settings for the QnA Maker's App Service.

    Снимок экрана портал Azure отображение параметров конфигурации службы приложенийScreenshot of Azure portal showing App Service configuration settings

  4. Измените значения для следующих ключей:Change the values for the following keys:

    • азуресеарчадминкэйAzureSearchAdminKey
    • азуресеарчнамеAzureSearchName
  5. Чтобы использовать новые параметры, необходимо перезапустить службу приложений.To use the new settings, you need to restart the App service. Выберите Обзор, а затем щелкните перезапустить.Select Overview, then select Restart.

    Снимок экрана портал Azure перезапуска службы приложений после изменения параметров конфигурацииScreenshot of Azure portal restarting App Service after configuration settings change

При создании службы QnA с помощью шаблонов Azure Resource Manager можно создать все ресурсы и управлять созданием службы приложений для использования существующей службы поиска.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.

Дополнительные сведения о настройке параметров приложенияслужбы приложений.Learn more about how to configure the App Service Application settings.

Настройка Когнитивный поиск в качестве частной конечной точки в виртуальной сетиConfiguring Cognitive Search as a private endpoint inside a VNET

Когда экземпляр поиска создается во время создания QnA Maker ресурса, можно принудительно Когнитивный поиск для поддержки конфигурации частной конечной точки, созданной полностью в виртуальной сети клиента.When a Search instance is created during the creation of a QnA Maker resource, you can force Cognitive Search to support a private endpoint configuration created entirely within a customer’s VNet.

Чтобы использовать закрытую конечную точку, все ресурсы должны быть созданы в одном регионе.All resources must be created in the same region to use a private endpoint.

  • Ресурс QnA MakerQnA Maker resource
  • новый ресурс Когнитивный поискnew Cognitive Search resource
  • новый ресурс виртуальной сетиnew Virtual Network resource

Выполните следующие действия в портал Azure.Complete the following steps in the Azure portal:

  1. Создайте ресурс QnA Maker.Create a QnA Maker resource.
  2. Создайте новый ресурс Когнитивный поиск с подключением к конечной точке (Data), имеющим значение частный.Create a new Cognitive Search resource with Endpoint connectivity (data) set to Private. Создайте ресурс в том же регионе, в котором находится ресурс QnA Maker, созданный на шаге 1.Create the resource in the same region as the QnA Maker resource created in step 1. Узнайте больше о создании когнитивный поиск ресурса, а затем используйте эту ссылку, чтобы перейти непосредственно на страницу создания ресурса.Learn more about creating a Cognitive Search resource, then use this link to go directly to the creation page of the resource.
  3. Создайте новый ресурс виртуальной сети.Create a new Virtual Network resource.
  4. Настройте виртуальную сеть на ресурсе службы приложений, созданном на шаге 1 этой процедуры.Configure the VNET on the App service resource created in step 1 of this procedure.
    1. Создайте новую запись DNS в виртуальной сети для нового ресурса Когнитивный поиск, созданного на шаге 2.Create a new DNS entry in the VNET for new Cognitive Search resource created in step 2. в Когнитивный поискный IP-адрес.to the Cognitive Search IP address.
  5. Свяжите службу приложений с новым когнитивный Поиск ресурсом, созданным на шаге 2.Associate the App service to the new Cognitive Search resource created in step 2. Затем можно удалить исходный ресурс Когнитивный поиск, созданный на шаге 1.Then, you can delete the original Cognitive Search resource created in step 1.

На портале QnA MakerСоздайте первую базу знаний.In the QnA Maker portal, create your first knowledge base.

Политика бездействия для бесплатных поисковых ресурсовInactivity policy for free Search resources

Если вы не используете ресурс QnA Maker, удалите все ресурсы.If you are not using a QnA maker resource, you should remove all the resources. Если вы не удалите неиспользуемые ресурсы, ваша база знаний перестанет работать, если вы создали свободный поисковый ресурс.If you don't remove unused resources, your Knowledge base will stop working if you created a free Search resource.

Бесплатные ресурсы поиска удаляются через 90 дней без получения вызова API.Free Search resources are deleted after 90 days without receiving an API call.

Настройте параметр простоя службы приложений, чтобы избежать истечения времени ожиданияConfigure App service idle setting to avoid timeout

Служба приложений, которая обслуживает QnA Makerную среду выполнения прогнозирования для опубликованной базы знаний, имеет настройку времени ожидания простоя, которая по умолчанию автоматически истечет, если служба бездействует.The app service, which serves the QnA Maker prediction runtime for a published knowledge base, has an idle timeout configuration, which defaults to automatically time out if the service is idle. Для QnA Maker это означает, что время ожидания API-интерфейса Женератеансвер среды выполнения прогнозирующих событий истекло после периодов отсутствия трафика.For QnA Maker, this means your prediction runtime generateAnswer API occasionally times out after periods of no traffic.

Чтобы приложение прогнозной конечной точки загружалось даже при отсутствии трафика, установите для параметра Idle значение Always on.In order to keep the prediction endpoint app loaded even when there is no traffic, set the idle to always on.

  1. Войдите на портал Azure.Sign in to the Azure portal.

  2. Найдите и выберите службу приложений для QnA Maker ресурса.Search for and select your QnA Maker resource's app service. Он будет иметь то же имя, что и ресурс QnA Maker, но будет иметь другой тип службы приложений.It will have the same name as the QnA Maker resource but it will have a different type of App Service.

  3. Найдите Параметры и выберите Конфигурация.Find Settings then select Configuration.

  4. На панели конфигурация выберите Общие параметры, найдите Always onи выберите в качестве значения.On the Configuration pane, select General settings, then find Always on, and select On as the value.

    На панели конфигурация выберите * * Общие параметры * *, затем найдите * * Always on * * и выберите в качестве значения * * on * *.On the Configuration pane, select General settings, then find Always on, and select On as the value.

  5. Нажмите кнопку сохранить , чтобы сохранить конфигурацию.Select Save to save the configuration.

  6. Вам будет предложено перезапустить приложение, чтобы использовать новый параметр.You are asked if you want to restart the app to use the new setting. Выберите Continue (Продолжить).Select Continue.

Дополнительные сведения о настройке общих параметровслужбы приложений.Learn more about how to configure the App Service General settings.

Настройка Среда службы приложений для размещения службы приложений QnA MakerConfigure App Service Environment to host QnA Maker App Service

Среда службы приложений можно использовать для размещения службы приложений QnA Maker.The App Service Environment can be used to host QnA Maker app service. Если Среда службы приложений является внутренним, необходимо выполнить следующие действия.If the App Service Environment is internal, then you need to follow these steps:

  1. Создайте службу приложений и службу поиска Azure.Create an App service and an Azure search service.
  2. Предоставьте доступ к службе приложений и разрешите доступность QnA Maker как:Expose the app service and allow QnA Maker availability as:
    • Общедоступная — по умолчаниюPublicly available - default
    • Тег службы DNS:DNS service tag:
      • CognitiveServicesManagement
    • IP-адреса, связанные с QnA Maker:IPs associated with QnA Maker are:
      • 13.91.138.22913.91.138.229
      • 40.88.22.2540.88.22.25
      • 13.86.184.14213.86.184.142
      • 20.185.105.2820.185.105.28
      • 13.86.178.1013.86.178.10
  3. Создайте QnA Makerный экземпляр службы (Microsoft. CognitiveServices/Accounts) с помощью Azure Resource Manager, где QnA Maker конечная точка должна иметь значение Среда службы приложений.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.

Непрерывность бизнес-процессов с помощью диспетчера трафикаBusiness continuity with traffic manager

Основная цель плана обеспечения непрерывности бизнес-процессов — создание отказоустойчивой конечной точки базы знаний, которая обеспечит отсутствие простоев бота или приложения, которые его используют.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.

План по обеспечению непрерывности бизнес-процессов для QnA MakerQnA Maker bcp plan

В общих чертах для воплощения представленной выше концепции нужно сделать следующее:The high-level idea as represented above is as follows:

  1. Настройте две параллельные службы QnA Maker в сопряженных регионах Azure.Set up two parallel QnA Maker services in Azure paired regions.

  2. Создайте резервную копию основной службы приложений QnA Maker и восстановите ее во вторичной установке.Backup your primary QnA Maker App service and restore it in the secondary setup. Это обеспечит работу обеих настроек с одним и тем же именем узла и ключами.This will ensure that both setups work with the same hostname and keys.

  3. Обеспечьте синхронизацию основного и дополнительного индексов поиска Azure. Используйте образец GitHub здесь , чтобы узнать, как выполнить резервное копирование для восстановления индексов 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. Создайте резервную копию Application Insights с помощью непрерывного экспорта.Back up the Application Insights using continuous export.

  5. После настройки первичного и вторичного стеков воспользуйтесь диспетчером трафика для настройки двух конечных точек и метода маршрутизации.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. Вам потребуется создать протокол TLS, ранее известный как SSL (SSL), сертификат для конечной точки диспетчера трафика.You would need to create a Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), certificate for your traffic manager endpoint. Привяжите сертификат TLS/SSL в службах приложений.Bind the TLS/SSL certificate in your App services.

  7. Наконец, используйте конечную точку диспетчера трафика в боте или приложении.Finally, use the traffic manager endpoint in your Bot or App.

Удаление ресурсов AzureDelete Azure resources

Если удалить любой из ресурсов Azure, используемых для ваших баз знаний QnA Maker, базы знаний перестанут работать.If you delete any of the Azure resources used for your QnA Maker knowledge bases, the knowledge bases will no longer function. Перед удалением любых ресурсов на странице Настройки убедитесь, что вы экспортируете свои базы знаний.Before deleting any resources, make sure you export your knowledge bases from the Settings page.

Дальнейшие шагиNext steps

Дополнительные сведения о службе приложений и службе поиска.Learn more about the App service and Search service.