Resposta a perguntas pré-criadas

A resposta a perguntas pré-criadas proporciona ao utilizador a capacidade de responder a perguntas sobre uma passagem de texto sem ter de criar bases de dados de conhecimento, manter pares de perguntas e respostas ou incorrer em custos para infraestruturas subutilizadas. Esta funcionalidade é fornecida como uma API e pode ser utilizada para satisfazer as necessidades de perguntas e respostas sem ter de saber os detalhes sobre o Criador de FAQ ou armazenamento adicional.

Nota

O serviço Criador de FAQ será descontinuado a 31 de março de 2025. Uma versão mais recente da capacidade de perguntas e respostas está agora disponível como parte da Linguagem de IA do Azure. Para obter as capacidades de resposta a perguntas no Serviço de Idioma, veja Resposta a perguntas. A partir de 1 de outubro de 2022, não poderá criar novos recursos do Criador de FAQ. Para obter informações sobre como migrar bases de dados de conhecimento existentes do Criador de FAQ 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 utilizar a API Pré-criada com a versão mais recente, consulte o artigo sobre a API pré-criada de resposta a perguntas.

Tendo em conta uma consulta de utilizador e um bloco de texto/passagem, a API devolverá uma resposta e uma resposta precisa (se disponível).

Exemplo de utilização de respostas a perguntas pré-criadas

Imagine que tem um ou mais blocos de texto a partir dos quais gostaria de obter respostas para uma determinada pergunta. Convencionalmente, teria de criar tantas origens como o número de blocos de texto. No entanto, agora com respostas a perguntas pré-criadas, pode consultar os blocos de texto sem ter de definir origens de conteúdo numa base de dados de conhecimento.

Outros cenários em que a API Pré-criada pode ser utilizada são:

• Está a desenvolver uma aplicação de leitor de ebooks para utilizadores finais que lhes permite realçar texto, introduzir uma pergunta e encontrar respostas sobre texto realçado
• Uma extensão do browser que permite aos utilizadores fazerem uma pergunta sobre o conteúdo que está a ser atualmente apresentado na página do browser
• Um bot de estado de funcionamento que recebe consultas dos utilizadores e fornece respostas com base no conteúdo médico que o bot identifica como mais relevante para a consulta do utilizador

Segue-se um exemplo de um pedido de exemplo:

Pedido de Amostra

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

Consulta de Exemplo num ú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"
}

Resposta de Amostra

No corpo do pedido acima, consultamos um único bloco de texto. É apresentada abaixo uma resposta de exemplo recebida para a consulta acima,

{
    "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 são recebidas várias respostas como parte da resposta da API. Cada resposta tem uma classificação de confiança específica que ajuda a compreender a relevância geral da resposta. Os utilizadores podem utilizar esta classificação de confiança para mostrar as respostas à consulta.

Limites da API Pré-criada

Veja a documentação Limites da API Pré-criada

Referência da API pré-criada

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