Fördefinierad fråga som besvarar

Artikel
01/19/2024

Fördefinierade frågesvar ger användaren möjlighet att besvara frågor över ett textavsnitt utan att behöva skapa kunskapsbaser, underhålla fråge- och svarspar eller medföra kostnader för underutnyttjd infrastruktur. Den här funktionen tillhandahålls som ett API och kan användas för att uppfylla fråge- och svarsbehov utan att du behöver lära dig mer om QnA Maker eller ytterligare lagring.

Anteckning

QnA Maker-tjänsten dras tillbaka den 31 mars 2025. En nyare version av fråge- och svarsfunktionen är nu tillgänglig som en del av Azure AI Language. Information om funktioner för frågesvar i språktjänsten finns i frågor som besvaras. Från och med den 1 oktober 2022 kan du inte skapa nya QnA Maker-resurser. Information om hur du migrerar befintliga QnA Maker-kunskapsbaser till frågesvar finns i migreringsguiden.

Anteckning

Den här dokumentationen gäller inte för den senaste versionen. Mer information om hur du använder det fördefinierade API:et med den senaste versionen finns i artikeln om att besvara fördefinierade API:et.

Med tanke på en användarfråga och ett text-/passageblock returnerar API:et ett svar och ett exakt svar (om tillgängligt).

Exempel på användning av fördefinierade frågor som besvaras

Anta att du har ett eller flera textblock som du vill få svar på en viss fråga från. Normalt skulle du ha varit tvungen att skapa så många källor som antalet textblock. Men nu när den fördefinierade frågan besvaras kan du fråga textblocken utan att behöva definiera innehållskällor i en kunskapsbas.

Några andra scenarier där det fördefinierade API:et kan användas är:

Du utvecklar en e-bokläsarapp för slutanvändare som gör att de kan markera text, ange en fråga och hitta svar över markerad text
Ett webbläsartillägg som gör det möjligt för användare att ställa en fråga om innehållet som för närvarande visas på webbläsarsidan
En hälsorobot som tar frågor från användare och ger svar baserat på det medicinska innehåll som roboten identifierar som mest relevant för användarfrågan

Nedan visas ett exempel på en exempelbegäran:

Exempelförfrågan

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

Exempelfråga över ett enda textblock

Begärandetext

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

Exempelsvar

I begärandetexten ovan frågar vi över ett enda textblock. Ett exempelsvar som tas emot för ovanstående fråga visas nedan.

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

Vi ser att flera svar tas emot som en del av API-svaret. Varje svar har en specifik konfidenspoäng som hjälper dig att förstå svarets övergripande relevans. Användarna kan använda den här konfidenspoängen för att visa svaren på frågan.

Fördefinierade API-gränser

Gå till dokumentationen för fördefinierade API-gränser

Fördefinierad API-referens

Gå till den fördefinierade API-referensdokumentationen för att förstå de indata- och utdataparametrar som krävs för att anropa API:et.

Dela via