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

Model Evaluations - Get

服务:

Azure AI Services

API 版本:

2023-04-01-preview

获取有关特定模型评估的信息。

返回的状态代码：

• 200：作成功完成。
• 400：请求格式不正确。
• 404：找不到具有指定名称的模型评估。

GET /models/{name}/evaluations/{evaluationName}?api-version=2023-04-01-preview

URI 参数

名称	在	必需	类型	说明
evaluationName	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	要获取的模型评估的名称。
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	要为其获取评估的模型的名称。
api-version	query	True	string	请求的 API 版本。

响应

名称	类型	说明
200 OK	ModelEvaluation	成功
Other Status Codes	ErrorResponse	错误 标头 x-ms-error-code: string

示例

ModelEvaluations_Get

示例请求

HTTP

GET /models/my_model_name/evaluations/my_evaluation_name?api-version=2023-04-01-preview

示例响应

状态代码:

200

{
  "name": "my_evaluation_name",
  "modelName": "my_model_name",
  "createdDateTime": "2023-01-13T20:46:22.127Z",
  "updatedDateTime": "2023-01-13T20:46:22.127Z",
  "status": "notStarted",
  "evaluationParameters": {
    "testDatasetName": "my_test_dataset_name"
  }
}

定义

名称	说明
ErrorResponse	发生错误时返回的响应。
ErrorResponseDetails	错误信息。
ErrorResponseInnerError	详细错误。
ModelEvaluation	描述使用测试集评估模型的准确性的评估运行。
ModelEvaluationParameters	用于指定模型计算方式的参数。
ModelEvaluationState	只读。 评估运行的当前状态。
ModelPerformance	自定义训练模型的性能指标。
ModelTagPerformance	自定义训练模型识别的每个标记的性能指标。

ErrorResponse

Object

发生错误时返回的响应。

名称	类型	说明
error	ErrorResponseDetails	错误信息。

ErrorResponseDetails

Object

错误信息。

名称	类型	说明
code	string	错误代码。
details	ErrorResponseDetails[]	详细错误列表。
innererror	ErrorResponseInnerError	详细错误。
message	string	错误信息。
target	string	错误的目标。

ErrorResponseInnerError

Object

详细错误。

名称	类型	说明
code	string	错误代码。
innererror	ErrorResponseInnerError	详细错误。
message	string	错误信息。

ModelEvaluation

Object

描述使用测试集评估模型的准确性的评估运行。

名称	类型	说明
createdDateTime	string (date-time)	只读。 首次创建评估运行的日期和时间（UTC）。
error	ErrorResponseDetails	错误信息。
evaluationParameters	ModelEvaluationParameters	用于指定模型计算方式的参数。
modelName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	只读。 要评估的模型。
modelPerformance	ModelPerformance	自定义训练模型的性能指标。
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	只读。 用于唯一标识评估运行的名称。
status	ModelEvaluationState	只读。 评估运行的当前状态。
updatedDateTime	string (date-time)	只读。 上次更新评估运行的日期和时间（UTC）。

ModelEvaluationParameters

Object

用于指定模型计算方式的参数。

名称	类型	说明
testDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	用于测试的数据集名称。

ModelEvaluationState

枚举

只读。 评估运行的当前状态。

值	说明
failed
notStarted
running
succeeded

ModelPerformance

Object

自定义训练模型的性能指标。

名称	类型	说明
accuracyTop1	number (double)	只读。 对于多类分类模型。 基本真理类与预测类匹配的测试样本的比例。
accuracyTop5	number (double)	只读。 对于多类分类模型。 基本真理类位于前五个预测类的测试样本的比例。
averagePrecision	number (double)	只读。 它是模型性能的度量值，它汇总了不同置信度阈值的精度和召回率。
calibrationECE	number (double)	只读。 对于多类分类模型。 预期的校准错误。
meanAveragePrecision30	number (double)	只读。 对于对象检测模型。 平均平均精度，阈值为 30%。
meanAveragePrecision50	number (double)	只读。 对于对象检测模型。 平均平均精度，阈值为 50%。
meanAveragePrecision75	number (double)	只读。 对于对象检测模型。 平均平均精度，阈值为 75%。
tagPerformance	<string,  ModelTagPerformance>	只读。 模型识别的每个标记的性能指标。

ModelTagPerformance

Object

自定义训练模型识别的每个标记的性能指标。

名称	类型	说明
accuracy	number (double)	只读。 对于多类模型。 标记准确性。
averagePrecision50	number (double)	只读。 对于对象检测模型。 阈值为 50%的平均精度。