更新 Agent 私有 Skill

可以通过该接口，更新当前 LoopAgent API Key 所属 Agent 的私有 Skill。Skill ID 通过 multipart 表单字段 skill_id 传入，不出现在 URL 路径中。

仅支持 LoopAgent，且只能更新当前 Agent API Key 所属 Agent 名下的私有 Skill。
目标查询按 skill_id + projectId + botId 限定，不属于当前 Agent 的 Skill 会被拒绝。
文件格式与创建接口一致：仅接受 .skill、.zip，压缩包最大 20 MiB。
更新只保存 Skill 内容版本，但不会自动挂载 Skill、保存 Agent 草稿版本或发布生产 Agent 版本。

请求方式

POST

调用地址

https://api.${endpoint}/v1/agent/skill/update

调用验证

使用目标 LoopAgent 的 Agent Key，且该 Key 必须开启版本管理权限。详情参见 API 概述的鉴权方式说明。

请求

请求示例

curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \ -H 'Authorization: Bearer ${API Key}' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill'

此代码块在浮窗中显示

请求头

字段	类型	说明
Authorization	Bearer ${API Key}	使用目标 LoopAgent 的 API Key 鉴权，且该 Key 必须开启版本管理权限。
Content-Type	multipart/form-data	以表单形式上传技能包文件。

请求参数（Form Data）

参数	类型	必填	说明
`skill_id`	String	是	要更新的 Agent 私有 Skill ID。
`file`	File	是	`.skill` 或 `.zip` 技能包。
`category_id`	String	否	更新后的分类 ID；可省略，省略时保持原分类。

服务端会比较目标 Skill 的当前文件和元数据；完全一致时直接返回当前版本，不写入对象存储或 MongoDB，调用方也不需要传幂等请求头。

响应

响应示例

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "version": "1.0.2" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "version": "1.0.2"
  }
}

此代码块在浮窗中显示

成功响应

字段	类型	说明
skill_id	String	更新的 Skill ID，保持不变。
name	String	Skill 名称。
version	String	更新后的 Skill 版本号。

失败响应

字段	类型	说明
code	Integer	错误码。
message	String	错误详情。

状态码

状态码	说明
200	成功
400	参数错误
401	未授权
403	权限不足
429	请求过于频繁
500	服务器错误