Aanvragen voor tekstclassificatie verzenden naar uw model

Nadat u een model hebt geïmplementeerd, kunt u een query uitvoeren op de implementatie om tekst te classificeren op basis van het model dat u aan de implementatie hebt toegewezen. U kunt via een programma een query uitvoeren op de implementatie-API of via de clientbibliotheken (Azure SDK).

Geïmplementeerd model testen

U kunt Language Studio gebruiken om de aangepaste taak voor tekstclassificatie in te dienen en de resultaten te visualiseren.

Uw geïmplementeerde modellen testen vanuit Language Studio:

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

2. Selecteer de implementatie die u wilt testen. U kunt alleen modellen testen die zijn toegewezen aan implementaties.

3. Voor meertalige projecten selecteert u in de vervolgkeuzelijst taal de taal van de tekst die u wilt testen.

4. Selecteer de implementatie die u wilt opvragen/testen in de vervolgkeuzelijst.

5. U kunt de tekst invoeren die u wilt indienen bij de aanvraag of een .txt bestand uploaden dat u wilt gebruiken.

6. Selecteer De test uitvoeren in het bovenste menu.

7. Op het tabblad Resultaat ziet u de geëxtraheerde entiteiten uit uw tekst en de bijbehorende typen. U kunt het JSON-antwoord ook bekijken op het tabblad JSON .

Een aanvraag voor tekstclassificatie verzenden naar uw model

Tip

U kunt uw model testen in Language Studio door voorbeeldtekst te verzenden om het te classificeren.

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, onder de draaitabel Verzenden , de URL en hoofdtekst van de voorbeeldaanvraag. Vervang de waarden van de tijdelijke aanduidingen, zoals YOUR_DOCUMENT_HERE en YOUR_DOCUMENT_LANGUAGE_HERE door de werkelijke tekst en taal die u wilt verwerken.

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.

4. In de antwoordheader krijgt u extract {JOB-ID} van operation-location, die de indeling heeft: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Terug naar Language Studio; selecteer Draaitabel ophalen uit hetzelfde venster als u de voorbeeldaanvraag hebt ontvangen die u eerder hebt ontvangen en kopieer de voorbeeldaanvraag naar een teksteditor.

6. Voeg uw taak-id toe na /jobs/ de URL met behulp van de id die u uit de vorige stap hebt geëxtraheerd.

7. Verzend de cURL-aanvraag in uw GET terminal of opdrachtprompt.

REST API

Eerst moet u uw resourcesleutel en eindpunt ophalen:

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

2. Selecteer sleutels en eindpunt in het menu aan de linkerkant. U gebruikt het eindpunt en de sleutel voor de API-aanvragen

   

Een aangepaste tekstclassificatietaak verzenden

Gebruik deze POST-aanvraag om een tekstclassificatietaak te starten.

{ENDPOINT}/language/analyze-text/jobs?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. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.	2022-05-01

Kopteksten

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	Uw sleutel die toegang biedt tot deze API.

Hoofdtekst

Classificatie met meerdere labels

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomMultiLabelClassification",
      "taskName": "Multi Label Classification",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
displayName	{JOB-NAME}	Uw taaknaam.	MyJobName
documents	[{},{}]	Lijst met documenten waarop taken moeten worden uitgevoerd.	[{},{}]
id	{DOC-ID}	Documentnaam of id.	doc1
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode voor het document opgeeft. Als deze sleutel niet is opgegeven, wordt door de service uitgegaan van de standaardtaal van het project dat is geselecteerd tijdens het maken van het project. Zie taalondersteuning voor een lijst met ondersteunde taalcodes.	en-us
text	{DOC-TEXT}	Documenteer de taak waarop de taken moeten worden uitgevoerd.	Lorem ipsum dolor sit amet
tasks		Lijst met taken die we willen uitvoeren.	[]
taskName	CustomMultiLabelClassification	De taaknaam	CustomMultiLabelClassification
parameters		Lijst met parameters die aan de taak moeten worden doorgegeven.
project-name	{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
deployment-name	{DEPLOYMENT-NAME}	De naam van uw implementatie. Deze waarde is hoofdlettergevoelig.	prod

Classificatie van één label

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
    {
      "kind": "CustomSingleLabelClassification",
      "taskName": "Single Classification Label",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
displayName	{JOB-NAME}	Uw taaknaam.	MyJobName
documents		Lijst met documenten waarop taken moeten worden uitgevoerd.
id	{DOC-ID}	Documentnaam of id.	doc1
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode voor het document opgeeft. Als deze sleutel niet is opgegeven, wordt door de service uitgegaan van de standaardtaal van het project dat is geselecteerd tijdens het maken van het project. Zie taalondersteuning voor een lijst met ondersteunde taalcodes.	en-us
text	{DOC-TEXT}	Documenteer de taak waarop de taken moeten worden uitgevoerd.	Lorem ipsum dolor sit amet
taskName	CustomSingleLabelClassification	De taaknaam	CustomSingleLabelClassification
tasks	[]	Matrix met taken die we willen uitvoeren.	[]
parameters		Lijst met parameters die aan de taak moeten worden doorgegeven.
project-name	{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
deployment-name	{DEPLOYMENT-NAME}	De naam van uw implementatie. Deze waarde is hoofdlettergevoelig.	prod

Respons

U ontvangt een 202-antwoord dat aangeeft dat het is gelukt. Pak in de antwoordheaders het uitoperation-location. operation-location is als volgt opgemaakt:

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

U kunt deze URL gebruiken om de voltooiingsstatus van de taak op te vragen en de resultaten op te halen wanneer de taak is voltooid.

Taakresultaten ophalen

Gebruik de volgende GET-aanvraag om de status/resultaten van de tekstclassificatietaak op te vragen.

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?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. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie van de modelversie .	2022-05-01

Kopteksten

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	Uw sleutel die toegang biedt tot deze API.

Hoofdtekst van de reactie

Het antwoord is een JSON-document met de volgende parameters.

Classificatie met meerdere labels

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customMultiClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "classes": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Classificatie van één label

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customSingleClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "class": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

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 de API-aanvragen

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

   Taal	Versie van het pakket
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

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

   Classificatie van één label:

   • C#
   • Java
   • JavaScript
   • Python

   Classificatie met meerdere labels:

   • C#
   • Java
   • JavaScript
   • Python

5. Zie de volgende referentiedocumentatie voor meer informatie over de client en het retourobject:

   • C#
   • Java
   • JavaScript
   • Python

Volgende stappen

• Overzicht van aangepaste tekstclassificatie