Policy - Update

服务:

Azure AI Services

API 版本:

v1.1-preview.1

更新策略。
更新个性化体验创建服务将用于训练模型的学习设置。

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/policy

URI 参数

名称	在	必需	类型	说明
Endpoint	path	True	string	支持的认知服务终结点。

请求正文

名称	必需	类型	说明
arguments	True	string maxLength: 1024	学习设置的参数。
name	True	string maxLength: 256	学习设置的名称。

响应

名称	类型	说明
200 OK	PolicyContract	成功
Other Status Codes	ErrorResponse	策略配置无效。

示例

Successful Policy_Update request

示例请求

HTTP

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/policy

{
  "name": "myPersonalizer",
  "arguments": "--cb_explore_adf --epsilon 0.2 --dsjson --cb_type ips -l 0.5 --l1 1E-07 --power_t 0.5"
}

示例响应

状态代码:

200

{
  "name": "myPersonalizer",
  "arguments": "--cb_explore_adf --epsilon 0.2 --dsjson --cb_type ips -l 0.5 --l1 1E-07 --power_t 0.5"
}

定义

名称	说明
ErrorResponse	用于向客户端返回错误
InternalError	包含比父对象有关错误的更具体信息的对象。
PersonalizerError	错误对象。
PersonalizerErrorCode	个性化体验创建服务返回的错误代码
PolicyContract	指定如何训练模型的学习设置。

ErrorResponse

Object

用于向客户端返回错误

名称	类型	说明
error	PersonalizerError	错误对象。

InternalError

Object

包含比父对象有关错误的更具体信息的对象。

名称	类型	说明
code	string	详细的错误代码。
innererror	InternalError	包含比父对象有关错误的更具体信息的对象。

PersonalizerError

Object

错误对象。

名称	类型	说明
code	PersonalizerErrorCode	个性化体验创建服务返回的错误代码
details	PersonalizerError[]	导致此报告错误的特定错误的详细信息数组。
innerError	InternalError	包含比父对象有关错误的更具体信息的对象。
message	string	说明服务报告的错误的消息。
target	string	错误源元素。

PersonalizerErrorCode

枚举

个性化体验创建服务返回的错误代码

值	说明
ApprenticeModeNeverTurnedOn	学徒模式从未打开。
BadRequest	服务器无法理解请求。
DuplicateCustomPolicyNames	自定义策略名称应是唯一的。
EvaluationModelNotFound	评估中未找到模型。
EvaluationNotFound	找不到脱机评估。
FrontEndNotFound	找不到前端。
InternalServerError	服务器上发生了一般错误。
InvalidContainer	SAS URI 必须是具有写入权限的容器的 URI。
InvalidEvaluationContract	计算协定无效。
InvalidEventIdToActivate	激活事件请求无效。
InvalidExportLogsRequest	请求无效。
InvalidLearningModeServiceConfiguration	将学习模式从联机模式更改为学徒模式时，更新 defaultReward、rewardWaitTime 和 rewardAggregation，反之亦然。 进行模式更改，然后使用其他 API 调用更改其他设置。
InvalidModelMetadata	模型元数据无效。
InvalidMultiSlotApiAccess	多槽功能当前处于禁用状态。 请按照多槽个性化体验创建服务文档更新循环设置以启用多槽功能。
InvalidPolicyConfiguration	策略配置无效。
InvalidPolicyContract	策略协定无效。
InvalidRankRequest	请求无效。
InvalidRewardRequest	奖励请求无效。
InvalidRewardWaitTime	奖励等待时间应介于 5 秒到 2 天之间
InvalidServiceConfiguration	服务配置无效。
LearningSettingsNotFound	评估中未找到学习设置。
LogsPropertiesNotFound	找不到日志属性。
LogsSizeExceedAllowedLimit	日志的总大小超出了允许的限制。
MissingAppId	标头中缺少 AppId。
ModelFileAccessDenied	无法访问用于客户托管密钥的密钥保管库密钥。
ModelMetadataUpdateFailed	模型元数据更新失败。
ModelPublishFailed	模型发布失败。
ModelRankingError	使用模型对作进行排名时出错。 请验证学习设置是否有效。
ModelResetFailed	模型重置失败。
NoLogsExistInDateRange	日期范围内不存在日志。
OperationNotAllowed	目前不允许此作。
ProblemTypeIncompatibleWithAutoOptimization	自动优化与多槽个性化不兼容。
RankNullResponse	排名调用返回 null 响应。
ResourceNotFound	服务器上不存在请求的资源。
UpdateConfigurationFailed	无法更新配置。

PolicyContract

Object

指定如何训练模型的学习设置。

名称	类型	说明
arguments	string maxLength: 1024	学习设置的参数。
name	string maxLength: 256	学习设置的名称。