När du har distribuerat en modell kan du fråga distributionen för att klassificera text baserat på den modell som du tilldelade distributionen.
Du kan köra frågor mot distributionen programmatiskt förutsägelse-API:et eller via klientbiblioteken (Azure SDK).
Testa distribuerad modell
Du kan använda Language Studio för att skicka den anpassade textklassificeringsuppgiften och visualisera resultatet.
Så här testar du dina distribuerade modeller från Language Studio:
Välj Testa distributioner på menyn till vänster.
Välj den distribution som du vill testa. Du kan bara testa modeller som har tilldelats distributioner.
För flerspråkiga projekt går du till listrutan språk och väljer språket för den text som du testar.
Välj den distribution som du vill köra frågor mot/testa i listrutan.
Du kan ange den text som du vill skicka till begäran eller ladda upp en .txt fil som ska användas.
Välj Kör testet på den översta menyn.
På fliken Resultat kan du se de extraherade entiteterna från din text och deras typer. Du kan också visa JSON-svaret under fliken JSON .
Skicka en textklassificeringsbegäran till din modell
När distributionsjobbet har slutförts väljer du den distribution som du vill använda och på den översta menyn väljer du Hämta förutsägelse-URL.
I fönstret som visas under pivoten Skicka kopierar du exempelbegärans URL och brödtext. Ersätt platshållarvärdena, till exempel YOUR_DOCUMENT_HERE och YOUR_DOCUMENT_LANGUAGE_HERE med den faktiska text och det språk som du vill bearbeta.
POST Skicka cURL-begäran i terminalen eller kommandotolken. Du får ett 202-svar med API-resultatet om begäran lyckades.
I svarshuvudet får du extrahering {JOB-ID} från operation-location, som har formatet: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>
Tillbaka till Language Studio; välj Hämta pivot från samma fönster som du fick exempelbegäran du fick tidigare och kopiera exempelbegäran till en textredigerare.
Lägg till ditt jobb-ID efter /jobs/ i URL:en med hjälp av det ID som du extraherade från föregående steg.
GET Skicka cURL-begäran i terminalen eller kommandotolken.
Först måste du hämta resursnyckeln och slutpunkten:
Gå till resursöversiktssidan i Azure Portal
På menyn till vänster väljer du Nycklar och Slutpunkt. Du använder slutpunkten och nyckeln för API-begäranden
Skicka en anpassad textklassificeringsuppgift
Använd den här POST-begäran för att starta en textklassificeringsuppgift.
{ENDPOINT}/language/analyze-text/jobs?api-version={API-VERSION}
| Tangent |
Värde |
| Ocp-Apim-Subscription-Key |
Din nyckel som ger åtkomst till det här API:et. |
Brödtext
{
"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}"
}
}
]
}
| Nyckel |
Platshållare |
Värde |
Exempel |
displayName |
{JOB-NAME} |
Ditt jobbnamn. |
MyJobName |
documents |
[{},{}] |
Lista över dokument som aktiviteter ska köras på. |
[{},{}] |
id |
{DOC-ID} |
Dokumentnamn eller ID. |
doc1 |
language |
{LANGUAGE-CODE} |
En sträng som anger språkkoden för dokumentet. Om den här nyckeln inte anges förutsätter tjänsten standardspråket för projektet som valdes när projektet skapades. Se språkstöd för en lista över språkkoder som stöds. |
en-us |
text |
{DOC-TEXT} |
Dokumentuppgift som aktiviteterna ska köras på. |
Lorem ipsum dolor sit amet |
tasks |
|
Lista över uppgifter som vi vill utföra. |
[] |
taskName |
CustomMultiLabelClassification |
Uppgiftsnamnet |
CustomMultiLabelClassification |
parameters |
|
Lista över parametrar som ska skickas till uppgiften. |
|
project-name |
{PROJECT-NAME} |
Namnet på projektet. Det här värdet är skiftlägeskänsligt. |
myProject |
deployment-name |
{DEPLOYMENT-NAME} |
Namnet på distributionen. Det här värdet är skiftlägeskänsligt. |
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}"
}
}
]
}
| Nyckel |
Platshållare |
Värde |
Exempel |
| displayName |
{JOB-NAME} |
Ditt jobbnamn. |
MyJobName |
| documents |
|
Lista över dokument som aktiviteter ska köras på. |
|
id |
{DOC-ID} |
Dokumentnamn eller ID. |
doc1 |
language |
{LANGUAGE-CODE} |
En sträng som anger språkkoden för dokumentet. Om den här nyckeln inte anges förutsätter tjänsten standardspråket för projektet som valdes när projektet skapades. Se språkstöd för en lista över språkkoder som stöds. |
en-us |
text |
{DOC-TEXT} |
Dokumentuppgift som aktiviteterna ska köras på. |
Lorem ipsum dolor sit amet |
taskName |
CustomSingleLabelClassification |
Uppgiftsnamnet |
CustomSingleLabelClassification |
tasks |
[] |
Matris med uppgifter som vi vill utföra. |
[] |
parameters |
|
Lista över parametrar som ska skickas till uppgiften. |
|
project-name |
{PROJECT-NAME} |
Namnet på projektet. Det här värdet är skiftlägeskänsligt. |
myProject |
deployment-name |
{DEPLOYMENT-NAME} |
Namnet på distributionen. Det här värdet är skiftlägeskänsligt. |
prod |
Response
Du får ett 202-svar som anger att det har lyckats. I svarshuvudena extraherar du operation-location.
operation-location är formaterad så här:
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
Du kan använda den här URL:en för att fråga efter uppgiftens slutförandestatus och få resultatet när aktiviteten har slutförts.
Hämta aktivitetsresultat
Använd följande GET-begäran för att fråga efter status/resultat för textklassificeringsaktiviteten.
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
| Platshållare |
Värde |
Exempel |
{ENDPOINT} |
Slutpunkten för att autentisera din API-begäran. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API-VERSION} |
Den version av API:et som du anropar. Värdet som refereras här är för den senaste versionen av modellen . |
2022-05-01 |
| Tangent |
Värde |
| Ocp-Apim-Subscription-Key |
Din nyckel som ger åtkomst till det här API:et. |
Själva svaret
Svaret är ett JSON-dokument med följande parametrar.
{
"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"
}
}
]
}
}
Först måste du hämta resursnyckeln och slutpunkten:
Ladda ned och installera klientbibliotekspaketet för valfritt språk:
När du har installerat klientbiblioteket använder du följande exempel på GitHub för att börja anropa API:et.
Klassificering med en etikett:
Klassificering med flera etiketter:
Mer information om klienten och returobjekt finns i följande referensdokumentation:
Nästa steg
