Odeslání požadavků na klasifikaci textu do modelu

Po úspěšném nasazení modelu můžete do nasazení zadat dotaz, aby klasifikovala text na základě modelu, který jste přiřadili k nasazení. Rozhraní API pro predikce nasazení můžete dotazovat prostřednictvím kódu programu nebo prostřednictvím klientských knihoven (Azure SDK).

Test nasazený model

Pomocí nástroje Language Studio můžete odeslat vlastní úlohu klasifikace textu a vizualizovat výsledky.

Testování nasazených modelů v sadě Language Studio:

1. V nabídce na levé straně vyberte Testovací nasazení .

2. Vyberte nasazení, které chcete otestovat. Můžete testovat jenom modely, které jsou přiřazené k nasazením.

3. V případě vícejazyčných projektů v rozevíracím seznamu jazyka vyberte jazyk textu, který testujete.

4. V rozevíracím seznamu vyberte nasazení, které chcete dotazovat nebo testovat.

5. Můžete zadat text, který chcete odeslat do žádosti, nebo nahrát .txt soubor, který chcete použít.

6. V horní nabídce vyberte Spustit test .

7. Na kartě Výsledek můžete zobrazit extrahované entity z textu a jejich typů. Odpověď JSON můžete zobrazit také na kartě JSON .

Odeslání požadavku na klasifikaci textu do modelu

Tip

Model můžete otestovat v sadě Language Studio odesláním ukázkového textu, který ho klasifikuje.

Language Studio

1. Po úspěšném dokončení úlohy nasazení vyberte nasazení, které chcete použít, a v horní nabídce vyberte Získat adresu URL předpovědi.

   

2. V zobrazeném okně v části Odeslat pivot zkopírujte adresu URL a text ukázkové žádosti. Nahraďte zástupné hodnoty, například YOUR_DOCUMENT_HERE a YOUR_DOCUMENT_LANGUAGE_HERE skutečným textem a jazykem, který chcete zpracovat.

3. POST Odešlete požadavek cURL v terminálu nebo příkazovém řádku. Pokud byl požadavek úspěšný, obdržíte odpověď 202 s výsledky rozhraní API.

4. V hlavičce odpovědi obdržíte extrakci {JOB-ID} z operation-location, která má formát: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Zpět do jazykového studia; Vyberte Možnost Načíst pivot ze stejného okna, které jste získali dříve, a zkopírujte ukázkový požadavek do textového editoru.

6. Id úlohy přidejte za /jobs/ adresu URL s použitím ID, které jste extrahovali z předchozího kroku.

7. GET Odešlete požadavek cURL v terminálu nebo příkazovém řádku.

REST API

Nejprve potřebujete získat klíč prostředku a koncový bod:

1. Na webu Azure Portal přejděte na stránku přehledu prostředků.

2. V nabídce na levé straně vyberte Klíče a koncový bod. Pro požadavky rozhraní API použijete koncový bod a klíč.

   

Odeslání vlastního úkolu klasifikace textu

Pomocí tohoto požadavku POST spusťte úlohu klasifikace textu.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Verze rozhraní API, které voláte. Hodnota, na kterou se zde odkazuje, je určená pro nejnovější vydané verze. Další informace o dalších dostupných verzích rozhraní API najdete v tématu Životní cyklus modelu.	2022-05-01

Hlavičky

Key	Hodnota
Ocp-Apim-Subscription-Key	Váš klíč, který poskytuje přístup k tomuto rozhraní API.

Text

Klasifikace více popisků

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

Klíč	Zástupný symbol	Hodnota	Příklad
displayName	{JOB-NAME}	Název vaší práce.	MyJobName
documents	[{},{}]	Seznam dokumentů, na kterých se mají spouštět úkoly	[{},{}]
id	{DOC-ID}	Název nebo ID dokumentu	doc1
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka dokumentu. Pokud tento klíč není zadaný, služba bude předpokládat výchozí jazyk projektu, který byl vybrán během vytváření projektu. Seznam podporovaných jazykových kódů najdete v podpoře jazyků.	en-us
text	{DOC-TEXT}	Úlohu dokumentu, ve které chcete úkoly spouštět.	Lorem ipsum dolor sit amet
tasks		Seznam úkolů, které chceme provést	[]
taskName	CustomMultiLabelClassification	Název úkolu	CustomMultiLabelClassification
parameters		Seznam parametrů, které se mají předat úkolu
project-name	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
deployment-name	{DEPLOYMENT-NAME}	Název nasazení. U této hodnoty se rozlišují malá a velká písmena.	prod

Klasifikace s jedním popiskem

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

Klíč	Zástupný symbol	Hodnota	Příklad
displayName	{JOB-NAME}	Název vaší práce.	MyJobName
documents		Seznam dokumentů, na kterých se mají spouštět úkoly
id	{DOC-ID}	Název nebo ID dokumentu	doc1
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka dokumentu. Pokud tento klíč není zadaný, služba bude předpokládat výchozí jazyk projektu, který byl vybrán během vytváření projektu. Seznam podporovaných jazykových kódů najdete v podpoře jazyků.	en-us
text	{DOC-TEXT}	Úlohu dokumentu, ve které chcete úkoly spouštět.	Lorem ipsum dolor sit amet
taskName	CustomSingleLabelClassification	Název úkolu	CustomSingleLabelClassification
tasks	[]	Pole úkolů, které chceme provést.	[]
parameters		Seznam parametrů, které se mají předat úkolu
project-name	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
deployment-name	{DEPLOYMENT-NAME}	Název nasazení. U této hodnoty se rozlišují malá a velká písmena.	prod

Response

Zobrazí se odpověď 202 označující úspěch. V hlavičce odpovědi extrahujte operation-location. operation-location je formátovaný takto:

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

Tuto adresu URL můžete použít k dotazování stavu dokončení úkolu a získání výsledků po dokončení úkolu.

Získání výsledků úkolů

Pomocí následujícího požadavku GET zadejte dotaz na stav nebo výsledky úlohy klasifikace textu.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Verze rozhraní API, které voláte. Hodnota, na kterou odkazujeme, je určená pro nejnovější verzi vydané verze modelu.	2022-05-01

Hlavičky

Key	Hodnota
Ocp-Apim-Subscription-Key	Váš klíč, který poskytuje přístup k tomuto rozhraní API.

Text odpovědi

Odpověď bude dokument JSON s následujícími parametry.

Klasifikace více popisků

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

Klasifikace s jedním popiskem

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

Klientské knihovny (Azure SDK)

Nejprve budete muset získat klíč prostředku a koncový bod:

• Na webu Azure Portal přejděte na stránku přehledu prostředků.

• V nabídce na levé straně vyberte Klíče a koncový bod. Pro požadavky rozhraní API použijete koncový bod a klíč.

3. Stáhněte a nainstalujte balíček klientské knihovny pro jazyk podle vašeho výběru:

   Jazyk	Verze balíčku
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

4. Po instalaci klientské knihovny pomocí následujících ukázek na GitHubu začněte volat rozhraní API.

   Klasifikace s jedním popiskem:

   • C#
   • Java
   • JavaScript
   • Python

   Klasifikace více popisků:

   • C#
   • Java
   • JavaScript
   • Python

5. Další informace o klientovi a návratovém objektu najdete v následující referenční dokumentaci:

   • C#
   • Java
   • JavaScript
   • Python

Další kroky

• Přehled vlastní klasifikace textu