Wykonywanie zapytań względem modelu niestandardowego

Po pomyślnym dodaniu wdrożenia możesz wykonać zapytanie dotyczące wdrożenia, aby wyodrębnić jednostki z tekstu na podstawie modelu przypisanego do wdrożenia. Możesz wykonywać zapytania dotyczące wdrożenia programowo przy użyciu interfejsu API przewidywania lub bibliotek klienckich (Azure SDK).

Test wdrożony model

Program Language Studio umożliwia przesyłanie niestandardowego zadania rozpoznawania jednostek i wizualizowanie wyników.

Aby przetestować wdrożone modele z poziomu programu Language Studio:

1. Wybierz pozycję Testowanie wdrożeń z menu po lewej stronie.

2. Wybierz wdrożenie, które chcesz przetestować. Można testować tylko modele przypisane do wdrożeń.

3. W przypadku projektów wielojęzycznych z listy rozwijanej języka wybierz język testowego tekstu.

4. Wybierz wdrożenie, które chcesz wykonać zapytanie/testowanie z listy rozwijanej.

5. Możesz wprowadzić tekst, który chcesz przesłać do żądania lub przekazać .txt plik do użycia.

6. Wybierz pozycję Uruchom test z górnego menu.

7. Na karcie Wynik można zobaczyć wyodrębnione jednostki z tekstu i ich typów. Odpowiedź JSON można również wyświetlić na karcie JSON .

Wysyłanie żądania rozpoznawania jednostek do modelu

Language Studio

1. Po pomyślnym zakończeniu zadania wdrożenia wybierz wdrożenie, którego chcesz użyć, a następnie z górnego menu wybierz pozycję Pobierz adres URL przewidywania.

   

2. W wyświetlonym oknie w obszarze przestawnym Prześlij skopiuj przykładowy adres URL żądania i treść. Zastąp wartości symboli zastępczych, takie jak YOUR_DOCUMENT_HERE i YOUR_DOCUMENT_LANGUAGE_HERE , rzeczywistym tekstem i językiem, który chcesz przetworzyć.

3. POST Prześlij żądanie cURL w terminalu lub wierszu polecenia. Jeśli żądanie zakończyło się pomyślnie, otrzymasz odpowiedź 202 z wynikami interfejsu API.

4. W nagłówku odpowiedzi otrzymasz wyodrębnienie {JOB-ID} z operation-locationelementu , który ma format: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Powrót do programu Language Studio; wybierz pozycję Pobierz element przestawny z tego samego okna, w którym otrzymano przykładowe żądanie, i skopiuj przykładowe żądanie do edytora tekstów.

6. Dodaj identyfikator zadania po /jobs/ do adresu URL przy użyciu identyfikatora wyodrębnionego z poprzedniego kroku.

7. GET Prześlij żądanie cURL w terminalu lub wierszu polecenia.

Interfejs API REST

Najpierw musisz uzyskać klucz zasobu i punkt końcowy:

1. Przejdź do strony przeglądu zasobu w witrynie Azure Portal

2. Z menu po lewej stronie wybierz pozycję Klucze i punkt końcowy. Użyjesz punktu końcowego i klucza dla żądań interfejsu API

   

Przesyłanie niestandardowego zadania NER

Użyj tego żądania POST , aby uruchomić zadanie klasyfikacji tekstu.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz, który zapewnia dostęp do tego interfejsu API.

Treść

{
  "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}"
      }
    }
  ]
}

Klucz	Symbol zastępczy	Wartość	Przykład
displayName	{JOB-NAME}	Nazwa zadania.	MyJobName
documents	[{},{}]	Lista dokumentów do uruchamiania zadań podrzędnych.	[{},{}]
id	{DOC-ID}	Nazwa lub identyfikator dokumentu.	doc1
language	{LANGUAGE-CODE}	Ciąg określający kod języka dokumentu. Jeśli ten klucz nie zostanie określony, usługa przyjmie domyślny język projektu wybranego podczas tworzenia projektu. Aby uzyskać listę obsługiwanych kodów języków, zobacz Obsługa języków.	en-us
text	{DOC-TEXT}	Dokumentowanie zadania podrzędnego do uruchamiania zadań podrzędnych.	Lorem ipsum dolor sit amet
tasks		Lista zadań, które chcemy wykonać.	[]
taskName	CustomEntityRecognition	Nazwa zadania	CustomEntityRecognition
parameters		Lista parametrów do przekazania do zadania.
project-name	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nazwa wdrożenia. Ta wartość jest uwzględniana w wielkości liter.	prod

Response

Otrzymasz odpowiedź z 202 r. wskazującą, że zadanie zostało pomyślnie przesłane. W nagłówkach odpowiedzi wyodrębnij element operation-location. operation-location jest sformatowany w następujący sposób:

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

Możesz użyć tego adresu URL, aby wykonać zapytanie dotyczące stanu ukończenia zadania i uzyskać wyniki po zakończeniu zadania.

Pobieranie wyników zadania

Użyj następującego żądania GET , aby wykonać zapytanie dotyczące stanu/wyników zadania niestandardowego rozpoznawania jednostek.

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

Symbol zastępczy	Wartość	Przykład
{ENDPOINT}	Punkt końcowy do uwierzytelniania żądania interfejsu API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API.	2022-05-01

Nagłówki

Key	Wartość
Ocp-Apim-Subscription-Key	Klucz, który zapewnia dostęp do tego interfejsu API.

Treść odpowiedzi

Odpowiedź będzie dokumentem JSON z następującymi parametrami

{
  "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"
        }
      }
    ]
  }
}

Biblioteki klienta (zestaw Azure SDK)

Najpierw musisz uzyskać klucz zasobu i punkt końcowy:

Uzyskiwanie klucza i punktu końcowego

Następnie będziesz potrzebować klucza i punktu końcowego z zasobu, aby połączyć aplikację z interfejsem API. W dalszej części przewodnika Szybki start wklejesz klucz i punkt końcowy do kodu.

1. Po pomyślnym wdrożeniu zasobu Language kliknij przycisk Przejdź do zasobu w obszarze Następne kroki.

   

2. Na ekranie zasobu wybierz pozycję Klucze i punkt końcowy w menu nawigacji po lewej stronie. Użyjesz jednego z kluczy i punktu końcowego w poniższych krokach.

   

3. Pobierz i zainstaluj pakiet biblioteki klienta dla wybranego języka:

   Język	Wersja pakietu
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

4. Po zainstalowaniu biblioteki klienta użyj poniższych przykładów w usłudze GitHub, aby rozpocząć wywoływanie interfejsu API.

   • C#
   • Java
   • JavaScript
   • Python

5. Zobacz następującą dokumentację referencyjną, aby uzyskać więcej informacji na temat klienta i zwracać obiekt:

   • C#
   • Java
   • JavaScript
   • Python

Następne kroki

• Często zadawane pytania