你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Evaluations - Create

创建新评估。

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

URI 参数

名称 必需 类型 说明
endpoint
path True

string

支持的认知服务终结点 (协议和主机名,例如: https://westus.api.cognitive.microsoft.com) 。

请求正文

名称 必需 类型 说明
dataset True

EntityReference

EntityReference

displayName True

string

对象的显示名称。

locale True

string

包含数据的区域设置。

model1 True

EntityReference

EntityReference

model2 True

EntityReference

EntityReference

customProperties

object

此实体的自定义属性。 允许的最大密钥长度为 64 个字符,允许的最大值长度为 256 个字符,允许的条目计数为 10。

description

string

对象的说明。

project

EntityReference

EntityReference

transcription1

EntityReference

EntityReference

transcription2

EntityReference

EntityReference

响应

名称 类型 说明
201 Created

Evaluation

响应包含有关实体作为有效负载及其作为标头的位置的信息。

标头

Location: string

Other Status Codes

Error

出现了错误。

安全性

Ocp-Apim-Subscription-Key

在此处提供认知服务帐户密钥。

类型: apiKey
在: header

Authorization

提供此区域的 STS 返回的 JWT 的访问令牌。 通过将以下查询字符串添加到 STS URL,确保将管理范围添加到令牌:?scope=speechservicesmanagement

类型: apiKey
在: header

示例

Create a evaluation

示例请求

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

示例响应

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

定义

名称 说明
DetailedErrorCode

DetailedErrorCode

EntityError

EntityError

EntityReference

EntityReference

Error

错误

ErrorCode

ErrorCode

Evaluation

计算

EvaluationLinks

EvaluationLinks

EvaluationProperties

EvaluationProperties

InnerError

InnerError

Status

状态

DetailedErrorCode

DetailedErrorCode

名称 类型 说明
DataImportFailed

string

数据导入失败。

DeleteNotAllowed

string

不允许删除。

DeployNotAllowed

string

不允许部署。

DeployingFailedModel

string

部署失败的模型。

EmptyRequest

string

空请求。

EndpointCannotBeDefault

string

终结点不能为默认值。

EndpointNotUpdatable

string

终结点不可更新。

EndpointWithoutLogging

string

没有日志记录的终结点。

ExceededNumberOfRecordingsUris

string

已超出录制 URI 数。

FailedDataset

string

失败的数据集。

Forbidden

string

已禁止。

InUseViolation

string

在使用中冲突。

InaccessibleCustomerStorage

string

无法访问的客户存储。

InvalidAdaptationMapping

string

无效的适应映射。

InvalidBaseModel

string

基本模型无效。

InvalidCallbackUri

string

回调 URI 无效。

InvalidCollection

string

集合无效。

InvalidDataset

string

数据集无效。

InvalidDocument

string

无效的文档。

InvalidDocumentBatch

string

无效的文档批处理。

InvalidLocale

string

区域设置无效。

InvalidLogDate

string

日志日期无效。

InvalidLogEndTime

string

日志结束时间无效。

InvalidLogId

string

日志 ID 无效。

InvalidLogStartTime

string

日志开始时间无效。

InvalidModel

string

无效的模型。

InvalidModelUri

string

无效的模型 URI。

InvalidParameter

string

参数无效。

InvalidParameterValue

string

参数值无效。

InvalidPayload

string

有效负载无效。

InvalidPermissions

string

权限无效。

InvalidPrerequisite

string

先决条件无效。

InvalidProductId

string

产品 ID 无效。

InvalidProject

string

无效的项目。

InvalidProjectKind

string

无效的项目类型。

InvalidRecordingsUri

string

录制 URI 无效。

InvalidRequestBodyFormat

string

请求正文格式无效。

InvalidSasValidityDuration

string

sas 有效性持续时间无效。

InvalidSkipTokenForLogs

string

日志的跳过令牌无效。

InvalidSourceAzureResourceId

string

源 Azure 资源 ID 无效。

InvalidSubscription

string

订阅无效。

InvalidTest

string

测试无效。

InvalidTimeToLive

string

生存时间无效。

InvalidTopForLogs

string

日志顶部无效。

InvalidTranscription

string

听录无效。

InvalidWebHookEventKind

string

Web 挂钩事件类型无效。

MissingInputRecords

string

缺少输入记录。

ModelCopyOperationExists

string

模型复制操作存在。

ModelDeploymentNotCompleteState

string

模型部署未完成状态。

ModelDeprecated

string

模型已弃用。

ModelExists

string

模型存在。

ModelMismatch

string

模型不匹配。

ModelNotDeployable

string

模型不可部署。

ModelVersionIncorrect

string

模型版本不正确。

NoUtf8WithBom

string

没有带有 bom 的 utf8。

OnlyOneOfUrlsOrContainerOrDataset

string

只有一个 URL 或容器或数据集。

ProjectGenderMismatch

string

项目性别不匹配。

QuotaViolation

string

配额冲突。

SingleDefaultEndpoint

string

单个默认终结点。

SkuLimitsExist

string

存在 SKU 限制。

SubscriptionNotFound

string

找不到订阅。

UnexpectedError

string

意外错误。

UnsupportedClassBasedAdaptation

string

不支持的基于类的适应。

UnsupportedDelta

string

不支持的增量。

UnsupportedDynamicConfiguration

string

不支持的动态配置。

UnsupportedFilter

string

不支持的筛选器。

UnsupportedLanguageCode

string

不支持的语言代码。

UnsupportedOrderBy

string

不支持的订单依据。

UnsupportedPagination

string

不支持的分页。

UnsupportedTimeRange

string

不支持的时间范围。

EntityError

EntityError

名称 类型 说明
code

string

此错误的代码。

message

string

此错误的消息。

EntityReference

EntityReference

名称 类型 说明
self

string

被引用实体的位置。

Error

错误

名称 类型 说明
code

ErrorCode

ErrorCode
高级错误代码。

details

Error[]

有关错误和/或预期策略的其他支持性详细信息。

innerError

InnerError

InnerError
新的内部错误格式,符合认知服务 API 指南,可从 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。 这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息(键值对)、内部错误(可以嵌套)。

message

string

高级别错误消息。

target

string

错误的源。 例如,如果文档无效,应为“文档”或“文档 ID”。

ErrorCode

ErrorCode

名称 类型 说明
Conflict

string

表示冲突错误代码。

Forbidden

string

表示禁止的错误代码。

InternalCommunicationFailed

string

表示内部通信失败的错误代码。

InternalServerError

string

表示内部服务器错误代码。

InvalidArgument

string

表示无效参数错误代码。

InvalidRequest

string

表示无效请求错误代码。

NotAllowed

string

表示不允许的错误代码。

NotFound

string

表示“找不到”错误代码。

PipelineError

string

表示管道错误代码。

ServiceUnavailable

string

表示服务不可用错误代码。

TooManyRequests

string

表示请求过多错误代码。

Unauthorized

string

表示未经授权的错误代码。

UnprocessableEntity

string

表示不可处理的实体错误代码。

UnsupportedMediaType

string

表示不受支持的媒体类型错误代码。

Evaluation

计算

名称 类型 说明
createdDateTime

string

创建对象时的时间戳。 时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh:mm: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

对象的显示名称。

lastActionDateTime

string

输入当前状态时的时间戳。 时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh:mm:ssZ”,请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。

links

EvaluationLinks

EvaluationLinks

locale

string

包含数据的区域设置。

model1

EntityReference

EntityReference

model2

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

EvaluationProperties

EvaluationProperties

self

string

此实体的位置。

status

Status

状态
描述 API 的当前状态

transcription1

EntityReference

EntityReference

transcription2

EntityReference

EntityReference

EvaluationLinks

名称 类型 说明
files

string

获取此实体的所有文件的位置。 有关更多详细信息,请参阅操作“Evaluations_ListFiles”。

EvaluationProperties

EvaluationProperties

名称 类型 说明
correctTokenCount1

integer

model1 正确识别的标记数。

correctTokenCount2

integer

model2 正确识别的令牌数。

correctWordCount1

integer

model1 正确识别的单词数。

correctWordCount2

integer

model2 正确识别的单词数。

email

string

要向其发送电子邮件通知的电子邮件地址,以防操作完成。 成功发送电子邮件后,将删除该值。

error

EntityError

EntityError

sentenceCount1

integer

model1 处理的句子数。

sentenceCount2

integer

model2 处理的句子数。

sentenceErrorRate1

number

model1 识别的句子错误率。

sentenceErrorRate2

number

model2 识别的句子错误率。

tokenCount1

integer

model1 处理的令牌数。

tokenCount2

integer

按 model2 计算的已处理令牌数。

tokenDeletionCount1

integer

model1 识别的令牌数,即删除。

tokenDeletionCount2

integer

model2 识别的令牌数,即删除。

tokenErrorRate1

number

model1 识别的标记错误率。

tokenErrorRate2

number

model2 的识别令牌错误率。

tokenInsertionCount1

integer

model1 识别的标记数,即插入。

tokenInsertionCount2

integer

按 model2 识别的标记数,即插入。

tokenSubstitutionCount1

integer

model1 识别的令牌数,即替换项。

tokenSubstitutionCount2

integer

model2 识别的令牌数,即替换项。

wordCount1

integer

model1 的已处理字数。

wordCount2

integer

model2 的已处理字数。

wordDeletionCount1

integer

model1 识别的单词数,即删除。

wordDeletionCount2

integer

model2 识别的单词数,即删除。

wordErrorRate1

number

model1 识别的单词错误率。

wordErrorRate2

number

model2 识别的单词错误率。

wordInsertionCount1

integer

model1(插入)识别的字词数。

wordInsertionCount2

integer

model2 识别的单词数,即插入。

wordSubstitutionCount1

integer

model1 识别的字词数,即替换项。

wordSubstitutionCount2

integer

model2 识别的单词数,即替换项。

InnerError

InnerError

名称 类型 说明
code

DetailedErrorCode

DetailedErrorCode
详细的错误代码枚举。

details

object

有关错误和/或预期策略的其他支持性详细信息。

innerError

InnerError

InnerError
符合认知服务 API 指南 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow的新内部错误格式,请参阅 。 这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息(键值对)、内部错误(可以嵌套)。

message

string

高级别错误消息。

target

string

错误的源。 例如,如果文档无效,应为“文档”或“文档 ID”。

Status

状态

名称 类型 说明
Failed

string

长时间运行的操作失败。

NotStarted

string

长时间运行的操作尚未启动。

Running

string

长时间运行的操作当前正在处理。

Succeeded

string

长时间运行的操作已成功完成。