Query-implementatie voor intentievoorspellingen

Nadat de implementatie is toegevoegd, kunt u een query uitvoeren op de implementatie voor intentie- en entiteitenvoorspellingen van uw uiting op basis van het model dat u aan de implementatie hebt toegewezen. U kunt een query uitvoeren op de implementatie via een programmatische voorspellings-API of via de clientbibliotheken (Azure SDK).

Geïmplementeerd model testen

U kunt Language Studio gebruiken om een uiting te verzenden, voorspellingen op te halen en de resultaten te visualiseren.

Uw model testen vanuit Language Studio

1. Selecteer Implementaties testen in het menu aan de linkerkant.

2. Selecteer het model dat u wilt testen. U kunt alleen modellen testen die zijn toegewezen aan implementaties.

3. Selecteer uw implementatienaam in de vervolgkeuzelijst implementatienaam.

4. Voer in het tekstvak een uiting in die u wilt testen.

5. Selecteer de test uitvoeren in het bovenste menu.

6. Nadat u de test hebt uitgevoerd, ziet u het antwoord van het model in het resultaat. U kunt de resultaten weergeven in de kaartweergave entiteiten of weergeven in JSON-indeling.

   

---

Een indelingswerkstroomaanvraag verzenden

Language Studio

1. Nadat de implementatietaak is voltooid, selecteert u de implementatie die u wilt gebruiken en selecteert u in het bovenste menu Voorspellings-URL ophalen.

   

2. Kopieer in het venster dat wordt weergegeven de voorbeeldaanvraag-URL en hoofdtekst naar de opdrachtregel. Vervang <YOUR_QUERY_HERE> door de werkelijke tekst waaruit u intenties en entiteiten wilt extraheren.

3. Verzend de cURL-aanvraag in uw POST terminal of opdrachtprompt. U ontvangt een 202-antwoord met de API-resultaten als de aanvraag is geslaagd.

REST-API's

Eerst moet u uw resourcesleutel en eindpunt ophalen:

Ga naar de overzichtspagina van uw resource in Azure Portal. Selecteer sleutels en eindpunt in het menu aan de linkerkant. U gebruikt het eindpunt en de sleutel voor API-aanvragen.

Query's uitvoeren op uw model

Maak een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om een indelingswerkstroommodel te testen.

Aanvraag-URL

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Aanvraagbody

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "text": "Text1",
      "participantId": "1",
      "id": "1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "directTarget": "qnaProject",
    "targetProjectParameters": {
      "qnaProject": {
        "targetProjectKind": "QuestionAnswering",
        "callingOptions": {
          "context": {
            "previousUserQuery": "Meet Surface Pro 4",
            "previousQnaId": 4
          },
          "top": 1,
          "question": "App Service overview"
        }
      }
    }
  }
}

Hoofdtekst van antwoord

Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord voor de voorspelling.

{
  "kind": "ConversationResult",
  "result": {
    "query": "App Service overview",
    "prediction": {
      "projectKind": "Orchestration",
      "topIntent": "qnaTargetApp",
      "intents": {
        "qnaTargetApp": {
          "targetProjectKind": "QuestionAnswering",
          "confidenceScore": 1,
          "result": {
            "answers": [
              {
                "questions": [
                  "App Service overview"
                ],
                "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.",
                "confidenceScore": 0.7384000000000001,
                "id": 1,
                "source": "https://learn.microsoft.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Clientbibliotheken (Azure SDK)

Eerst moet u uw resourcesleutel en eindpunt ophalen:

Ga naar de overzichtspagina van uw resource in Azure Portal. Selecteer sleutels en eindpunt in het menu aan de linkerkant. U gebruikt het eindpunt en de sleutel voor API-aanvragen.

De clientbibliotheken (Azure SDK) gebruiken

U kunt ook de clientbibliotheken van de Azure SDK gebruiken om aanvragen naar uw model te verzenden.

Notitie

De clientbibliotheek voor het begrijpen van gesprekstalen is alleen beschikbaar voor:

• .NET
• Python

1. Ga naar de overzichtspagina van uw resource in Azure Portal

2. Selecteer sleutels en eindpunt in het menu aan de linkerkant. Gebruik het eindpunt voor de API-aanvragen en u hebt de sleutel voor Ocp-Apim-Subscription-Key de header nodig.

   

3. Download en installeer het clientbibliotheekpakket voor uw gewenste taal:

   Taal	Versie van het pakket
   .NET	1.0.0
   Python	1.0.0

4. Nadat u de clientbibliotheek hebt geïnstalleerd, gebruikt u de volgende voorbeelden op GitHub om de API aan te roepen.

   • C#
   • Python

5. Raadpleeg de volgende referentiedocumentatie voor meer informatie:

   • C#
   • Python

Volgende stappen

• Overzicht van indelingswerkstroom