Create Evaluation - Create Evaluation

Referencia

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

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

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

További források