Risposta predefinita alle domande

La risposta alle domande predefinite fornisce all'utente la possibilità di rispondere alle domande su un passaggio di testo senza dover creare knowledgebase, gestire coppie di domande e risposte o sostenere costi per l'infrastruttura sottoutilizzata. Questa funzionalità viene fornita come API e può essere usata per soddisfare domande e rispondere alle esigenze senza dover apprendere i dettagli su QnA Maker o archiviazione aggiuntiva.

Nota

Il servizio QnA Maker viene ritirato il 31 marzo 2025. Una versione più recente della domanda e della funzionalità di risposta è ora disponibile come parte del linguaggio di intelligenza artificiale di Azure. Per le funzionalità di risposta alle domande all'interno del servizio linguistico, vedere La risposta alle domande. A partire dal 1° ottobre 2022 non sarà possibile creare nuove risorse QnA Maker. Per informazioni sulla migrazione delle knowledge base QnA Maker esistenti alla risposta alle domande, consultare 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, vedere l'articolo sull'API predefinita di risposta alla domanda.

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

Utilizzo di esempio di risposte alle domande predefinite

Si supponga di avere uno o più blocchi di testo da cui si desidera ottenere risposte per una determinata domanda. In modo convenzionale, sarebbe stato necessario creare quante origini il numero di blocchi di testo. Tuttavia, ora con la risposta alle domande predefinite è possibile eseguire query sui blocchi di testo senza dover definire origini contenuto in un knowledge base.

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

• Si sta sviluppando un'app di lettura ebook per gli utenti finali che consente loro di evidenziare il testo, immettere una domanda e trovare risposte sul testo evidenziato
• Estensione del browser che consente agli utenti di porre una domanda sul contenuto attualmente visualizzato nella pagina del browser
• Un bot di integrità che accetta query dagli utenti e fornisce risposte in base al contenuto medico identificato dal bot come più rilevante per la query 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 più risposte vengono ricevute come parte della risposta 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 predefiniti

Visitare la documentazione relativa ai limiti dell'API predefinita

Informazioni di riferimento sulle API predefinite

Visitare la documentazione di riferimento dell'API predefinita per comprendere i parametri di input e output necessari per chiamare l'API.