Wysyłanie żądań klasyfikacji tekstu do modelu

Po pomyślnym wdrożeniu modelu możesz wykonać zapytanie dotyczące wdrożenia, aby sklasyfikować tekst na podstawie modelu przypisanego do wdrożenia. Możesz wykonywać zapytania dotyczące interfejsu API przewidywania programowego wdrożenia lub za pomocą bibliotek klienckich (Azure SDK).

Test wdrożony model

Program Language Studio umożliwia przesyłanie niestandardowego zadania klasyfikacji tekstu 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 klasyfikacji tekstu do modelu

Napiwek

Model można przetestować w programie Language Studio , wysyłając przykładowy tekst, aby go sklasyfikować.

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 klasyfikacji tekstu

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ść

Klasyfikacja wielu etykiet

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

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	CustomMultiLabelClassification	Nazwa zadania	CustomMultiLabelClassification
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

Klasyfikacja pojedynczej etykiety

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

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
taskName	CustomSingleLabelClassification	Nazwa zadania	CustomSingleLabelClassification
tasks	[]	Tablica zadań, które chcemy wykonać.	[]
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ą powodzenie. 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 klasyfikacji tekstu.

{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ścią, do których odwołuje się tutaj, jest najnowsza wydana wersja modelu.	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.

Klasyfikacja wielu etykiet

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

Klasyfikacja pojedynczej etykiety

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

Biblioteki klienta (zestaw Azure SDK)

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

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

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

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.

   Klasyfikacja pojedynczej etykiety:

   • C#
   • Java
   • JavaScript
   • Python

   Klasyfikacja wielu etykiet:

   • 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

• Omówienie niestandardowej klasyfikacji tekstu