Evaluations - Update

Szolgáltatás:: Azure AI Services

API-verzió:: v3.2-preview.2

Frissíti az azonosító által azonosított kiértékelési adatokat.

PATCH {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}

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).
id	path	True	string (uuid)	A kiértékelés azonosítója.

Kérelem törzse

Media Types: "application/json", "application/merge-patch+json"

Name	Típus	Description
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.
displayName	string	Az objektum neve.
project	EntityReference	EntityReference

Válaszok

Name	Típus	Description
200 OK	Evaluation	OKÉ Fejlécek Retry-After: integer
Other Status Codes	Error	Hiba történt.

Name

Típus

Description

200 OK

Evaluation

OKÉ

Fejlécek

Retry-After: integer

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

Update a evaluation

Mintakérelem

HTTP

PATCH {endpoint}/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6

{
  "displayName": "Updated evaluation",
  "description": "Updated evaluation description"
}

Mintaválasz

Állapotkód:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6",
  "model1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "model2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "dataset": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
  },
  "transcription2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ad86d0c9-af6d-4d14-a621-c60d7d65b74f"
  },
  "transcription1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/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,
    "tokenErrorRate2": 0.125,
    "tokenErrorRate1": 0.125,
    "tokenCount2": 48,
    "correctTokenCount2": 42,
    "tokenSubstitutionCount2": 6,
    "tokenDeletionCount2": 0,
    "tokenInsertionCount2": 0,
    "tokenCount1": 48,
    "correctTokenCount1": 42,
    "tokenSubstitutionCount1": 6,
    "tokenDeletionCount1": 0,
    "tokenInsertionCount1": 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
EvaluationLinks	EvaluationLinks
EvaluationProperties	EvaluationProperties
EvaluationUpdate	EvaluationUpdate
InnerError	InnerError
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.
InvalidSourceAzureResourceId	Érvénytelen forrás Azure-erőforrás-azonosító.
ModelCopyOperationExists	Létezik modellmásolási művelet.

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 minLength: 1	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	EvaluationLinks	EvaluationLinks
locale	string minLength: 1	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

EvaluationLinks

Objektum

EvaluationLinks

Name	Típus	Description
files	string (uri)	Az entitás összes fájljának lekérési helye. További részletekért tekintse meg a "Evaluations_ListFiles" műveletet.

EvaluationProperties

Objektum

EvaluationProperties

Name	Típus	Description
correctTokenCount1	integer (int32)	A helyesen felismert jogkivonatok száma modell1 szerint.
correctTokenCount2	integer (int32)	A helyesen felismert jogkivonatok száma modell szerint2.
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.
tokenCount1	integer (int32)	A feldolgozott jogkivonatok száma modell1 szerint.
tokenCount2	integer (int32)	A feldolgozott jogkivonatok száma modell szerint2.
tokenDeletionCount1	integer (int32)	A felismert jogkivonatok száma modell1 szerint, amelyek törlések.
tokenDeletionCount2	integer (int32)	A 2. modell által felismert jogkivonatok száma, amelyek törlések.
tokenErrorRate1	number (double)	A token hibaaránya a modell1 esetében.
tokenErrorRate2	number (double)	A token hibaaránya a 2. modellben.
tokenInsertionCount1	integer (int32)	A modell1 által felismert jogkivonatok száma, amelyek beszúrások.
tokenInsertionCount2	integer (int32)	A modell2 által felismert jogkivonatok száma, amelyek beszúrások.
tokenSubstitutionCount1	integer (int32)	A modell1 által felismert jogkivonatok száma, amelyek helyettesítések.
tokenSubstitutionCount2	integer (int32)	A modell2 által felismert jogkivonatok száma, amelyek helyettesítések.
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.

EvaluationUpdate

Objektum

EvaluationUpdate

Name	Típus	Description
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.
displayName	string	Az objektum neve.
project	EntityReference	EntityReference

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ó".

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.