OnlineSkill - 上线 Skill-智能体构建和治理平台 AgentCore-阿里云帮助中心

接口说明

将指定 Skill 版本设置为在线版本。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:OnlineSkill

update

*Skill

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/skill/{#skillName}

无

POST /workspaces/{workspaceId}/skills/{skillName}/actions/online HTTP/1.1

名称	类型	必填	描述	示例值
body	object	否	请求体
scope	string	否	操作范围：skill（整个 Skill）或 version（指定版本）	version
skillVersion	string	否	Skill 版本号	0.0.1

调用“上线 Skill”接口时，请按参数定义传入：工作空间 ID、Skill 名称、请求体。

“上线 Skill”接口的响应包含：请求 ID。

正常返回示例

JSON格式

{
  "requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678"
}

HTTP status code	错误码	错误信息	描述
400	IllegalRequest	Illegal request: %s.	非法请求
400	InvalidParameter	Parameter error: %s.	参数错误
400	InvalidParameter.ImportFileSize	The import file size exceeds the allowed limit: %s.	导入文件大小超过限制
500	InternalError	An internal error occurred. Please try again later.	内部异常，请稍后重试；如持续失败，请提供 RequestId 排查
403	NoPermission	You are not authorized to perform this operation: %s.	无操作权限
404	NotFound	Not found: %s.	指定的工作空间、资源或版本不存在
409	SkillInUse	The Skill is still referenced by an Agent or AgentSpec and cannot be taken offline or disabled until the reference is released.
409	ResourceAlreadyExist	Resource already exists: %s.	指定的资源已存在

访问错误中心查看更多错误码。

更多信息，参考变更详情。