Create Evaluation - Create Evaluation

Szolgáltatás:: Azure AI Services

API-verzió:: v3.0

Új értékelést hoz létre.

POST {Endpoint}/speechtotext/v3.0/evaluations

URI-paraméterek

Name	In	Kötelező	Típus	Description
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com).

Kérelem törzse

Name	Kötelező	Típus	Description
dataset	True	EntityReference	EntityReference
displayName	True	string	Az objektum megjelenítendő neve.
locale	True	string	A tartalmazott adatok területi beállítása.
model1	True	EntityReference	EntityReference
model2	True	EntityReference	EntityReference
customProperties		object	Az entitás egyéni tulajdonságai. A maximálisan megengedett kulcshossz 64 karakter, az engedélyezett érték maximális hossza 256 karakter, az engedélyezett bejegyzések száma pedig 10.
description		string	Az objektum leírása.
links		Links	Hivatkozások
project		EntityReference	EntityReference
properties		EvaluationProperties	EvaluationProperties
transcription1		EntityReference	EntityReference
transcription2		EntityReference	EntityReference

Válaszok

Name	Típus	Description
201 Created	Evaluation	A válasz hasznos adatként tartalmazza az entitás adatait és fejlécként való helyét. Fejlécek Location: string
Other Status Codes	Error	Hiba történt.

Name

Típus

Description

201 Created

Evaluation

A válasz hasznos adatként tartalmazza az entitás adatait és fejlécként való helyét.

Fejlécek

Location: string

Other Status Codes

Error

Hiba történt.

Biztonság

Ocp-Apim-Subscription-Key

Itt adja meg a Cognitive Services-fiókkulcsot.

Típus: apiKey
In: header

Authorization

Adjon meg egy hozzáférési jogkivonatot a régió STS által visszaadott JWT-ből. Győződjön meg arról, hogy hozzáadja a felügyeleti hatókört a jogkivonathoz, ha hozzáadja a következő lekérdezési sztringet az STS URL-címéhez: ?scope=speechservicesmanagement

Típus: apiKey
In: header

Példák

Create a evaluation

Mintakérelem

HTTP

POST https://westus.api.cognitive.microsoft.com//speechtotext/v3.0/evaluations

{
  "model1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "model2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "dataset": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
  },
  "locale": "en-US",
  "displayName": "My new evaluation",
  "description": "The description of the evaluation"
}

Mintaválasz

Állapotkód:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6",
  "model1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "model2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "dataset": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
  },
  "transcription2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/ad86d0c9-af6d-4d14-a621-c60d7d65b74f"
  },
  "transcription1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.0/evaluations/00000000-0000-0000-0000-000000000000/files"
  },
  "properties": {
    "wordErrorRate2": 0.065,
    "wordErrorRate1": 0.065,
    "sentenceErrorRate2": 0.375,
    "sentenceCount2": 8,
    "wordCount2": 46,
    "correctWordCount2": 43,
    "wordSubstitutionCount2": 3,
    "wordDeletionCount2": 0,
    "wordInsertionCount2": 0,
    "sentenceErrorRate1": 0.375,
    "sentenceCount1": 8,
    "wordCount1": 46,
    "correctWordCount1": 43,
    "wordSubstitutionCount1": 3,
    "wordDeletionCount1": 0,
    "wordInsertionCount1": 0
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Evalution of one model against another model"
}

Definíciók

Name	Description
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Hiba
ErrorCode	Hibakód
Evaluation	Értékelés
EvaluationProperties	EvaluationProperties
InnerError	InnerError
Links	Hivatkozások
Status	Állapot

DetailedErrorCode

Enumerálás

DetailedErrorCode

Érték	Description
InvalidParameterValue	Érvénytelen paraméterérték.
InvalidRequestBodyFormat	Érvénytelen kérelem törzsformátuma.
EmptyRequest	Üres kérelem.
MissingInputRecords	Hiányzó bemeneti rekordok.
InvalidDocument	Érvénytelen dokumentum.
ModelVersionIncorrect	A modell verziója helytelen.
InvalidDocumentBatch	Érvénytelen dokumentumköteg.
UnsupportedLanguageCode	Nem támogatott nyelvi kód.
DataImportFailed	Az adatimportálás nem sikerült.
InUseViolation	Használaton belüli szabálysértés.
InvalidLocale	Érvénytelen területi beállítás.
InvalidBaseModel	Érvénytelen alapmodell.
InvalidAdaptationMapping	Érvénytelen adaptációs leképezés.
InvalidDataset	Érvénytelen adatkészlet.
InvalidTest	Érvénytelen teszt.
FailedDataset	Sikertelen adathalmaz.
InvalidModel	Érvénytelen modell.
InvalidTranscription	Érvénytelen átírás.
InvalidPayload	Érvénytelen hasznos adat.
InvalidParameter	Érvénytelen paraméter.
EndpointWithoutLogging	Végpont naplózás nélkül.
InvalidPermissions	Érvénytelen engedélyek.
InvalidPrerequisite	Érvénytelen előfeltétel.
InvalidProductId	Érvénytelen termékazonosító.
InvalidSubscription	Érvénytelen előfizetés.
InvalidProject	Érvénytelen projekt.
InvalidProjectKind	Érvénytelen projekttípus.
InvalidRecordingsUri	Érvénytelen felvételek uri.
OnlyOneOfUrlsOrContainerOrDataset	Csak egy URL-cím, tároló vagy adatkészlet.
ExceededNumberOfRecordingsUris	Túllépte a felvételek URI-jainak számát.
ModelMismatch	Modelleltérés.
ProjectGenderMismatch	A projekt neme nem egyezik.
ModelDeprecated	A modell elavult.
ModelExists	A modell létezik.
ModelNotDeployable	A modell nem telepíthető.
EndpointNotUpdatable	A végpont nem frissíthető.
SingleDefaultEndpoint	Egyetlen alapértelmezett végpont.
EndpointCannotBeDefault	A végpont nem lehet alapértelmezett.
InvalidModelUri	Érvénytelen modell uri.
SubscriptionNotFound	Az előfizetés nem található.
QuotaViolation	Kvóta megsértése.
UnsupportedDelta	Nem támogatott változás.
UnsupportedFilter	Nem támogatott szűrő.
UnsupportedPagination	Nem támogatott lapozás.
UnsupportedDynamicConfiguration	Nem támogatott dinamikus konfiguráció.
UnsupportedOrderBy	Nem támogatott sorrend szerint.
NoUtf8WithBom	Nincs utf8 a bom.
ModelDeploymentNotCompleteState	A modell üzembe helyezése nem fejeződött be.
SkuLimitsExist	A termékváltozat korlátai léteznek.
DeployingFailedModel	Sikertelen modell üzembe helyezése.
UnsupportedTimeRange	Nem támogatott időtartomány.
InvalidLogDate	Érvénytelen naplódátum.
InvalidLogId	Érvénytelen naplóazonosító.
InvalidLogStartTime	Érvénytelen naplóindítási időpont.
InvalidLogEndTime	Érvénytelen naplóvégzési idő.
InvalidTopForLogs	A naplók felső része érvénytelen.
InvalidSkipTokenForLogs	Érvénytelen kihagyó jogkivonat a naplókhoz.
DeleteNotAllowed	A törlés nem engedélyezett.
Forbidden	Tiltott.
DeployNotAllowed	Az üzembe helyezés nem engedélyezett.
UnexpectedError	Váratlan hiba.
InvalidCollection	Érvénytelen gyűjtemény.
InvalidCallbackUri	Érvénytelen visszahívási uri.
InvalidSasValidityDuration	Érvénytelen sas-érvényességi időtartam.
InaccessibleCustomerStorage	Elérhetetlen ügyféltároló.
UnsupportedClassBasedAdaptation	Nem támogatott osztályalapú adaptáció.
InvalidWebHookEventKind	Érvénytelen webhookesemény-típus.
InvalidTimeToLive	Érvénytelen élettartam.

EntityError

Objektum

EntityError

Name	Típus	Description
code	string	A hiba kódja.
message	string	A hiba üzenete.

EntityReference

Objektum

EntityReference

Name	Típus	Description
self	string (uri)	A hivatkozott entitás helye.

Error

Objektum

Hiba

Name	Típus	Description
code	ErrorCode	Hibakód Magas szintű hibakódok.
details	Error[]	További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban.
innerError	InnerError	InnerError Új belső hibaformátum, amely megfelel az https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owcímen elérhető Cognitive Services API-irányelveknek. Ez tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és választható tulajdonságok célértéke, részletek (kulcsértékpár), belső hiba (ez beágyazható).
message	string	Magas szintű hibaüzenet.
target	string	A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító".

ErrorCode

Enumerálás

Hibakód

Érték	Description
InvalidRequest	Az érvénytelen kérés hibakódját jelöli.
InvalidArgument	Az érvénytelen argumentum hibakódját jelöli.
InternalServerError	A belső kiszolgáló hibakódját jelöli.
ServiceUnavailable	A szolgáltatás nem érhető el hibakódjának ábrázolása.
NotFound	A nem található hibakódot jelöli.
PipelineError	A folyamat hibakódjának ábrázolása.
Conflict	Az ütközési hibakódot jelöli.
InternalCommunicationFailed	A belső kommunikáció nem sikerült hibakódját jelöli.
Forbidden	A tiltott hibakódot jelöli.
NotAllowed	A nem engedélyezett hibakódot jelöli.
Unauthorized	A jogosulatlan hibakódot jelöli.
UnsupportedMediaType	A nem támogatott médiatípus hibakódját jelöli.
TooManyRequests	A túl sok kérés hibakódját jelöli.
UnprocessableEntity	A feldolgozhatatlan entitás hibakódját jelöli.

Evaluation

Objektum

Értékelés

Name	Típus	Description
createdDateTime	string (date-time)	Az objektum létrehozásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Az entitás egyéni tulajdonságai. A maximálisan megengedett kulcshossz 64 karakter, az engedélyezett érték maximális hossza 256 karakter, az engedélyezett bejegyzések száma pedig 10.
dataset	EntityReference	EntityReference
description	string	Az objektum leírása.
displayName	string	Az objektum megjelenítendő neve.
lastActionDateTime	string (date-time)	Az aktuális állapot megadásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	Links	Hivatkozások
locale	string	A tartalmazott adatok területi beállítása.
model1	EntityReference	EntityReference
model2	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	EvaluationProperties	EvaluationProperties
self	string (uri)	Az entitás helye.
status	Status	Állapot Az API aktuális állapotának ismertetése
transcription1	EntityReference	EntityReference
transcription2	EntityReference	EntityReference

EvaluationProperties

Objektum

EvaluationProperties

Name	Típus	Description
correctWordCount1	integer (int32)	A helyesen felismert szavak száma modell1 szerint.
correctWordCount2	integer (int32)	A helyesen felismert szavak száma modell szerint2.
email	string	A művelet befejeződése esetén az e-mail-értesítések küldéséhez szükséges e-mail-cím. Az érték az e-mail sikeres elküldése után törlődik.
error	EntityError	EntityError
sentenceCount1	integer (int32)	A feldolgozott mondatok száma modell szerint1.
sentenceCount2	integer (int32)	A feldolgozott mondatok száma modell szerint2.
sentenceErrorRate1	number (double)	A felismerés mondathibáinak aránya az 1. modellel.
sentenceErrorRate2	number (double)	A felismerés mondathibáinak aránya a 2. modellel.
wordCount1	integer (int32)	A feldolgozott szavak száma modell1 szerint.
wordCount2	integer (int32)	A feldolgozott szavak száma modell szerint2.
wordDeletionCount1	integer (int32)	A felismert szavak száma modell1 szerint, azaz törlés.
wordDeletionCount2	integer (int32)	A felismert szavak száma modell szerint2, azaz törlés.
wordErrorRate1	number (double)	A felismerés hibaaránya a modell1-zel.
wordErrorRate2	number (double)	A felismerés hibaaránya a model2-vel.
wordInsertionCount1	integer (int32)	A felismert szavak száma modell1 szerint, amelyek beszúrások.
wordInsertionCount2	integer (int32)	A felismert szavak száma modell szerint2, amelyek beszúrások.
wordSubstitutionCount1	integer (int32)	A felismert szavak száma modell1 szerint, amelyek helyettesítések.
wordSubstitutionCount2	integer (int32)	A 2. modell által felismert szavak száma, amelyek helyettesítések.

InnerError

Objektum

InnerError

Name	Típus	Description
code	DetailedErrorCode	DetailedErrorCode Részletes hibakód enumerálás.
details	object	További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban.
innerError	InnerError	InnerError Új belső hibaformátum, amely megfelel az https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owcímen elérhető Cognitive Services API-irányelveknek. Ez tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és választható tulajdonságok célértéke, részletek (kulcsértékpár), belső hiba (ez beágyazható).
message	string	Magas szintű hibaüzenet.
target	string	A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító".

Links

Objektum

Hivatkozások

Name	Típus	Description
files	string (uri)	Az entitás összes fájljának lekérési helye.

Status

Enumerálás

Állapot

Érték	Description
NotStarted	A hosszú ideig futó művelet még nem indult el.
Running	A hosszú ideig futó művelet jelenleg feldolgozásra kerül.
Succeeded	A hosszú ideig futó művelet sikeresen befejeződött.
Failed	A hosszú ideig futó művelet nem sikerült.

Megosztás a következőn keresztül:

Create Evaluation - Create Evaluation

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

Ocp-Apim-Subscription-Key

Authorization

Példák

Create a evaluation

Mintakérelem

Mintaválasz

Definíciók

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

Evaluation

EvaluationProperties

InnerError

Links

Status