Vooraf samengestelde vragen beantwoorden

Vooraf samengestelde vragen beantwoorden biedt de gebruiker de mogelijkheid om vragen te beantwoorden via een passage van tekst zonder knowledgebases te hoeven maken, vraag- en antwoordparen te hoeven onderhouden of kosten in rekening te hoeven brengen voor te weinig gebruikte infrastructuur. Deze functionaliteit wordt geleverd als een API en kan worden gebruikt om te voldoen aan vraag- en antwoordbehoeften zonder dat u meer hoeft te weten te komen over QnA Maker of extra opslag.

Notitie

De QnA Maker-service wordt op 31 maart 2025 buiten gebruik gesteld. Er is nu een nieuwere versie van de vraag- en antwoordmogelijkheid beschikbaar als onderdeel van Azure AI Language. Zie Vragen beantwoorden voor mogelijkheden voor het beantwoorden van vragen binnen de Taalservice. Vanaf 1 oktober 2022 kunt u geen nieuwe QnA Maker-resources meer maken. Raadpleeg de migratiehandleiding voor informatie over het migreren van bestaande QnA Maker-knowledge bases om vragen te beantwoorden.

Notitie

Deze documentatie is niet van toepassing op de nieuwste release. Voor meer informatie over het gebruik van de vooraf gemaakte API met de nieuwste release raadpleegt u het artikel vragen beantwoorden over vooraf samengestelde API.

Op basis van een gebruikersquery en een blok tekst/passage retourneert de API een antwoord en een nauwkeurig antwoord (indien beschikbaar).

Voorbeeld van gebruik van vooraf samengestelde vragen beantwoorden

Stel dat u een of meer tekstblokken hebt waaruit u antwoord wilt krijgen op een bepaalde vraag. Normaal gesproken zou u net zoveel bronnen moeten maken als het aantal blokken tekst. Met vooraf gedefinieerde vragen kunt u nu echter een query uitvoeren op de tekstblokken zonder dat u inhoudsbronnen hoeft te definiëren in een Knowledge Base.

Enkele andere scenario's waarin de vooraf gebouwde API kan worden gebruikt, zijn:

• U ontwikkelt een ebook reader-app voor eindgebruikers waarmee ze tekst kunnen markeren, een vraag kunnen invoeren en antwoorden kunnen vinden op gemarkeerde tekst
• Een browserextensie waarmee gebruikers een vraag kunnen stellen over de inhoud die momenteel wordt weergegeven op de browserpagina
• Een statusbot die query's van gebruikers opneemt en antwoorden geeft op basis van de medische inhoud die de bot identificeert als het meest relevant voor de gebruikersquery

Hieronder ziet u een voorbeeld van een aanvraag:

Voorbeeldaanvraag

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

Voorbeeldquery op één tekstblok

Aanvraagbody

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

Voorbeeldreactie

In de bovenstaande aanvraagtekst wordt een query uitgevoerd op één tekstblok. Hieronder ziet u een voorbeeldantwoord dat is ontvangen voor de bovenstaande query.

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

We zien dat er meerdere antwoorden worden ontvangen als onderdeel van het API-antwoord. Elk antwoord heeft een specifieke betrouwbaarheidsscore die helpt de algemene relevantie van het antwoord te begrijpen. Gebruikers kunnen deze betrouwbaarheidsscore gebruiken om de antwoorden op de query weer te geven.

Vooraf gedefinieerde API-limieten

Ga naar de documentatie over vooraf gedefinieerde API-limieten

Naslaginformatie over vooraf gemaakte API

Ga naar de referentiedocumentatie voor vooraf gemaakte API voor meer informatie over de invoer- en uitvoerparameters die nodig zijn voor het aanroepen van de API.