Voorspellingsaanvragen verzenden naar een implementatie

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 programmatisch een query uitvoeren op de implementatie via de 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 geïmplementeerde modellen testen vanuit Language Studio:

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

2. Voor meertalige projecten selecteert u in de vervolgkeuzelijst Teksttaal selecteren de taal van de uiting die u wilt testen.

3. Selecteer in de vervolgkeuzelijst Implementatienaam de implementatienaam die overeenkomt met het model dat u wilt testen. U kunt alleen modellen testen die zijn toegewezen aan implementaties.

4. Voer in het tekstvak een uiting in die u wilt testen. Als u bijvoorbeeld een toepassing hebt gemaakt voor e-mailgerelateerde utterances, kunt u deze e-mail verwijderen invoeren.

5. Selecteer de test uitvoeren naar de bovenkant van de pagina.

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 van entiteitenkaarten of in JSON-indeling.

---

Een gespreksaanvraag voor taalverstaan 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.

3. Vervang door <YOUR_QUERY_HERE> de werkelijke tekst die u wilt verzenden om intenties en entiteiten op te halen.

4. 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 de 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 model voor het begrijpen van conversationele taal.

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": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Sleutel	Tijdelijke aanduiding	Waarde	Voorbeeld
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	De uiting waaruit u de intentie wilt voorspellen en entiteiten wilt extraheren.	"Read Matt's email
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	myProject
deploymentName	{DEPLOYMENT-NAME}	De naam van uw implementatie. Deze waarde is hoofdlettergevoelig.	staging

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

Hoofdtekst van de reactie

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Sleutel	Voorbeeldwaarde	Beschrijving
query	"E-mail van Matt lezen"	de tekst die u hebt ingediend voor de query.
topIntent	"Lezen"	De voorspelde intentie met de hoogste betrouwbaarheidsscore.
intents	[]	Een lijst met alle intenties die zijn voorspeld voor de querytekst, elk met een betrouwbaarheidsscore.
entiteiten	[]	matrix met een lijst met geëxtraheerde entiteiten uit de querytekst.

API-antwoord voor een gespreksproject

In een gespreksproject krijgt u voorspellingen voor zowel uw intenties als entiteiten die aanwezig zijn in uw project.

• De intenties en entiteiten bevatten een betrouwbaarheidsscore tussen 0,0 en 1,0, gekoppeld aan hoe zeker het model is over het voorspellen van een bepaald element in uw project.
• De intentie met de hoogste score is opgenomen in een eigen parameter.
• Alleen voorspelde entiteiten worden weergegeven in uw antwoord.
• Entiteiten geven aan:
  • De tekst van de entiteit die is geëxtraheerd
  • De beginlocatie wordt aangeduid met een offsetwaarde
  • De lengte van de entiteitstekst die wordt aangeduid met een lengtewaarde.

Clientbibliotheken (Azure SDK)

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 conversatietaal begrijpen