QnA Maker-REST-API-Referenz – Azure Cognitive Services

In diesem Artikel wird veranschaulicht, wie Sie einen REST-API-Endpunkt für QnA Maker aufrufen, einen Dienst in der Azure Cognitive Services-Suite. QnA Maker ist ein cloudbasierter NLP-Dienst (Natural Language Processing, Verarbeitung natürlicher Sprache), mit dem Sie eine natürliche Konversationsebene für Ihre Daten erstellen können. Er wird dazu verwendet, für eine beliebige Eingabe die am besten geeignete Antwort aus Ihrer benutzerdefinierten Wissensdatenbank (Knowledge Base, KB) zu finden. QnA Maker wird häufig mithilfe von Clientanwendungen für die Konversation erstellt, darunter Anwendungen für soziale Medien, Chatbots und sprachaktivierte Desktopanwendungen.

Aufrufen des QnA Maker-Endpunkts

1. Erstellen Sie zunächst eine Azure Cognitive Services-Ressource und innerhalb dieser speziell eine QnA Maker-Ressource. Anweisungen finden Sie unter Erstellen einer Cognitive Services-Ressource mithilfe des Portals.

2. Kopieren Sie im Azure-Portal den Schlüssel und Endpunkt, der für den Anruf erforderlich ist. Anweisungen finden Sie unter Abrufen der Schlüssel für Ihre Ressource.

3. Erweitern Sie im linken Navigationsbereich in diesem Artikel den Knoten für die Version der API, an der Sie arbeiten möchten, und wählen Sie dann den Vorgang aus, den Sie ausführen möchten (z. B. Änderungen abrufen). Wählen Sie im rechten Bereich Ausprobieren aus.

4. Führen Sie im Bereich Testen der REST-API die folgenden Schritte aus:

   1. Geben Sie im Textfeld Endpunkt den Ressourcenendpunkt ein, den Sie aus dem Azure-Portal kopiert haben.
   2. Geben Sie im Textfeld Ocp-Apim-Subscription-Key den Schlüssel ein, den Sie aus dem Azure-Portal kopiert haben. Wenn für den Aufruf weitere Header erforderlich sind, fügen Sie auch diese mit den entsprechenden Werten hinzu.
   3. Stellen Sie weitere Parameter, Header und Nachrichtennutzlast (Text) bereit, die für den Vorgang erforderlich sind.
   4. Klicken Sie auf Run (Ausführen).

5. Die relevante Antwort wird mit einem entsprechenden Antwortcode angezeigt.

Beispiele

Im GitHub-Repository Cognitive Services REST API Sample finden Sie verschiedene Beispiele für die Arbeit mit Cognitive Services mithilfe von REST.

Weitere Informationen

• Eine Übersicht über den Dienst finden Sie unter Was ist QnA Maker?
• Informationen zum Erstellen einer Azure Cognitive Service-Ressource finden Sie unter Erste Schritte mit Azure Cognitive Service.
• Informationen zum Zugriff auf REST-Spezifikationen für frühere Versionen der QnA Maker-API finden Sie in diesem GitHub-Repository.