Projects - List Evaluations

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 3.2

Získá seznam vyhodnocení pro zadaný projekt.

GET {endpoint}/speechtotext/v3.2/projects/{id}/evaluations

S volitelnými parametry:

GET {endpoint}/speechtotext/v3.2/projects/{id}/evaluations?skip={skip}&top={top}&filter={filter}

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).
id	path	True	string uuid	Identifikátor projektu.
filter	query		string	Filtrovací výraz pro výběr podmnožiny dostupných vyhodnocení. `- Supported properties: displayName, description, createdDateTime, lastActionDateTime, status and locale. - Operators: - eq, ne are supported for all properties. - gt, ge, lt, le are supported for createdDateTime and lastActionDateTime. - and, or, not are supported. - Example filter=displayName eq 'My evaluation'`
skip	query		integer int32	Počet datových sad, které budou vynechány.
top	query		integer int32	Počet datových sad, které budou zahrnuty po přeskočení

Odpovědi

Name	Typ	Description
200 OK	PaginatedEvaluations	OK Hlavičky Retry-After: integer
Other Status Codes	Error	Došlo k chybě.

Name

Typ

Description

200 OK

PaginatedEvaluations

Hlavičky

Retry-After: integer

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

Get all evaluations

Ukázkový požadavek

HTTP

GET {endpoint}/speechtotext/v3.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations?skip=0&top=2

Ukázková odpověď

Stavový kód:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/evaluations/a55a327b-c866-40b3-a08d-9c0945738633",
      "model1": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
      },
      "model2": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
      },
      "dataset": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
      },
      "transcription2": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/ad86d0c9-af6d-4d14-a621-c60d7d65b74f"
      },
      "transcription1": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683"
      },
      "links": {
        "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/evaluations/00000000-0000-0000-0000-000000000000/files"
      },
      "properties": {
        "wordErrorRate1": 0.065,
        "sentenceErrorRate1": 0.375,
        "tokenErrorRate1": 0.125,
        "sentenceCount1": 8,
        "wordCount1": 46,
        "correctWordCount1": 43,
        "wordSubstitutionCount1": 3,
        "wordDeletionCount1": 0,
        "wordInsertionCount1": 0,
        "tokenCount1": 48,
        "correctTokenCount1": 42,
        "tokenSubstitutionCount1": 6,
        "tokenDeletionCount1": 0,
        "tokenInsertionCount1": 0,
        "tokenErrors1": {
          "punctuation": {
            "numberOfEdits": 2,
            "percentageOfAllEdits": 0.66
          },
          "capitalization": {
            "numberOfEdits": 1,
            "percentageOfAllEdits": 0.33
          }
        },
        "wordErrorRate2": 0.065,
        "sentenceErrorRate2": 0.375,
        "tokenErrorRate2": 0.125,
        "sentenceCount2": 8,
        "wordCount2": 46,
        "correctWordCount2": 43,
        "wordSubstitutionCount2": 3,
        "wordDeletionCount2": 0,
        "wordInsertionCount2": 0,
        "tokenCount2": 48,
        "correctTokenCount2": 42,
        "tokenSubstitutionCount2": 6,
        "tokenDeletionCount2": 0,
        "tokenInsertionCount2": 0,
        "tokenErrors2": {
          "punctuation": {
            "numberOfEdits": 208,
            "percentageOfAllEdits": 1.22
          },
          "capitalization": {
            "numberOfEdits": 126,
            "percentageOfAllEdits": 0.74
          },
          "inverseTextNormalization": {
            "numberOfEdits": 409,
            "percentageOfAllEdits": 2.4
          },
          "lexical": {
            "numberOfEdits": 16284,
            "percentageOfAllEdits": 95.41
          },
          "others": {
            "numberOfEdits": 41,
            "percentageOfAllEdits": 0.24
          }
        }
      },
      "lastActionDateTime": "2019-01-07T11:36:07Z",
      "status": "Succeeded",
      "createdDateTime": "2019-01-07T11:34:12Z",
      "locale": "en-US",
      "displayName": "Evaluation of one model against another model"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/evaluations/daaa45a7-38f0-4918-87d2-bf55fec32ac5",
      "model1": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
      },
      "model2": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
      },
      "dataset": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
      },
      "transcription2": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/ad86d0c9-af6d-4d14-a621-c60d7d65b74f"
      },
      "transcription1": {
        "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683"
      },
      "links": {
        "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/evaluations/00000000-0000-0000-0000-000000000000/files"
      },
      "properties": {
        "wordErrorRate1": 0.065,
        "sentenceErrorRate1": 0.375,
        "tokenErrorRate1": 0.125,
        "sentenceCount1": 8,
        "wordCount1": 46,
        "correctWordCount1": 43,
        "wordSubstitutionCount1": 3,
        "wordDeletionCount1": 0,
        "wordInsertionCount1": 0,
        "tokenCount1": 48,
        "correctTokenCount1": 42,
        "tokenSubstitutionCount1": 6,
        "tokenDeletionCount1": 0,
        "tokenInsertionCount1": 0,
        "tokenErrors1": {
          "punctuation": {
            "numberOfEdits": 2,
            "percentageOfAllEdits": 0.66
          },
          "capitalization": {
            "numberOfEdits": 1,
            "percentageOfAllEdits": 0.33
          }
        },
        "wordErrorRate2": 0.065,
        "sentenceErrorRate2": 0.375,
        "tokenErrorRate2": 0.125,
        "sentenceCount2": 8,
        "wordCount2": 46,
        "correctWordCount2": 43,
        "wordSubstitutionCount2": 3,
        "wordDeletionCount2": 0,
        "wordInsertionCount2": 0,
        "tokenCount2": 48,
        "correctTokenCount2": 42,
        "tokenSubstitutionCount2": 6,
        "tokenDeletionCount2": 0,
        "tokenInsertionCount2": 0,
        "tokenErrors2": {
          "punctuation": {
            "numberOfEdits": 208,
            "percentageOfAllEdits": 1.22
          },
          "capitalization": {
            "numberOfEdits": 126,
            "percentageOfAllEdits": 0.74
          },
          "inverseTextNormalization": {
            "numberOfEdits": 409,
            "percentageOfAllEdits": 2.4
          },
          "lexical": {
            "numberOfEdits": 16284,
            "percentageOfAllEdits": 95.41
          },
          "others": {
            "numberOfEdits": 41,
            "percentageOfAllEdits": 0.24
          }
        }
      },
      "lastActionDateTime": "2019-01-07T11:36:07Z",
      "status": "Succeeded",
      "createdDateTime": "2019-01-07T11:34:12Z",
      "locale": "en-US",
      "displayName": "Evaluation of one model against another model"
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6/files?skip=2&top=2"
}

Definice

Name	Description
DetailedErrorCode	Podrobný kód chyby
EditsSummary	ÚpravySummary
EntityError	Chyba entity
EntityReference	EntityReference
Error	Chyba
ErrorCode	ErrorCode
Evaluation	Hodnocení
EvaluationLinks	EvaluationLinks
EvaluationProperties	Vyhodnocení– vlastnosti
InnerError	Vnitřní chyba
PaginatedEvaluations	PaginatedEvaluations
Status	Stav
TokenErrorDetails	TokenErrorDetails

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í
InvalidChannels	string	Neplatné kanály.
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.
ModelCopyAuthorizationExpired	string	Vypršela platnost ModeluCopyAuthorization.
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.

EditsSummary

ÚpravySummary

Name	Typ	Description
numberOfEdits	integer	Volitelný počet úprav pro daný typ chyby rozpoznaného přepisu v porovnání s přepisem člověka.
percentageOfAllEdits	number	Volitelné procento úprav pro daný typ chyby rozpoznaného přepisu v porovnání s přepisem člověka

EntityError

Chyba entity

Name	Typ	Description
code	string	Kód této chyby.
message	string	Zpráva pro tuto chybu.

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ší podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innerError	InnerError	Vnitřní chyba Nový formát vnitřních chyb, 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. V případě neplatného dokumentu by to bylo například "dokumenty" nebo "id dokumentu".

ErrorCode

Name	Typ	Description
Conflict	string	Představuje kód chyby konfliktu.
Forbidden	string	Představuje kód chyby Zakázáno.
InternalCommunicationFailed	string	Představuje kód chyby vnitřní komunikace, která selhala.
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 kód chyby nezpracované 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ódované 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í povolená délka 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ódované 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	Vyhodnocení– vlastnosti
self	string	Umístění této entity
status	Status	Stav Popište aktuální stav 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 části operace Evaluations_ListFiles.

EvaluationProperties

Vyhodnocení– vlastnosti

Name	Typ	Description
correctTokenCount1	integer	Volitelný počet správně rozpoznaných tokenů modelem 1.
correctTokenCount2	integer	Volitelný 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 budou 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 vět při rozpoznávání model1.
sentenceErrorRate2	number	Míra chyb vět při rozpoznávání s modelem 2.
tokenCount1	integer	Nepovinný počet zpracovaných tokenů podle modelu 1.
tokenCount2	integer	Volitelný počet zpracovaných tokenů podle modelu 2.
tokenDeletionCount1	integer	Volitelný počet rozpoznaných tokenů modelem1, které jsou odstraněny.
tokenDeletionCount2	integer	Volitelný počet rozpoznaných tokenů modelem2, které jsou odstraněny.
tokenErrorRate1	number	Míra chyb volitelného tokenu při rozpoznávání modelu 1.
tokenErrorRate2	number	Míra chyb volitelného tokenu při rozpoznávání modelu 2.
tokenErrors1	TokenErrorDetails	TokenErrorDetails
tokenErrors2	TokenErrorDetails	TokenErrorDetails
tokenInsertionCount1	integer	Volitelný počet rozpoznaných tokenů modelem1, které jsou vloženy.
tokenInsertionCount2	integer	Volitelný počet rozpoznaných tokenů model2, které jsou vloženy.
tokenSubstitutionCount1	integer	Volitelný počet rozpoznaných tokenů modelem 1, které představují náhrady.
tokenSubstitutionCount2	integer	Volitelný počet rozpoznaných tokenů modelem2, které představují náhrady.
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 modelu 1, která jsou odstraněna.
wordDeletionCount2	integer	Počet rozpoznaných slov model2, která jsou odstraněna.
wordErrorRate1	number	Míra chyb slov při rozpoznávání model1.
wordErrorRate2	number	Míra chyb slov při rozpoznávání model2.
wordInsertionCount1	integer	Počet rozpoznaných slov podle modelu 1, která jsou vložena.
wordInsertionCount2	integer	Počet rozpoznaných slov podle modelu 2, která jsou vložena.
wordSubstitutionCount1	integer	Počet rozpoznaných slov modelem1, která představují náhrady.
wordSubstitutionCount2	integer	Počet rozpoznaných slov podle modelu 2, která jsou náhradou.

InnerError

Vnitřní chyba

Name	Typ	Description
code	DetailedErrorCode	Podrobný kód chyby Podrobný výčet kódu chyby
details	object	Další podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innerError	InnerError	Vnitřní chyba Nový formát vnitřních chyb, 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. V případě neplatného dokumentu by to bylo například "dokumenty" nebo "id dokumentu".

PaginatedEvaluations

Name	Typ	Description
@nextLink	string	Odkaz na další sadu stránkovaných výsledků, pokud je k dispozici více entit; jinak null.
values	Evaluation[]	Seznam entit omezených buď předanými parametry dotazu skip a top, nebo jejich výchozími hodnotami. Při iteraci seznamem pomocí stránkování a paralelním odstraňování entit se některé entity ve výsledcích přeskočí. Doporučujeme vytvořit seznam na klientovi a po načtení úplného seznamu ho odstranit.

Name

Typ

Description

@nextLink

string

Odkaz na další sadu stránkovaných výsledků, pokud je k dispozici více entit; jinak null.

values

Evaluation[]

Seznam entit omezených buď předanými parametry dotazu skip a top, nebo jejich výchozími hodnotami.

Při iteraci seznamem pomocí stránkování a paralelním odstraňování entit se některé entity ve výsledcích přeskočí. Doporučujeme vytvořit seznam na klientovi a po načtení úplného seznamu ho odstranit.

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.

TokenErrorDetails

Name	Typ	Description
capitalization	EditsSummary	ÚpravySummary
inverseTextNormalization	EditsSummary	ÚpravySummary
lexical	EditsSummary	ÚpravySummary
others	EditsSummary	ÚpravySummary
punctuation	EditsSummary	ÚpravySummary

Sdílet prostřednictvím

Projects - List Evaluations

Parametry identifikátoru URI

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Authorization

Příklady

Get all evaluations

Ukázkový požadavek

Ukázková odpověď

Definice

DetailedErrorCode

EditsSummary

EntityError

EntityReference

Error

ErrorCode

Evaluation

EvaluationLinks

EvaluationProperties

InnerError

PaginatedEvaluations

Status

TokenErrorDetails

Další materiály