Evaluations - Get
Возвращает оценку, определяемую заданным идентификатором.
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
endpoint
|
path | True |
string |
Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://westus.api.cognitive.microsoft.com). |
id
|
path | True |
string (uuid) |
Идентификатор оценки. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ХОРОШО Заголовки Retry-After: integer |
|
Other Status Codes |
Произошла ошибка. |
Безопасность
Ocp-Apim-Subscription-Key
Укажите ключ учетной записи Cognitive Services здесь.
Тип:
apiKey
В:
header
Authorization
Предоставьте маркер доступа из JWT, возвращаемого stS этого региона. Обязательно добавьте область управления в маркер, добавив следующую строку запроса к URL-адресу STS: ?scope=speechservicesmanagement
Тип:
apiKey
В:
header
Примеры
Get a evaluation
Образец запроса
GET {endpoint}/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"
}
Определения
Имя | Описание |
---|---|
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Ошибка |
Error |
Код ошибки |
Evaluation |
Оценка |
Evaluation |
EvaluationLinks |
Evaluation |
EvaluationProperties |
Inner |
InnerError |
Status |
Состояние |
DetailedErrorCode
DetailedErrorCode
Значение | Описание |
---|---|
DataImportFailed |
Сбой импорта данных. |
DeleteNotAllowed |
Удалить не разрешено. |
DeployNotAllowed |
Развертывание не разрешено. |
DeployingFailedModel |
Развертывание неудачной модели. |
EmptyRequest |
Пустой запрос. |
EndpointCannotBeDefault |
Конечная точка не может быть по умолчанию. |
EndpointNotUpdatable |
Конечная точка не обновляемая. |
EndpointWithoutLogging |
Конечная точка без ведения журнала. |
ExceededNumberOfRecordingsUris |
Превышено количество uri записей. |
FailedDataset |
Не удалось выполнить набор данных. |
Forbidden |
Запретный. |
InUseViolation |
Нарушение использования. |
InaccessibleCustomerStorage |
Недоступное хранилище клиентов. |
InvalidAdaptationMapping |
Недопустимое сопоставление адаптации. |
InvalidBaseModel |
Недопустимая базовая модель. |
InvalidCallbackUri |
Недопустимый универсальный код ресурса (URI) обратного вызова. |
InvalidCollection |
Недопустимая коллекция. |
InvalidDataset |
Недопустимый набор данных. |
InvalidDocument |
Недопустимый документ. |
InvalidDocumentBatch |
Недопустимый пакет документов. |
InvalidLocale |
Недопустимый языковой стандарт. |
InvalidLogDate |
Недопустимая дата журнала. |
InvalidLogEndTime |
Недопустимое время окончания журнала. |
InvalidLogId |
Недопустимый идентификатор журнала. |
InvalidLogStartTime |
Недопустимое время запуска журнала. |
InvalidModel |
Недопустимая модель. |
InvalidModelUri |
Недопустимый универсальный код ресурса (URI) модели. |
InvalidParameter |
Недопустимый параметр. |
InvalidParameterValue |
Недопустимое значение параметра. |
InvalidPayload |
Недопустимые полезные данные. |
InvalidPermissions |
Недопустимые разрешения. |
InvalidPrerequisite |
Недопустимое условие. |
InvalidProductId |
Недопустимый идентификатор продукта. |
InvalidProject |
Недопустимый проект. |
InvalidProjectKind |
Недопустимый тип проекта. |
InvalidRecordingsUri |
Недопустимые URI записей. |
InvalidRequestBodyFormat |
Недопустимый формат текста запроса. |
InvalidSasValidityDuration |
Недопустимая длительность действия sas. |
InvalidSkipTokenForLogs |
Недопустимый маркер пропуска для журналов. |
InvalidSourceAzureResourceId |
Недопустимый исходный идентификатор ресурса Azure. |
InvalidSubscription |
Недопустимая подписка. |
InvalidTest |
Недопустимый тест. |
InvalidTimeToLive |
Недопустимое время жизни. |
InvalidTopForLogs |
Недопустимое начало для журналов. |
InvalidTranscription |
Недопустимое транскрибирование. |
InvalidWebHookEventKind |
Недопустимый тип события веб-перехватчика. |
MissingInputRecords |
Отсутствуют входные записи. |
ModelCopyOperationExists |
Существует операция копирования модели. |
ModelDeploymentNotCompleteState |
Развертывание модели не завершено. |
ModelDeprecated |
Модель устарела. |
ModelExists |
Существует модель. |
ModelMismatch |
Несоответствие модели. |
ModelNotDeployable |
Модель недоступна для развертывания. |
ModelVersionIncorrect |
Неправильная версия модели. |
NoUtf8WithBom |
Нет utf8 с бомом. |
OnlyOneOfUrlsOrContainerOrDataset |
Только один url-адрес или контейнер или набор данных. |
ProjectGenderMismatch |
Несоответствие пола проекта. |
QuotaViolation |
Нарушение квоты. |
SingleDefaultEndpoint |
Одна конечная точка по умолчанию. |
SkuLimitsExist |
Существуют ограничения SKU. |
SubscriptionNotFound |
Подписка не найдена. |
UnexpectedError |
Непредвиденная ошибка. |
UnsupportedClassBasedAdaptation |
Неподдерживаемая адаптация на основе класса. |
UnsupportedDelta |
Неподдерживаемые разностные данные. |
UnsupportedDynamicConfiguration |
Неподдерживаемая динамическая конфигурация. |
UnsupportedFilter |
Неподдерживаемый фильтр. |
UnsupportedLanguageCode |
Неподдерживаемый код языка. |
UnsupportedOrderBy |
Неподдерживаемый заказ. |
UnsupportedPagination |
Неподдерживаемая разбивка на страницы. |
UnsupportedTimeRange |
Неподдерживаемый диапазон времени. |
EntityError
EntityError
Имя | Тип | Описание |
---|---|---|
code |
string |
Код этой ошибки. |
message |
string |
Сообщение об этой ошибке. |
EntityReference
EntityReference
Имя | Тип | Описание |
---|---|---|
self |
string (uri) |
Расположение указанной сущности. |
Error
Ошибка
Имя | Тип | Описание |
---|---|---|
code |
Код ошибки |
|
details |
Error[] |
Дополнительные сведения о поддержке ошибок и (или) ожидаемых политик. |
innerError |
InnerError |
|
message |
string |
Сообщение об ошибке высокого уровня. |
target |
string |
Источник ошибки. Например, это будет "документы" или "идентификатор документа" в случае недопустимого документа. |
ErrorCode
Код ошибки
Значение | Описание |
---|---|
Conflict |
Представляет код ошибки конфликта. |
Forbidden |
Представляет запрещенный код ошибки. |
InternalCommunicationFailed |
Представляет код ошибки внутренней связи. |
InternalServerError |
Представляет код ошибки внутреннего сервера. |
InvalidArgument |
Представляет недопустимый код ошибки аргумента. |
InvalidRequest |
Представляет недопустимый код ошибки запроса. |
NotAllowed |
Представляет недопустимый код ошибки. |
NotFound |
Представление не найденного кода ошибки. |
PipelineError |
Представляет код ошибки конвейера. |
ServiceUnavailable |
Представляет недоступный код ошибки службы. |
TooManyRequests |
Представление слишком большого количества запросов кода ошибки. |
Unauthorized |
Представляет несанкционированный код ошибки. |
UnprocessableEntity |
Представляет код ошибки необработанной сущности. |
UnsupportedMediaType |
Представляет неподдерживаемый код ошибки типа носителя. |
Evaluation
Оценка
Имя | Тип | Описание |
---|---|---|
createdDateTime |
string (date-time) |
Метка времени при создании объекта. Метка времени закодирована как формат даты и времени ISO 8601 ("ГГГГ-ММ-DDThh:мм:ssZ", см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
Пользовательские свойства этой сущности. Максимальная допустимая длина ключа составляет 64 символов, максимальная допустимая длина — 256 символов, а число разрешенных записей — 10. |
dataset |
EntityReference |
|
description |
string |
Описание объекта. |
displayName |
string minLength: 1 |
Отображаемое имя объекта. |
lastActionDateTime |
string (date-time) |
Метка времени при вводе текущего состояния. Метка времени закодирована как формат даты и времени ISO 8601 ("ГГГГ-ММ-DDThh:мм:ssZ", см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
EvaluationLinks |
|
locale |
string minLength: 1 |
Языковой стандарт содержащихся данных. |
model1 |
EntityReference |
|
model2 |
EntityReference |
|
project |
EntityReference |
|
properties |
EvaluationProperties |
|
self |
string (uri) |
Расположение этой сущности. |
status |
Состояние |
|
transcription1 |
EntityReference |
|
transcription2 |
EntityReference |
EvaluationLinks
EvaluationLinks
Имя | Тип | Описание |
---|---|---|
files |
string (uri) |
Расположение для получения всех файлов этой сущности. Дополнительные сведения см. в операции "Evaluations_ListFiles". |
EvaluationProperties
EvaluationProperties
Имя | Тип | Описание |
---|---|---|
correctTokenCount1 |
integer (int32) |
Количество правильно распознанных маркеров по модели1. |
correctTokenCount2 |
integer (int32) |
Количество правильно распознанных маркеров по модели2. |
correctWordCount1 |
integer (int32) |
Число правильно распознанных слов по модели1. |
correctWordCount2 |
integer (int32) |
Число правильно распознанных слов по модели2. |
string |
Адрес электронной почты для отправки уведомлений по электронной почте в случае завершения операции. Значение будет удалено после успешной отправки сообщения электронной почты. |
|
error |
EntityError |
|
sentenceCount1 |
integer (int32) |
Количество обработанных предложений по модели1. |
sentenceCount2 |
integer (int32) |
Количество обработанных предложений по модели2. |
sentenceErrorRate1 |
number (double) |
Частота ошибок предложения при распознавании с моделью 1. |
sentenceErrorRate2 |
number (double) |
Частота ошибок предложения при распознавании с моделью 2. |
tokenCount1 |
integer (int32) |
Количество обработанных маркеров по модели1. |
tokenCount2 |
integer (int32) |
Количество обработанных маркеров по модели2. |
tokenDeletionCount1 |
integer (int32) |
Число распознанных маркеров по модели1, которые являются удалениями. |
tokenDeletionCount2 |
integer (int32) |
Число распознанных маркеров по модели2, которые являются удалениями. |
tokenErrorRate1 |
number (double) |
Частота ошибок маркера распознавания с моделью 1. |
tokenErrorRate2 |
number (double) |
Частота ошибок маркера распознавания с моделью 2. |
tokenInsertionCount1 |
integer (int32) |
Число распознанных маркеров по модели1, которые являются вставками. |
tokenInsertionCount2 |
integer (int32) |
Количество распознанных маркеров по модели2, которые являются вставками. |
tokenSubstitutionCount1 |
integer (int32) |
Число распознанных маркеров по модели1, которые являются подстановками. |
tokenSubstitutionCount2 |
integer (int32) |
Число распознанных маркеров по модели2, которые являются подстановками. |
wordCount1 |
integer (int32) |
Количество обработанных слов по модели1. |
wordCount2 |
integer (int32) |
Количество обработанных слов по модели2. |
wordDeletionCount1 |
integer (int32) |
Число распознанных слов по модели1, которые являются удалениями. |
wordDeletionCount2 |
integer (int32) |
Число распознанных слов по модели2, которые являются удалениями. |
wordErrorRate1 |
number (double) |
Скорость распознавания слов с моделью 1. |
wordErrorRate2 |
number (double) |
Скорость распознавания слов с моделью 2. |
wordInsertionCount1 |
integer (int32) |
Число распознанных слов по модели1, которые являются вставками. |
wordInsertionCount2 |
integer (int32) |
Число распознанных слов по модели2, которые являются вставками. |
wordSubstitutionCount1 |
integer (int32) |
Число распознанных слов по модели1, которые являются подстановками. |
wordSubstitutionCount2 |
integer (int32) |
Число распознанных слов по модели2, которые являются подстановками. |
InnerError
InnerError
Имя | Тип | Описание |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Дополнительные сведения о поддержке ошибок и (или) ожидаемых политик. |
innerError |
InnerError |
|
message |
string |
Сообщение об ошибке высокого уровня. |
target |
string |
Источник ошибки. Например, это будет "документы" или "идентификатор документа" в случае недопустимого документа. |
Status
Состояние
Значение | Описание |
---|---|
Failed |
Сбой длительной операции. |
NotStarted |
Долго выполняющаяся операция еще не запущена. |
Running |
В настоящее время выполняется длительная операция. |
Succeeded |
Долго выполняющаяся операция успешно завершена. |