Zadaj zapytanie do swojego 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).

Testowanie wdrożonego modelu

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 zapytać/przetestować z menu rozwijanego.

5. Możesz wpisać tekst, który chcesz przesłać na żądanie, lub załadować plik .txt 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 typy. 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óre chcesz użyć, a następnie z menu u góry wybierz Pobierz URL prognozy.

   

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 otrzymujesz wyciągnięcie {JOB-ID} z operation-location, 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, z którego uzyskano przykładowe żądanie, i skopiuj przykładowe żądanie do edytora tekstu.

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 do żądań API

   

Złóż niestandardowe zadanie 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

Klucz	Wartość
Ocp-Apim-Subscription-Key	Klucz zapewniający 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ń.	[{},{}]
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}	Dokumentuj zadanie do uruchamiania zadań.	Lorem ipsum dolor sit amet
tasks		Lista zadań, które chcemy wykonać.	[]
taskName	CustomEntityRecognition	Nazwa zadania	CustomEntityRecognition
parameters		Lista parametrów, które należy przekazać do zadania.
project-name	{PROJECT-NAME}	Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nazwa Twojego wdrożenia. Wartość ta jest czuła na wielkość liter.	prod

Odpowiedź

Otrzymasz odpowiedź 202 informują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

Klucz	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:

Pobierz swój klucz i punkt końcowy

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 swojego punktu końcowego w krokach poniżej.

   

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 dokumentację referencyjną, aby uzyskać więcej informacji na temat klienta i obiektu zwrotnego.

   • C#
   • Java
   • JavaScript
   • Python

Następne kroki

• Często zadawane pytania