Поделиться через


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

Evaluation

ХОРОШО

Заголовки

Retry-After: integer

Other Status Codes

Error

Произошла ошибка.

Безопасность

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"
}

Определения

Имя Описание
DetailedErrorCode

DetailedErrorCode

EntityError

EntityError

EntityReference

EntityReference

Error

Ошибка

ErrorCode

Код ошибки

Evaluation

Оценка

EvaluationLinks

EvaluationLinks

EvaluationProperties

EvaluationProperties

InnerError

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

ErrorCode

Код ошибки
Коды ошибок высокого уровня.

details

Error[]

Дополнительные сведения о поддержке ошибок и (или) ожидаемых политик.

innerError

InnerError

InnerError
Новый формат внутренней ошибки, соответствующий рекомендациям ПО API Cognitive Services, который доступен в https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Это содержит обязательные свойства ErrorCode, сообщение и необязательные свойства, сведения (пара значений ключа), внутренняя ошибка (это может быть вложено).

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

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

EvaluationLinks

locale

string

minLength: 1

Языковой стандарт содержащихся данных.

model1

EntityReference

EntityReference

model2

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

EvaluationProperties

EvaluationProperties

self

string (uri)

Расположение этой сущности.

status

Status

Состояние
Описание текущего состояния API

transcription1

EntityReference

EntityReference

transcription2

EntityReference

EntityReference

EvaluationLinks

Имя Тип Описание
files

string (uri)

Расположение для получения всех файлов этой сущности. Дополнительные сведения см. в операции "Evaluations_ListFiles".

EvaluationProperties

EvaluationProperties

Имя Тип Описание
correctTokenCount1

integer (int32)

Количество правильно распознанных маркеров по модели1.

correctTokenCount2

integer (int32)

Количество правильно распознанных маркеров по модели2.

correctWordCount1

integer (int32)

Число правильно распознанных слов по модели1.

correctWordCount2

integer (int32)

Число правильно распознанных слов по модели2.

email

string

Адрес электронной почты для отправки уведомлений по электронной почте в случае завершения операции. Значение будет удалено после успешной отправки сообщения электронной почты.

error

EntityError

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

DetailedErrorCode
Подробный код ошибки перечисления.

details

object

Дополнительные сведения о поддержке ошибок и (или) ожидаемых политик.

innerError

InnerError

InnerError
Новый формат внутренней ошибки, соответствующий рекомендациям ПО API Cognitive Services, который доступен в https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Это содержит обязательные свойства ErrorCode, сообщение и необязательные свойства, сведения (пара значений ключа), внутренняя ошибка (это может быть вложено).

message

string

Сообщение об ошибке высокого уровня.

target

string

Источник ошибки. Например, это будет "документы" или "идентификатор документа" в случае недопустимого документа.

Status

Состояние

Значение Описание
Failed

Сбой длительной операции.

NotStarted

Долго выполняющаяся операция еще не запущена.

Running

В настоящее время выполняется длительная операция.

Succeeded

Долго выполняющаяся операция успешно завершена.