Устранение неполадок QnA Maker

Краткий список наиболее часто задаваемых вопросов о службе QnA Maker поможет вам быстрее научиться эффективно использовать эту службу для своих задач.

Примечание.

Поддержка службы QnA Maker будет прекращена 31 марта 2025 г. Новая версия вопроса и возможности ответа теперь доступна как часть языка искусственного интеллекта Azure. Сведения о возможностях ответов на вопросы в службе Языка см. в статье с ответами на вопросы. С 1 октября 2022 г. вы не сможете создавать ресурсы QnA Maker. Сведения о переносе существующих баз знаний QnA Maker в функцию вопросов и ответов см. в руководстве по миграции.

Управление прогнозами

Как повысить пропускную способность для прогнозирования запросов?

Ответ. Проблемы с производительностью пропускной способности указывают на необходимость вертикально увеличить масштаб как Службы приложений, так и Когнитивного поиска. Рассмотрите возможность добавления реплики в Когнитивный поиск для повышения производительности.

Подробнее о ценовых категориях см. здесь.

Как получить конечную точку службы QnA Maker?

Ответ. Конечную точку службы QnA Maker удобно использовать для отладки при обращении в службу поддержки QnA Maker или на портал UserVoice. Конечная точка является URL-адресом в следующем формате: https://your-resource-name.azurewebsites.net.

  1. Перейдите к службе QnA Maker (группе ресурсов) на портале Azure.

    Группа ресурсов Azure для QnAMaker на портале Azure

  2. Выберите Службу приложений, связанную с ресурсом QnA Maker. Как правило, имена совпадают.

    Выберите службу приложений QnAMaker

  3. URL-адрес конечной точки указан в разделе "Обзор".

    Конечная точка QnA Maker

Управление базой знаний

Была случайно удалена часть службы QnA Maker. Что теперь делать?

Ответ. Не удаляйте никакие службы Azure, созданных вместе с ресурсом QnA Maker, таким как Поиск или веб-приложение. Они необходимы для работы QnA Maker. Если удалить службу, QnA Maker перестанет работать правильно.

Все операции удаления являются безвозвратными, включая удаление пар вопросов и ответов, файлов, URL-адресов, пользовательских вопросов и ответов, баз знаний или ресурсов Azure. Убедитесь, что база знаний была экспортирована на странице Параметры, прежде чем удалять часть базы знаний.

Почему для указанных мной URL-адресов или файлов не извлекаются пары "вопрос–ответ"?

Ответ. В некоторых случаях QnA Maker не может автоматически извлечь содержимое в формате "вопрос — ответ" по допустимым URL-адресам. В таких случаях поместите нужное содержимое в TXT-файл и проверьте, сможет ли средство извлечь содержимое в таком формате. Кроме того, вы можете использовать интерфейс редактора для добавления содержимого в базу знаний на портале QnA Maker.

Базу данных какого размера можно создать?

Ответ. Допустимый размер базы знаний зависит от номера SKU, который вы выбрали для Поиска Azure при создании службы QnA Maker. Дополнительные сведения см. здесь.

Почему ничего не отображается в раскрывающемся списке, когда я пытаюсь создать базу знаний?

Ответ. Скорее всего, вы еще не создали службу QnA Maker в Azure. Щелкните здесь, чтобы узнать, как это сделать.

Как поделиться базой знаний с другими пользователями?

Ответ. Совместное использование работает на уровне службы QnA Maker, т. е. все базы знаний в службах предоставляются для общего доступа. Здесь подробно описана совместная работа над базой знаний.

Можно ли предоставить базу знаний для редактирования участнику, который находится в другом клиенте AAD?

Ответ. При общем доступе используется механизм управления доступом на основе ролей Azure. Если вы можете предоставить общий доступ к любому ресурсу в Azure другому пользователю, вы можете сделать то же самое с QnA Maker.

Имея план Службы приложений с пятью базами знаний QnAMaker, можно ли предоставить пяти разным пользователям права на чтение и запись так, чтобы каждый из них мог использовать только одну базу знаний QnA Maker?

Ответ. Общий доступ предоставляется к службе QnA Maker в целом, а не к отдельным базам знаний.

Как изменить сообщение, которое отображается по умолчанию при отсутствии подходящего совпадения?

Ответ. Это сообщение по умолчанию настраивается в службе приложений.

  • Перейдите к ресурсу службы приложений на портале Azure.

Служба приложений QnA Maker

  • Выберите элемент Параметры.

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

  • Измените значение параметра DefaultAnswer.
  • Перезапустите службу приложений.

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

Почему ничего не извлекается по ссылке на SharePoint?

Ответ. Дополнительные сведения см. в разделе о расположениях источников данных.

Изменения, внесенные в базу знаний, не отразились в публикации. Почему так произошло?

Ответ. Любую операцию изменения (обновление таблиц, тесты или настройки) нужно сохранить, чтобы она была опубликована. Не забывайте нажать кнопку Сохранить и обучить после любого изменения данных.

Поддерживает ли база знаний форматированные данные или мультимедиа?

Ответ:

Автоматическое извлечение файлов и URL-адресов из мультимедиа

  • URL-адреса — ограничено преобразованием HTML в Markdown.
  • Файлы — не поддерживается.

Текст ответа в Markdown

После того как пары "вопрос-ответ" находятся в базе знаний, текст ответа в Markdown можно изменить, включив в него ссылки на мультимедиа, размещенные по общедоступным URL-адресам.

Поддерживает ли QnA Maker языки, отличные от английского?

Ответ. Сведения о поддерживаемых языках вы найдете на этой странице.

Если у вас есть содержимое на нескольких языках, обязательно создайте отдельную службу для каждого языка.

Управление службой

Когда следует перезапускать службу приложений?

Ответ. Обновите службу приложений, когда значок предупреждения отображается рядом со значением версии базы знаний в таблице Ключи конечной точки на странице Параметры пользователя.

Моя существующая служба "Поиск" удалена. Как это исправить?

Ответ. Если удалить индекс поиска ИИ Azure, операция завершается и индекс не может быть восстановлен.

Удален индекс testkb в службе "Поиск". Как это исправить?

Ответ: если вы удалили индекс testkb в Службе "Поиск", вы можете восстановить данные из последней опубликованной базы знаний. Воспользуйтесь средством восстановления RestoreTestKBIndex, доступным на GitHub.

Я получаю сообщение об ошибке следующего содержания: "Проверьте, разрешают ли https://www.qnamaker.ai настройки CORS службы приложений QnA Maker или существуют ли какие-либо сетевые ограничения для конкретной организации". Как решить эту проблему?

Ответ. В разделе API области службы приложений измените параметр CORS на * или https://www.qnamaker.ai". Если проблема не устранена, проверьте наличие ограничений, связанных с конкретной организацией.

Когда нужно обновлять ключи конечной точки?

Ответ. Обновляйте ключи конечной точки каждый раз, когда есть основания подозревать их компрометацию.

Можно ли использовать один и тот же ресурс поиска ИИ Azure для база знаний с помощью нескольких языков?

Ответ. Чтобы использовать несколько языков и несколько баз знаний, пользователю придется создать ресурс QnA Maker для каждого языка. При этом для каждого языка будет создана отдельная служба поиска Azure. Сочетание баз знаний на нескольких языках в одной службе поиска Azure приведет к снижению релевантности результатов.

Как изменить имя ресурса поиска ИИ Azure, используемого QnA Maker?

Ответ. Имя ресурса поиска ИИ Azure — это имя ресурса QnA Maker с некоторыми случайными буквами, добавленными в конце. Из-за этого QnA Maker трудно различить несколько ресурсов службы "Поиск". Создайте отдельную службу поиска (назовите ее, как вам удобно) и подключите ее к своей службе QnA. Шаги похожи на шаги, необходимые для обновления службы "Поиск Azure".

Если QnA Maker возвращает сообщение "Ядро среды выполнения не инициализировано", как это исправить?

Ответ. Место на диске для службы приложений может закончиться. Действия по освобождению дискового пространства:

  1. На портале Azure выберите Службу приложений QnA Maker, а затем закройте службу.

  2. Находясь в Службе приложений, выберите Средства разработки, затем — Дополнительные инструменты, после чего выберите Перейти. Откроется новое окно браузера.

  3. Выберите Консоль отладки, а затем — CMD, чтобы открыть программу командной строки.

  4. Перейдите в каталог site/wwwroot/Data/QnAMaker/.

  5. Удалите все папки, имена которых начинаются с rd.

    Не удаляйте следующее:

    • файл KbIdToRankerMappings.txt;
    • файл EndpointSettings.json;
    • папку EndpointKeys.
  6. Запустите Службу приложений.

  7. Откройте базу знаний, чтобы проверить, работает ли она сейчас.

Почему Application Insights не работает?

Ответ. Проведите перекрестную проверку и выполните следующие шаги, чтобы устранить проблему.

  1. Убедитесь, что параметр UserAppInsightsKey в разделе "Служба приложений -> Параметры -> Конфигурация -> Параметры приложения” настроен правильно и для него задан GUID соответствующей вкладки "Обзор" в Application Insights ("Ключ инструментирования").

  2. Убедитесь, что в разделе "Служба приложений -> Параметры -> Application Insights” функция Application Insights включена и подключена к соответствующему ресурсу Application Insights.

Моя служба Application Insights включена, но почему-то работает неправильно. В чем дело?

Ответ. Выполните указанные ниже действия.

  1. Скопируйте значение параметра "APPINSIGHTS_INSTRUMENTATIONKEY" в "UserAppInsightsKey" путем переопределения, если там уже присутствует какое-либо значение.

  2. Если ключ "UserAppInsightsKey" не существует в параметрах приложения, добавьте новый ключ с таким именем и скопируйте значение.

  3. Сохраните его, и это приведет к автоматическому перезапуску службы приложений. Возможно, это позволит решить проблему.

Интеграция с другими службами, в том числе ботами

Нужна ли платформа Bot Framework для использования QnA Maker?

Ответ. Нет, вам не нужно использовать Bot Framework с QnA Maker. Однако QnA Maker предлагается в качестве одного из нескольких шаблонов в Azure AI Служба Bot. Служба Azure Bot позволяет быстро разрабатывать интеллектуальные боты на платформе Microsoft Bot Framework, которые выполняются в бессерверной среде.

Как создать новый бот с помощью QnA Maker?

Ответ. Следуйте инструкциям в этой документации по созданию бота с помощью Azure AI Служба Bot.

Разделы справки использовать другую база знаний с существующим Служба Bot ИИ Azure?

Ответ. Необходимо иметь следующие сведения о базе знаний:

  • Идентификатор базы знаний.
  • Имя личного поддомена опубликованной конечной точки базы знаний, известное как host (находится на странице Параметры после публикации).
  • Опубликованный ключ конечной точки базы знаний (находится на странице Параметры после публикации).

Используя эти сведения, перейдите в службу приложений бота на портале Azure. В разделе Параметры -> Конфигурация -> Параметры приложения измените соответствующие значения.

Ключ конечной точки базы знаний отмечен в службе ABS как QnAAuthkey.

Могут ли несколько клиентских приложений совместно использовать одну базу знаний?

Ответ. Да, запросы к базе знаний можно отправлять с любого числа клиентов. Если ответ базы знаний приходится ждать слишком долго или истекает время ожидания ответа, рассмотрите возможность обновления уровня служб для службы приложений, связанной с базой знаний.

Как внедрить службу QnA Maker в веб-сайт?

Ответ. Чтобы внедрить службу QnA Maker в качестве элемента управления веб-чатом, сделайте следующее:

  1. Создайте бота вопросов и ответов, следуя этим инструкциям.
  2. Включите веб-чат, выполнив шаги из этой статьи.

Хранилище данных

Какие данные сохраняются и где они хранятся?

Ответ:

При создании службы QnA Maker вы указываете регион Azure. Базы знаний и файлы журналов хранятся в этом регионе.