Partager via


Réponses aux questions prédéfinies

La fonctionnalité Réponses aux questions prédéfinies offre à l’utilisateur la capacité de répondre à une question sur un passage de texte sans devoir créer de base de connaissances, conserver des paires de question-réponse ni occasionner un coût pour une infrastructure sous-exploitée. Cette fonctionnalité fournie en tant qu’API peut être utilisée pour satisfaire des besoins en matière de questions et de réponses sans avoir à apprendre les détails de QnA Maker ou d’un stockage supplémentaire.

Notes

Le service QnA Maker sera mis hors service le 31 mars 2025. Une version plus récente de la fonctionnalité de questions et réponses est désormais disponible dans le cadre d’Azure AI Language. Pour obtenir des réponses aux questions au sein du service de langage, consultez Réponses aux questions. À partir du 1er octobre 2022 vous ne pourrez plus créer de nouvelles ressources QnA Maker. Pour plus d’informations sur la migration de bases de connaissances QnA Maker existantes vers Réponses aux questions, consultez le Guide de migration.

Notes

Cette documentation ne s’applique pas à la dernière version. Pour en savoir plus sur l’utilisation de l’API prédéfinie avec la version la plus récente, consultez l’article sur l’API prédéfinie de réponses aux questions.

À partir d’une requête utilisateur et d’un bloc ou passage de texte, l’API retourne une réponse précise (si disponible).

Exemple d’utilisation de la fonctionnalité Réponses aux questions prédéfinies

Imaginez que vous disposez d’un ou plusieurs blocs de texte dans lesquels vous souhaitez trouver des réponses à une question donnée. Normalement, vous auriez dû créer autant de sources qu’il y a de blocs de texte. En revanche, désormais, la fonctionnalité Réponses aux questions prédéfinies vous permet d’interroger les blocs de texte sans avoir à définir des sources de contenu dans une base de connaissances.

Voici d’autres scénarios dans lesquels vous pouvez utiliser l’API prédéfinie :

  • Application de lecteur de livre électronique permettant aux utilisateurs de mettre du texte en surbrillance, d’entrer une question et d’obtenir des réponses en relation avec le texte sélectionné.
  • Extension de navigateur permettant aux utilisateurs de poser une question sur le contenu de la page affichée dans le navigateur.
  • Robot dédié à la santé qui accepte des requêtes d’utilisateurs et fournit des réponses basées sur le contenu médical que le bot identifie comme le plus pertinent.

Voici un exemple de demande :

Exemple de demande

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

Exemple de requête sur un seul bloc de texte

Corps de la demande

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

Exemple de réponse

Dans le corps de la demande ci-dessus, nous effectuons une requête sur un bloc de texte. Un exemple de réponse reçue à cette requête figure ci-dessous.

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

Nous voyons que l’API propose plusieurs réponses. Chaque réponse est associée à un score de confiance spécifique qui permet d’en comprendre la pertinence. L’utilisateur peut utiliser ce score de confiance pour afficher les réponses à la requête.

Limites de l’API prédéfinie

Consultez la documentation sur les Limites d’une API prédéfinie

Référence de l’API prédéfinie

Pour comprendre les paramètres d’entrée et de sortie requis pour appeler l’API, consultez la documentation de Référence de l’API prédéfinie.