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

Článek
10/16/2024

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:

V nabídce na levé straně vyberte Testovací nasazení .
Vyberte nasazení, které chcete otestovat. Můžete testovat jenom modely, které jsou přiřazené k nasazením.
V případě vícejazyčných projektů v rozevíracím seznamu jazyka vyberte jazyk textu, který testujete.
V rozevíracím seznamu vyberte nasazení, které chcete dotazovat nebo testovat.
Můžete zadat text, který chcete odeslat do žádosti, nebo nahrát .txt soubor, který chcete použít.
V horní nabídce vyberte Spustit test .
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.

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.
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.
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.
V hlavičce odpovědi obdržíte extrakci {JOB-ID} z operation-location, která má formát: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>
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.
Id úlohy přidejte za /jobs/ adresu URL s použitím ID, které jste extrahovali z předchozího kroku.
GET Odešlete požadavek cURL v terminálu nebo příkazovém řádku.

Nejprve potřebujete 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íč.

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.

{
  "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`

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

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

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íč.

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
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
Další informace o klientovi a návratovém objektu najdete v následující referenční dokumentaci:
- C#
- Java
- JavaScript
- Python

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

Další kroky

Přehled vlastní klasifikace textu

Sdílet prostřednictvím

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

Test nasazený model

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

Odeslání vlastního úkolu klasifikace textu

Hlavičky

Text

Response

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

Hlavičky

Text odpovědi

Další kroky

Váš názor

Další materiály