Язык — ответы на вопросы
Api ответов на вопросы — это облачная служба, которая обеспечивает расширенную обработку естественного языка с состоянием моделей преобразователя искусства для создания ответов на настраиваемые проекты ответа на вопросы или необработанный текст. Ответ на вопросы — это функция в языковой службе, которая улучшена из службы QnA Maker с дополнительными функциями, такими как поддержка неструктурированных документов и точный ответ.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet |
| Контакт | |
|---|---|
| Имя | Поддержка ответов на вопросы |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| Адрес электронной почты | qnamakersupport@microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsot |
| Веб-сайт | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Политика конфиденциальности | https://privacy.microsoft.com/en-us/privacystatement |
| Категории | Искусственный интеллект; Сайт |
Язык. Соединитель для ответов на вопросы — это соединитель для интеграции любого приложения Power с новой функцией ответа на вопросы в службе языков. С помощью этого соединителя пользователи теперь могут подключаться к новым, а также расширенным функциям ответов на вопросы. В этом соединителе есть действия, которые помогают пользователям
- Создание ответов из проекта
- Получение метаданных проекта
- Создавайте ответы из предоставленного текста в течение определенного периода времени, мы планируем развернуть дополнительные действия для предоставления дополнительных функций нашим клиентам.
Предпосылки
Следуйте инструкциям здесь , чтобы создать проект пользовательского ответа на вопросы.
Получение учетных данных
- После развертывания проекта нажмите кнопку "Получить URL-адрес прогнозирования".
- Получите URL-адрес сайта из имени узла URL-адреса прогнозирования и ключа учетной записи, который будет ключом Ocp-Apim-Subscription-Key.
- Создайте подключение с помощью ключа учетной записи и URL-адреса сайта.
Начало работы с соединителем
Использование соединителя в потоке
- Перейдите в Microsoft Power Automate и щелкните "Создать" и выберите "Мгновенное облако".
- Для тестирования этого соединителя можно щелкнуть "Вручную активировать поток" и щелкнуть его
Create.
- Щелкните "Новый шаг" и выполните поиск "Язык — ответы на вопросы" и выберите один из трех действий.
Действия:
Создание ответа из проекта
- Это действие помогает ответить на указанный вопрос с помощью базы знаний в проекте.
- Этот запрос можно предоставить для создания ответа из проекта "Sample-project"
- Дополнительные сведения о тексте запроса см. здесь: ответы на вопросы — ответы на REST API (Azure Cognitive Services) | Документация Майкрософт
Получение метаданных проекта
- Это действие помогает получить все метаданные проекта.
- Укажите имя проекта, чтобы получить метаданные проекта.
Создание ответа из предоставленного текста
- Это действие помогает ответить на указанный вопрос с помощью предоставленного текста. Чтобы использовать только это действие, в ресурсе языка не требуется включить пользовательский ответ на вопросы.
- Для этого действия не требуется проект пользовательского ответа на вопросы. Для этого требуется только ресурс языка. Вы можете создать языковой ресурс и скопировать конечную точку и ключ с портала Azure в разделе "Ключи и конечная точка" в URL-адрес сайта и ключ учетной записи соответственно.
- Запрос " сколько времени требуется для зарядки поверхности? " на следующем тексте: "Питание и зарядка. Для заряда батареи Surface Pro 4 требуется два-четыре часа, полностью от пустого состояния. Это может занять больше времени, если вы используете Surface для интенсивных действий, таких как игры или потоковая передача видео во время зарядки, он "
- Дополнительные сведения о тексте запроса см. здесь: ответы на вопросы — получение ответов из текста — REST API (Azure Cognitive Services) | Документация Майкрософт
Ответ
Создание ответа из проекта
Он вернет ответ из проекта sample-project для вопроса "Специальные возможности". Дополнительные сведения об объекте ответа для этого действия см. в статье " Ответы на вопросы " Получение ответов - REST API (Azure Cognitive Services) | Документация Майкрософт
Создание ответа из предоставленного текста
Он извлекает ответ на ваш вопрос из заданного текста. Дополнительные сведения об объекте ответа см. в статье "Ответы на вопросы" — получение ответов из текста — REST API (Azure Cognitive Services) | Документация Майкрософт .
Получение метаданных проекта
Он получает метаданные запрошенного проекта. Дополнительные сведения об объекте ответа см. в статье "Ответы на вопросы" — получение сведений о проекте — REST API (Azure Cognitive Services) | Документация Майкрософт .
Известные проблемы и ограничения
Мы не нашли ни одного, пожалуйста, обратитесь к нам, если вы найдете на любом qnamakersupport@microsoft.com
Распространенные ошибки и средства устранения неполадок
См. эту документацию: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
Часто задаваемые вопросы
См. эту документацию: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| Ключ API | Ключ API (ApiKey) | Все регионы | Доступный для общего пользования |
| Интегрированная служба Azure AD | Используйте Azure Active Directory для доступа к хранилищу BLOB-объектов Azure. | Все регионы | Недоступен для совместного использования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Ключ API
Идентификатор проверки подлинности: keyBasedAuth
Применимо: все регионы
Ключ API (ApiKey)
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ учетной записи | securestring | Ключ конечной точки для ресурса языка, скопированного на портале Azure | True |
| URL-адрес сайта | струна | Имя узла ресурса языка, скопированного на портале Azure | True |
Интегрированная служба Azure AD
Идентификатор проверки подлинности: tokenBasedAuth
Применимо: все регионы
Используйте Azure Active Directory для доступа к хранилищу BLOB-объектов Azure.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| URL-адрес сайта | струна | Имя узла ресурса языка, скопированного на портале Azure | True |
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ учетной записи | securestring | Ключ конечной точки для ресурса языка, скопированного на портале Azure | True |
| URL-адрес сайта | струна | Имя узла ресурса языка, скопированного на портале Azure | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение метаданных проекта |
Это действие помогает получить все метаданные проекта. |
| Создание ответа из Project |
Это действие помогает ответить на указанный вопрос с помощью базы знаний в проекте. |
| Создание ответа из предоставленного текста |
Это действие помогает ответить на указанный вопрос с помощью предоставленного текста. |
Получение метаданных проекта
Это действие помогает получить все метаданные проекта.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя проекта
|
ProjectNamePathParameter | True | string |
Имя используемого проекта. |
|
Версия API
|
api-version | True | string |
Это версия клиентского API. |
Возвращаемое значение
Представляет проект.
- Тело
- ProjectMetadata
Создание ответа из Project
Это действие помогает ответить на указанный вопрос с помощью базы знаний в проекте.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя проекта
|
projectName | True | string |
Это имя проекта, которое вы хотите использовать. |
|
Question
|
question | True | string |
Вопрос пользователя к запросу к проекту. |
|
Идентификатор пользователя
|
userId | string |
Уникальный идентификатор пользователя. |
|
|
Вверх #
|
top | integer |
Максимальное количество ответов, возвращаемых для вопроса. |
|
|
Порог достоверности
|
confidenceScoreThreshold | float |
Минимальная оценка порогового значения для ответов. Диапазоны значений от 0 до 1. |
|
|
Тип Ранкера
|
rankerType | string |
Тип используемого ранга. |
|
|
Идентификатор QnA
|
qnaId | string |
Это точный идентификатор QnA для получения из проекта. |
|
|
Предыдущий идентификатор QnA
|
previousQnaId | integer |
Предыдущий поворот верхнего ответа результирующий идентификатор QnA. |
|
|
Предыдущий запрос пользователя
|
previousUserQuery | string |
Предыдущий запрос пользователя. |
|
|
key
|
key | string |
Ключ метаданных из словаря метаданных, используемый в QnA. |
|
|
value
|
value | string |
Значение метаданных из словаря метаданных, используемого в QnA. |
|
|
Присоединение метаданных с помощью
|
logicalOperation | string |
Задайте значение OR или AND для соответствующих логических операций для фильтров метаданных. |
|
|
Исходный фильтр
|
sourceFilter | string |
Найдите QnAs, связанные с любым из указанных источников в проекте. |
|
|
Присоединение фильтров с помощью
|
logicalOperation | string |
Логическая операция, используемая для объединения фильтра метаданных с исходным фильтром. |
|
|
Включение точного ответа
|
enable | boolean |
Включение или отключение прогнозирования диапазона ответов. |
|
|
Порог достоверности
|
confidenceScoreThreshold | float |
Минимальная оценка порогового значения, требуемая для включения точного ответа, диапазон значений составляет от 0 до 1. |
|
|
Вверх #
|
topAnswersWithSpan | integer |
Число лучших ответов, которые следует учитывать для точного прогнозирования ответов от 1 до 10. |
|
|
Включение неструктурированных источников
|
includeUnstructuredSources | boolean |
Пометка для включения запроса по неструктурированным источникам. |
|
|
Название развертывания
|
deploymentName | True | string |
Это конкретное развертывание проекта, который вы хотите использовать. |
|
Версия API
|
api-version | True | string |
Это версия клиентского API. |
Возвращаемое значение
Представляет список ответов на вопросы.
- Тело
- AnswersResult
Создание ответа из предоставленного текста
Это действие помогает ответить на указанный вопрос с помощью предоставленного текста.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Question
|
question | True | string |
Запрос пользователя к заданным текстовым записям. |
|
id
|
id | True | string |
Уникальный идентификатор записи текста. |
|
текст
|
text | True | string |
Текстовое содержимое записи. |
|
Language
|
language | string |
Язык текстовых записей. Это представление языка BCP-47. |
|
|
Тип строкового индекса
|
stringIndexType | string |
Задает метод, используемый для интерпретации смещения строк. По умолчанию текстовые элементы (Graphemes) соответствуют Юникоду версии 8.0.0. Дополнительные сведения см. в https://aka.ms/text-analytics-offsets. |
|
|
Версия API
|
api-version | True | string |
Это версия клиентского API. |
Возвращаемое значение
Представляет результаты ответа.
Определения
ProjectMetadata
Представляет проект.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
имя проекта
|
projectName | string |
Имя проекта. |
|
описание
|
description | string |
Описание проекта. |
|
Language
|
language | Language |
Язык текстовых записей. Это представление языка BCP-47. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Ответ ответа по умолчанию, если в базе знаний не найдено правильного совпадения. |
|
многоязычныйResource
|
multilingualResource | boolean |
Ресурс включен для нескольких языков в проектах или нет. |
|
createdDateTime
|
createdDateTime | date-time |
Дата создания проекта. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Представляет проект последней измененной даты и времени. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Представляет проект последней даты развертывания. |
Language
Язык текстовых записей. Это представление языка BCP-47.
Язык текстовых записей. Это представление языка BCP-47.
- Language
- string
AnswersResult
Представляет список ответов на вопросы.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ответы
|
answers | array of KnowledgeBaseAnswer |
Представляет список результатов ответа. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Возвращает логическое значение, если вопрос пользователя был неоднозначным. |
KnowledgeBaseAnswer
Представляет ответ проекта.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Вопросы
|
questions | array of string |
Список вопросов, связанных с ответом. |
|
ответ
|
answer | string |
Текст ответа. |
|
Порог достоверности
|
confidenceScore | float |
Оценка достоверности ответа, значение диапазонов от 0 до 1. |
|
Идентификатор QnA
|
id | integer |
Идентификатор результата QnA. |
|
source
|
source | string |
Источник результата QnA. |
|
metadata
|
metadata | object |
Метаданные, связанные с ответом, полезны для классификации или фильтрации ответов на вопросы. |
|
диалоговое окно
|
dialog | KnowledgeBaseAnswerDialog |
Диалоговое окно, связанное с ответом. |
|
answerSpan
|
answerSpan | AnswerSpan |
Объект диапазона ответов QnA. |
KnowledgeBaseAnswerDialog
Диалоговое окно, связанное с ответом.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Чтобы пометить, относится ли запрос только к предыдущему вопросу или нет. Если значение true, не включите этот QnA в качестве результата поиска запросов без контекста; в противном случае, если значение false, игнорирует контекст и включает этот QnA в результат поиска. |
|
Запросы
|
prompts | array of KnowledgeBaseAnswerPrompt |
Список запросов, связанных с ответом. |
KnowledgeBaseAnswerPrompt
Запрос ответа.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Индекс запроса — используется в порядке запросов. |
|
qnaId
|
qnaId | integer |
Идентификатор QnA, соответствующий запросу. |
|
displayText
|
displayText | string |
Текст, отображаемый для представления запроса на последующий запрос. |
Область ответов
Объект диапазона ответов QnA.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
текст
|
text | string |
Прогнозируемый текст точного ответа. |
|
Порог достоверности
|
confidenceScore | float |
Прогнозируемая оценка точного ответа, значения варьируются от 0 до 1. |
|
offset
|
offset | integer |
Смещение точного ответа от начала ответа. |
|
length
|
length | integer |
Длина точного ответа. |
AnswersFromTextResult
Представляет результаты ответа.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ответы
|
answers | array of TextAnswer |
Представляет результаты ответа. |
TextAnswer
Представляет результат ответа.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ответ
|
answer | string |
Текст ответа. |
|
Порог достоверности
|
confidenceScore | float |
Оценка достоверности ответа, значение диапазонов от 0 до 1. |
|
id
|
id | string |
Идентификатор записи. |
|
answerSpan
|
answerSpan | AnswerSpan |
Объект диапазона ответов QnA. |
|
offset
|
offset | integer |
Смещение предложения от начала документа. |
|
length
|
length | integer |
Длина предложения. |