Respuesta a preguntas precompilada

La característica de respuesta a preguntas precompiladas ofrece al usuario la posibilidad de responder preguntas de un fragmento de texto sin tener que crear bases de conocimiento, mantener pares de preguntas y respuestas o incurrir en los costes de una infraestructura infrautilizada. Esta funcionalidad se proporciona como una API y se puede usar para satisfacer las necesidades de preguntas y respuestas sin tener que aprender los detalles sobre QnA Maker ni el almacenamiento adicional.

Nota

El servicio QnA Maker se retirará del mercado el 31 de marzo de 2025. Ya hay disponible una versión más reciente de la funcionalidad de preguntas y respuestas como parte de Lenguaje de Azure AI. Para más información sobre las funcionalidades de respuesta a preguntas en el servicio de lenguaje, consulte Respuesta a preguntas. A partir del 1 de octubre de 2022 no podrá crear nuevos recursos de QnA Maker. Para obtener información sobre la migración de bases de conocimiento de QnA Maker existentes para responder preguntas, consulte la guía de migración.

Nota

Esta documentación no se aplica a la versión más reciente. Para obtener información sobre el uso de la API precompilada en la versión más reciente, consulte el artículo con la respuesta a preguntas sobre la API precompilada.

Dada una consulta de usuario y un bloque de texto o fragmento, la API devolverá una respuesta y una respuesta precisa (si está disponible).

Ejemplo de uso de la funcionalidad de respuesta a preguntas precompilada

Imagine que tiene uno o varios bloques de texto de los que le gustaría obtener las respuestas a una pregunta determinada. En un sistema convencional, habría tenido que crear tantos orígenes como número de bloques de texto. Sin embargo, ahora con la funcionalidad de respuesta a preguntas precompilada puede consultar los bloques de texto sin tener que definir orígenes de contenido en una knowledge base.

A continuación se indican otros escenarios en los que se puede usar la API precompilada:

• Está desarrollando una aplicación de lector de libros electrónicos para usuarios finales que les permite resaltar texto, escribir una pregunta y encontrar respuestas en el texto resaltado.
• Una extensión del navegador permite a los usuarios hacer una pregunta sobre el contenido que se muestra actualmente en la página del navegador.
• Un bot de mantenimiento recibe las consultas de los usuarios y proporciona respuestas basadas en el contenido médico que el bot identifica como más pertinente para la consulta del usuario.

A continuación se muestra un ejemplo de una solicitud:

Solicitud de ejemplo

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

Consulta de ejemplo sobre un único bloque de texto

Cuerpo de la solicitud

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

Respuesta de ejemplo

En el cuerpo de la solicitud anterior, se consulta sobre un único bloque de texto. A continuación se muestra una respuesta de ejemplo recibida para la consulta anterior.

{
    "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 se reciben varias respuestas como parte de la respuesta global de la API. Cada respuesta tiene una puntuación de confianza específica que ayuda a comprender su relevancia general. Los usuarios pueden usar esta puntuación de confianza para mostrar las respuestas a la consulta.

Límites de la API precompilada

Visite la documentación sobre los límites de la API precompilada.

Referencia de la API precompilada

Visite la documentación de referencia de la API precompilada para conocer los parámetros de entrada y salida necesarios para llamar a la API.