Vooraf samengestelde vraag beantwoorden

Artikel
10/16/2024

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

Notitie

De QnA Maker-service wordt op 31 maart 2025 buiten gebruik gesteld. Een nieuwere versie van de vraag- en antwoordmogelijkheid is nu beschikbaar als onderdeel van Azure AI Language. Zie vraagantwoording voor vragen in de Language Service voor het beantwoorden van vragen. Vanaf 1 oktober 2022 kunt u geen nieuwe QnA Maker-resources 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 versie. Raadpleeg het antwoord op het vooraf samengestelde API-artikel voor meer informatie over het gebruik van de vooraf gemaakte API met de nieuwste versie.

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

Voorbeeld van het gebruik van vooraf gedefinieerde vraagantwoorden

Stel dat u een of meer tekstblokken hebt waaruit u antwoorden wilt krijgen voor een bepaalde vraag. Normaal gesproken had u zoveel bronnen moeten maken als het aantal tekstblokken. Nu met vooraf samengestelde vragen kunt u echter query's uitvoeren op de tekstblokken zonder dat u inhoudsbronnen hoeft te definiëren in een knowledge base.

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

U ontwikkelt een ebooklezer-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 meest relevant voor de gebruikersquery

Hieronder ziet u een voorbeeld van een voorbeeldaanvraag:

Voorbeeldaanvraag

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

Voorbeeldquery over één blok tekst

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

Voorbeeldantwoord

In de bovenstaande aanvraagtekst voeren we een query uit 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 inzicht biedt in de algehele relevantie van het antwoord. Gebruikers kunnen deze betrouwbaarheidsscore gebruiken om de antwoorden op de query weer te geven.

Vooraf gedefinieerde API-limieten

Ga naar de documentatie voor vooraf gedefinieerde API-limieten

Vooraf gedefinieerde API-verwijzing

Ga naar de referentiedocumentatie voor vooraf gedefinieerde API om inzicht te hebben in de invoer- en uitvoerparameters die nodig zijn voor het aanroepen van de API.

Delen via