Evaluations - Create

  • Reference
Služba:
Azure AI Services
Verze rozhraní API:
v3.2-preview.2

Vytvoří nové vyhodnocení.

POST {endpoint}/speechtotext/v3.2-preview.2/evaluations

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).

Text požadavku

Name Vyžadováno Typ Description
dataset True

EntityReference

EntityReference
displayName True

string

Zobrazovaný název objektu.
locale True

string

Národní prostředí obsažených dat.
model1 True

EntityReference

EntityReference
model2 True

EntityReference

EntityReference
customProperties

object

Vlastní vlastnosti této entity. Maximální povolená délka klíče je 64 znaků, maximální délka povolené hodnoty je 256 znaků a počet povolených položek je 10.
description

string

Popis objektu.
project

EntityReference

EntityReference
transcription1

EntityReference

EntityReference
transcription2

EntityReference

EntityReference

Odpovědi

Name Typ Description
201 Created

Evaluation

Odpověď obsahuje informace o entitě jako datové části a jejím umístění jako hlavičce.

Hlavičky

Location: string
Other Status Codes

Error

Došlo k chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

Tady zadejte svůj klíč účtu služeb Cognitive Services.

Typ: apiKey
V: header

Authorization

Zadejte přístupový token z JWT vrácený službou STS této oblasti. Nezapomeňte do tokenu přidat obor správy přidáním následujícího řetězce dotazu do adresy URL služby STS: ?scope=speechservicesmanagement.

Typ: apiKey
V: header

Příklady

Create a evaluation

Ukázkový požadavek

POST {endpoint}/speechtotext/v3.2-preview.2/evaluations

{
  "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"
  },
  "locale": "en-US",
  "displayName": "My new evaluation",
  "description": "The description of the evaluation"
}

Ukázková odpověď

Stavový kód:
201 
Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6
{
  "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"
}

Definice

Name Description
DetailedErrorCode

Podrobný kód chyby
EntityError

Chyba entity
EntityReference

EntityReference
Error

Chyba
ErrorCode

ErrorCode
Evaluation

Hodnocení
EvaluationLinks

EvaluationLinks
EvaluationProperties

EvaluationVlastnosti
InnerError

Vnitřní chyba
Status

Stav

DetailedErrorCode

Podrobný kód chyby

Name Typ Description
DataImportFailed

string

Import dat se nezdařil.
DeleteNotAllowed

string

Odstranění není povoleno.
DeployNotAllowed

string

Nasazení není povoleno.
DeployingFailedModel

string

Nasazení neúspěšného modelu
EmptyRequest

string

Prázdný požadavek.
EndpointCannotBeDefault

string

Koncový bod nemůže být výchozí.
EndpointNotUpdatable

string

Koncový bod není možné aktualizovat.
EndpointWithoutLogging

string

Koncový bod bez protokolování.
ExceededNumberOfRecordingsUris

string

Překročili jsme počet nahrávek uris.
FailedDataset

string

Datová sada se nezdařila.
Forbidden

string

Zakázáno.
InUseViolation

string

Porušením používání.
InaccessibleCustomerStorage

string

Nepřístupné úložiště zákazníka.
InvalidAdaptationMapping

string

Neplatné mapování adaptace
InvalidBaseModel

string

Neplatný základní model.
InvalidCallbackUri

string

Neplatný identifikátor URI zpětného volání
InvalidCollection

string

Neplatná kolekce.
InvalidDataset

string

Neplatná datová sada
InvalidDocument

string

Neplatný dokument.
InvalidDocumentBatch

string

Neplatná dávka dokumentu.
InvalidLocale

string

Neplatné národní prostředí.
InvalidLogDate

string

Neplatné datum protokolu
InvalidLogEndTime

string

Neplatný koncový čas protokolu.
InvalidLogId

string

Neplatné ID protokolu.
InvalidLogStartTime

string

Neplatný čas spuštění protokolu.
InvalidModel

string

Neplatný model.
InvalidModelUri

string

Neplatný identifikátor URI modelu
InvalidParameter

string

Neplatný parametr.
InvalidParameterValue

string

Neplatná hodnota parametru
InvalidPayload

string

Neplatná datová část.
InvalidPermissions

string

Neplatná oprávnění.
InvalidPrerequisite

string

Neplatný předpoklad.
InvalidProductId

string

Neplatné ID produktu.
InvalidProject

string

Neplatný projekt.
InvalidProjectKind

string

Neplatný druh projektu.
InvalidRecordingsUri

string

Neplatný identifikátor URI nahrávek
InvalidRequestBodyFormat

string

Neplatný formát textu požadavku.
InvalidSasValidityDuration

string

Neplatná doba platnosti sas.
InvalidSkipTokenForLogs

string

Neplatný token skip pro protokoly.
InvalidSourceAzureResourceId

string

Neplatné ID zdrojového prostředku Azure.
InvalidSubscription

string

Neplatné předplatné.
InvalidTest

string

Neplatný test.
InvalidTimeToLive

string

Neplatný čas do života.
InvalidTopForLogs

string

Neplatná horní část pro protokoly.
InvalidTranscription

string

Neplatný přepis.
InvalidWebHookEventKind

string

Neplatný druh události web hooku
MissingInputRecords

string

Chybí vstupní záznamy.
ModelCopyOperationExists

string

Existuje operace kopírování modelu.
ModelDeploymentNotCompleteState

string

Nasazení modelu není dokončeno.
ModelDeprecated

string

Model je zastaralý.
ModelExists

string

Model existuje.
ModelMismatch

string

Neshoda modelů.
ModelNotDeployable

string

Model nejde nasadit.
ModelVersionIncorrect

string

Nesprávná verze modelu.
NoUtf8WithBom

string

Ne utf8 s bom.
OnlyOneOfUrlsOrContainerOrDataset

string

Pouze jednu z adres URL nebo kontejneru nebo datové sady.
ProjectGenderMismatch

string

Neshoda mezi pohlavími projektu.
QuotaViolation

string

Porušení kvóty.
SingleDefaultEndpoint

string

Jeden výchozí koncový bod.
SkuLimitsExist

string

Existují omezení skladových položek.
SubscriptionNotFound

string

Předplatné se nenašlo.
UnexpectedError

string

Neočekávaná chyba.
UnsupportedClassBasedAdaptation

string

Nepodporovaná adaptace na základě tříd.
UnsupportedDelta

string

Nepodporovaný rozdíl.
UnsupportedDynamicConfiguration

string

Nepodporovaná dynamická konfigurace.
UnsupportedFilter

string

Nepodporovaný filtr.
UnsupportedLanguageCode

string

Nepodporovaný kód jazyka.
UnsupportedOrderBy

string

Nepodporované pořadí podle.
UnsupportedPagination

string

Nepodporované stránkování.
UnsupportedTimeRange

string

Nepodporovaný časový rozsah.

EntityError

Chyba entity

Name Typ Description
code

string

Kód této chyby.
message

string

Zpráva pro tuto chybu.

EntityReference

EntityReference

Name Typ Description
self

string

Umístění odkazované entity.

Error

Chyba

Name Typ Description
code

ErrorCode

ErrorCode
Kódy chyb vysoké úrovně.
details

Error[]

Další podrobnosti podpory týkající se chyby nebo očekávaných zásad
innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, který odpovídá pokynům k rozhraní API služeb Cognitive Services, které jsou k dispozici na adrese https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message a optional properties target, details(key value pair), inner error (to může být vnořené).
message

string

Chybová zpráva vysoké úrovně.
target

string

Zdroj chyby. Například v případě neplatného dokumentu by to byly "dokumenty" nebo "ID dokumentu".

ErrorCode

ErrorCode

Name Typ Description
Conflict

string

Představuje kód chyby konfliktu.
Forbidden

string

Představuje zakázaný kód chyby.
InternalCommunicationFailed

string

Představuje kód chyby selhání interní komunikace.
InternalServerError

string

Představuje kód vnitřní chyby serveru.
InvalidArgument

string

Představuje neplatný kód chyby argumentu.
InvalidRequest

string

Představuje neplatný kód chyby požadavku.
NotAllowed

string

Představuje nepovolený kód chyby.
NotFound

string

Představuje kód chyby nenalezena.
PipelineError

string

Představuje kód chyby kanálu.
ServiceUnavailable

string

Představuje kód chyby nedostupné služby.
TooManyRequests

string

Představuje kód chyby příliš mnoho požadavků.
Unauthorized

string

Představuje neoprávněný kód chyby.
UnprocessableEntity

string

Představuje nezpracovaný kód chyby entity.
UnsupportedMediaType

string

Představuje kód chyby nepodporovaného typu média.

Evaluation

Hodnocení

Name Typ Description
createdDateTime

string

Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódováno jako formát data a času ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties

object

Vlastní vlastnosti této entity. Maximální povolená délka klíče je 64 znaků, maximální délka povolené hodnoty je 256 znaků a počet povolených položek je 10.
dataset

EntityReference

EntityReference
description

string

Popis objektu.
displayName

string

Zobrazovaný název objektu.
lastActionDateTime

string

Časové razítko, kdy byl zadán aktuální stav. Časové razítko je kódováno jako formát data a času ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links

EvaluationLinks

EvaluationLinks
locale

string

Národní prostředí obsažených dat.
model1

EntityReference

EntityReference
model2

EntityReference

EntityReference
project

EntityReference

EntityReference
properties

EvaluationProperties

EvaluationVlastnosti
self

string

Umístění této entity.
status

Status

Stav
Popis aktuálního stavu rozhraní API
transcription1

EntityReference

EntityReference
transcription2

EntityReference

EntityReference

EvaluationLinks

Name Typ Description
files

string

Umístění pro získání všech souborů této entity Další podrobnosti najdete v operaci "Evaluations_ListFiles".

EvaluationProperties

EvaluationVlastnosti

Name Typ Description
correctTokenCount1

integer

Počet správně rozpoznaných tokenů modelem 1.
correctTokenCount2

integer

Počet správně rozpoznaných tokenů modelem 2.
correctWordCount1

integer

Počet správně rozpoznaných slov podle modelu 1.
correctWordCount2

integer

Počet správně rozpoznaných slov podle modelu 2.
email

string

E-mailová adresa, na kterou se mají odesílat e-mailová oznámení pro případ, že se operace dokončí. Hodnota se po úspěšném odeslání e-mailu odebere.
error

EntityError

Chyba entity
sentenceCount1

integer

Počet zpracovaných vět podle modelu 1.
sentenceCount2

integer

Počet zpracovaných vět podle modelu 2.
sentenceErrorRate1

number

Míra chyb rozpoznávání věty s modelem 1
sentenceErrorRate2

number

Míra chyb ve větě při rozpoznávání modelu 2.
tokenCount1

integer

Počet zpracovaných tokenů podle modelu 1.
tokenCount2

integer

Počet zpracovaných tokenů modelem 2.
tokenDeletionCount1

integer

Počet rozpoznaných tokenů modelem 1, které jsou odstraněny.
tokenDeletionCount2

integer

Počet rozpoznaných tokenů modelem 2, které jsou odstraněny.
tokenErrorRate1

number

Míra chyb tokenu při rozpoznávání modelu 1
tokenErrorRate2

number

Míra chyb tokenu při rozpoznávání modelu 2.
tokenInsertionCount1

integer

Počet rozpoznaných tokenů modelem 1, které jsou vloženími.
tokenInsertionCount2

integer

Počet rozpoznaných tokenů modelem 2, které jsou vloženími.
tokenSubstitutionCount1

integer

Počet rozpoznaných tokenů modelem 1, které jsou náhradami.
tokenSubstitutionCount2

integer

Počet rozpoznaných tokenů modelem 2, které jsou náhradami.
wordCount1

integer

Počet zpracovaných slov podle modelu 1.
wordCount2

integer

Počet zpracovaných slov podle modelu 2.
wordDeletionCount1

integer

Počet rozpoznaných slov podle modelu1, která jsou odstraněna.
wordDeletionCount2

integer

Počet rozpoznaných slov podle modelu 2, která jsou odstraněna.
wordErrorRate1

number

Slovo míra chyb rozpoznávání s modelem1
wordErrorRate2

number

Slovo míra chyb rozpoznávání s modelem 2
wordInsertionCount1

integer

Počet rozpoznaných slov podle modelu1, která jsou vložena.
wordInsertionCount2

integer

Počet rozpoznaných slov podle modelu 2, která jsou vložením.
wordSubstitutionCount1

integer

Počet rozpoznaných slov podle modelu 1, která jsou náhradami.
wordSubstitutionCount2

integer

Počet rozpoznaných slov podle modelu 2, která jsou nahrazeními.

InnerError

Vnitřní chyba

Name Typ Description
code

DetailedErrorCode

Podrobný kód chyby
Podrobný výčet kódu chyby
details

object

Další podrobnosti podpory týkající se chyby nebo očekávaných zásad
innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, který odpovídá pokynům k rozhraní API služeb Cognitive Services, které jsou k dispozici na adrese https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message a optional properties target, details(key value pair), inner error (to může být vnořené).
message

string

Chybová zpráva vysoké úrovně.
target

string

Zdroj chyby. Například v případě neplatného dokumentu by to byly "dokumenty" nebo "ID dokumentu".

Status

Stav

Name Typ Description
Failed

string

Dlouhotrvající operace selhala.
NotStarted

string

Dlouhotrvající operace ještě nebyla spuštěna.
Running

string

Dlouhotrvající operace se právě zpracovává.
Succeeded

string

Dlouhotrvající operace se úspěšně dokončila.