Query-implementatie voor intentievoorspellingen

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

Geïmplementeerd model testen

U kunt Language Studio gebruiken om een utterance in te dienen, 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 in de vervolgkeuzelijst implementatienaam de naam van uw implementatie.

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

5. Selecteer in het bovenste menu de optie De test uitvoeren.

6. Nadat u de test hebt uitgevoerd, ziet u het antwoord van het model in het resultaat. U kunt de resultaten bekijken in de weergave entiteitskaarten of in JSON-indeling.

   

---

Een aanvraag voor indelingswerkstroom 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 URL en hoofdtekst van de voorbeeldaanvraag naar de opdrachtregel. Vervang door <YOUR_QUERY_HERE> de werkelijke tekst die u wilt verzenden om intenties en entiteiten op te halen.

3. Verzend de POST cURL-aanvraag in uw 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 de 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 te beginnen met het testen van een indelingswerkstroommodel.

Aanvraag-URL

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

Tijdelijke aanduiding	Waarde	Voorbeeld
{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	Waarde
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

Nadat 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 de 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 gesprekstaal is alleen beschikbaar voor:

• .NET
• Python

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

2. Selecteer sleutels en eindpunt in het menu aan de linkerkant. Gebruik 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 de 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. Zie de volgende referentiedocumentatie voor meer informatie:

   • C#
   • Python

Volgende stappen

• Overzicht van indelingswerkstroom