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 NER
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 |
| Key |
Hodnota |
| Ocp-Apim-Subscription-Key |
Váš klíč, který poskytuje přístup k tomuto rozhraní API. |
Text
{
"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}"
}
}
]
}
| 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 |
CustomEntityRecognition |
Název úkolu |
CustomEntityRecognition |
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í, že váš úkol byl úspěšně odeslán. 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 rozpoznávání vlastních entit.
{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 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 |
| 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.
{
"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"
}
}
]
}
}
