Resposta a perguntas pré-construídas

Artigo
09/02/2024

A resposta a perguntas pré-construída fornece ao usuário a capacidade de responder a perguntas sobre uma passagem de texto sem ter que criar bases de conhecimento, manter pares de perguntas e respostas ou incorrer em custos para infraestrutura subutilizada. Essa funcionalidade é fornecida como uma API e pode ser usada para atender às necessidades de perguntas e respostas sem ter que aprender os detalhes sobre o QnA Maker ou armazenamento adicional.

Nota

O serviço QnA Maker será desativado no dia 31 de março de 2025. Uma versão mais recente do recurso de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para obter os recursos de resposta a perguntas no Serviço Linguístico, consulte Resposta a perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos do QnA Maker. Para obter informações sobre como migrar bases de conhecimento existentes do QnA Maker para responder a perguntas, consulte o guia de migração.

Nota

Esta documentação não se aplica à versão mais recente. Para saber mais sobre como usar a API pré-criada com a versão mais recente, consulte a pergunta respondendo ao artigo API pré-criada.

Dada uma consulta do 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 a perguntas pré-construídas

Imagine que tem um ou mais blocos de texto a partir dos quais gostaria de obter respostas para uma determinada pergunta. Convencionalmente, você teria que criar tantas fontes quanto o número de blocos de texto. No entanto, agora com a resposta a perguntas pré-construídas, 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 pré-construída pode ser usada são:

Você está desenvolvendo um aplicativo leitor de ebook para usuários finais que lhes permite destacar texto, inserir uma pergunta e encontrar respostas sobre o texto destacado
Uma extensão do 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 recebe 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:

Pedido de Amostra

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

Consulta de exemplo sobre um único bloco de texto

Corpo do Pedido

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

Pedido de Resposta

No corpo da solicitação acima, consultamos sobre um único bloco de texto. Um exemplo de resposta recebida para a consulta acima é mostrado 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 pré-construídos

Visite a documentação de Limites de API pré-construídos

Referência de API pré-criada

Visite a documentação de referência da API pré-criada para entender os parâmetros de entrada e saída necessários para chamar a API.

Partilhar via