Query's uitvoeren op uw aangepaste model

Nadat de implementatie is toegevoegd, kunt u een query uitvoeren op de implementatie om entiteiten uit uw tekst te extraheren op basis van het model dat u aan de implementatie hebt toegewezen. U kunt de implementatie programmatisch opvragen met behulp van de voorspellings-API of via de clientbibliotheken (Azure SDK).

Geïmplementeerd model testen

U kunt Language Studio gebruiken om de aangepaste entiteitsherkenningstaak te verzenden 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 entiteitsherkenning verzenden naar uw model

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 NER-taak 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

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "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	CustomEntityRecognition	De taaknaam	CustomEntityRecognition
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 uw taak is verzonden. 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 aangepaste entiteitsherkenningstaak 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 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 van antwoord

Het antwoord is een JSON-document met de volgende parameters

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Clientbibliotheken (Azure SDK)

Eerst moet u uw resourcesleutel en eindpunt ophalen:

Uw sleutel en eindpunt ophalen

Vervolgens hebt u de sleutel en het eindpunt van de resource nodig om uw toepassing te verbinden met de API. Verderop in de quickstart plakt u uw sleutel en eindpunt in de code.

1. Nadat de taalresource is geïmplementeerd, klikt u onder Volgende stappen op de knop Naar de resource gaan.

   

2. Selecteer sleutels en eindpunt in het linkernavigatiemenu op het scherm voor uw resource. U gebruikt een van uw sleutels en uw eindpunt in de onderstaande stappen.

   

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.

   • C#
   • Java
   • JavaScript
   • Python

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

   • C#
   • Java
   • JavaScript
   • Python

Volgende stappen

• Veelgestelde vragen