Risposta predefinita alle domande

Articolo
09/03/2024

La risposta predefinita alle domande offre all'utente la possibilità di rispondere alle domande in base a un passaggio di testo senza dover creare delle knowledge base, gestire coppie di domande e risposte o sostenere costi per un'infrastruttura sottoutilizzata. Questa funzionalità viene fornita come API e può essere usata per soddisfare le esigenze di domande e risposte senza dover ottenere informazioni dettagliate su QnA Maker o archiviazione aggiuntiva.

Nota

Il servizio QnA Maker sarà ritirato il 31 marzo 2025. Una versione più recente della funzionalità di domande e risposte è ora disponibile come parte di Lingua di Azure AI. Per le funzionalità di risposta alla domanda all'interno del servizio di linguaggio vedere Risposta alla domanda. A partire dal 1° ottobre 2022 non è più possibile creare nuove risorse di QnA Maker. Per informazioni sulla migrazione delle knowledge base di QnA Maker esistenti alla risposta alla domanda, vedere la guida alla migrazione.

Nota

Questa documentazione non si applica alla versione più recente. Per informazioni sull'uso dell'API predefinita con la versione più recente, vedi l'articolo risposta alla domanda con l’API predefinita.

Dati una query utente e un blocco di testo/passaggio, l'API restituirà una risposta e una risposta precisa (se disponibile).

Esempio di utilizzo della risposta alla domanda predefinita

Supponi di avere uno o più blocchi di testo da cui vuoi ottenere risposte a una determinata domanda. Normalmente, sarebbe stato necessario creare tante origini quanti blocchi di testo. Tuttavia ora, con la risposta alle domande predefinite, è possibile eseguire query sui blocchi di testo senza dover definire le origini del contenuto in una knowledge base.

Altri scenari in cui è possibile usare l'API predefinita sono:

Stai sviluppando un'app lettore di ebook per gli utenti finali che consente loro di evidenziare il testo, immettere una domanda e trovare risposte su un testo evidenziato.
Estensione del browser che consente agli utenti di porre una domanda sul contenuto corrente visualizzato nella pagina del browser
Bot di integrità che esegue query dagli utenti e fornisce risposte in base al contenuto medico identificato dal bot come più rilevante per la query dell'utente

Di seguito è riportato un esempio di richiesta di esempio:

Richiesta di esempio

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

Query di esempio su un singolo blocco di testo

Corpo della richiesta

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

Risposta di esempio

Nel corpo della richiesta precedente, viene eseguita una query su un singolo blocco di testo. Di seguito è riportata una risposta di esempio ricevuta per la query precedente.

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

Si noterà che vengono ricevute più risposte come parte della risposta dell'API. Ogni risposta ha un punteggio di attendibilità specifico che consente di comprendere la rilevanza complessiva della risposta. Gli utenti possono usare questo punteggio di attendibilità per visualizzare le risposte alla query.

Limiti dell'API predefinita

Vedi la documentazione relativa ai Limiti dell'API predefinita

Informazioni di riferimento sulle API predefinite

Visita la documentazione di riferimento sulle API predefinite per comprendere i parametri di input e output necessari per chiamare l'API.

Condividi tramite