Готовые ответы на вопросы

Готовые ответы на вопросы предоставляют пользователю возможность отвечать на вопросы в отрывке текста без необходимости создавать базы знаний, поддерживать пары вопросов и ответов или нести расходы на недостаточно используемую инфраструктуру. Данная функция предоставляется в виде API и может использоваться для решения вопросов и ответов без необходимости изучать подробности о QnA Maker или дополнительном хранилище.

Примечание

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

Примечание

Эта документация не относится к последнему выпуску. Дополнительные сведения об использовании готового API с последним выпуском см. в статье Ответы на вопросы о готовом API.

Учитывая пользовательский запрос и блок текста/отрывка, API вернет ответ и точный ответ (если таковой доступен).

Пример использования готовых ответов на вопросы

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

Ниже представлен ряд других сценариев, в которых можно использовать Prebuilt API:

• Вы разрабатываете приложение для чтения электронных книг для конечных пользователей, которое позволяет им выделять текст, вводить вопрос и находить ответы поверх выделенного текста
• Расширение браузера, позволяющее пользователям задавать вопросы о содержимом, отображаемом в данный момент на странице браузера
• Бот для проверки работоспособности, который принимает запросы от пользователей и предоставляет ответы на основе медицинского контента, который бот определяет как наиболее релевантный запросу пользователя

Ниже приведен пример запроса:

Пример запроса

POST https://{Endpoint}/qnamaker/v5.0-preview.2/generateanswer

Пример запроса к одному блоку текста

Текст запроса

{
    "question": "How long it takes to charge surface pro 4?",
    "documents": [
        {
            "text": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "id": "doc1"
        }
    ],
    "Language": "en"
}

Пример ответа

В вышеприведенном тексте запроса мы запрашиваем один блок текста. Образец ответа, полученного на вышеуказанный запрос, приведен ниже,

{
    "answers": [
        {
            "answer": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "answerSpan": {
                "text": "two to four hours",
                "score": 0.0,
                "startIndex": 47,
                "endIndex": 64
            },
            "score": 0.9599020481109619,
            "id": "doc1",
            "answerStartIndex": 0,
            "answerEndIndex": 390
        },
        {
            "answer": "It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "score": 0.06749606877565384,
            "id": "doc1",
            "answerStartIndex": 129,
            "answerEndIndex": 390
        },
        {
            "answer": "You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "score": 0.011389964260160923,
            "id": "doc1",
            "answerStartIndex": 265,
            "answerEndIndex": 390
        }
    ]
}

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

Предварительно созданные ограничения API

Посетите документацию по предварительно созданным ограничениям API

Справочник по готовым API

Посетите Cправочник по готовым API , чтобы понять, какие параметры ввода и вывода необходимы для вызова API.