Respostas às perguntas predefinidas

Artigo
09/04/2024

As respostas às perguntas predefinidas fornecem ao usuário a capacidade de responder a perguntas sobre uma passagem de texto sem precisar criar bases de dados de conhecimento, manter pares de perguntas e respostas ou incorrer em custos pela infraestrutura subutilizada. Essa funcionalidade é fornecida como uma API e pode ser usada para atender às necessidades de perguntas e respostas sem precisar saber os detalhes de QnA Maker ou armazenamento adicional.

Observação

O serviço de QnA Maker está sendo desativado no dia 31 de março de 2025. Uma versão mais recente da funcionalidade de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para saber mais sobre o recurso de respostas às perguntas no Serviço de Linguagem, confira respostas às perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos de QnA Maker. Para obter informações sobre como migrar bases de dados de conhecimento do QnA Maker existentes para responder à pergunta, consulte o Guia de migração.

Observação

Esta documentação não se aplica à versão mais recente. Para saber mais sobre como usar a API predefinida com a versão mais recente, consulte o artigo sobre a API de resposta às perguntas predefinidas.

Dada uma consulta de usuário e um bloco de texto/passagem, a API retornará uma resposta e uma resposta precisa (se disponível).

Exemplo de uso de Respostas às perguntas predefinidas

Imagine que você tenha um ou mais blocos de texto dos quais você gostaria de obter respostas para uma determinada pergunta. Convencionalmente, você teria que criar um número de fontes equivalente ao número de blocos de texto. No entanto, agora com as Respostas às perguntas predefinidas, você pode consultar os blocos de texto sem precisar definir fontes de conteúdo em uma base de dados de conhecimento.

Alguns outros cenários em que a API Predefinida pode ser usada são:

Você está desenvolvendo um aplicativo de leitor de ebook para usuários finais que permite realçar texto, inserir uma pergunta e encontrar respostas no texto realçado
Uma extensão de navegador que permite aos usuários fazer uma pergunta sobre o conteúdo que está sendo exibido atualmente na página do navegador
Um bot de integridade que usa consultas de usuários e fornece respostas com base no conteúdo médico que o bot identifica como mais relevante para a consulta do usuário

Abaixo está um exemplo de uma solicitação de exemplo:

Solicitação de Exemplo

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

Exemplo de consulta em um único bloco de texto

Corpo da solicitação

{
    "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"
}

Exemplo de Resposta

No corpo da solicitação acima, consultamos um único bloco de texto. Uma resposta de exemplo recebida para a consulta acima é mostrada abaixo,

{
    "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
        }
    ]
}

Vemos que várias respostas são recebidas como parte da resposta da API. Cada resposta tem uma pontuação de confiança específica que ajuda a entender a relevância geral da resposta. Os usuários podem usar essa pontuação de confiança para mostrar as respostas à consulta.

Limites de API Predefinida

Acesse a documentação Limites de API Predefinida

Referência de API Predefinida

Acesse a documentação Referência da API Predefinida para entender os parâmetros de entrada e saída necessários para chamar a API.

Compartilhar via