文档中心

AgentKit

请输入

Skill

UpdateSkill - 更新Skill

更新一个Skill。

使用说明

请确认Skill.md ZIP文件满足如下要求，否则会创建异常：

解压后需要有且仅有一个文件夹，且与Skill名称一致。

{skill_name}文件夹中，SKILL.md在根目录下。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：UpdateSkill

要执行的操作，取值：UpdateSkill。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

Id string 必选示例值：s-yed19lc8ow54****

Skill ID。

Name string 可选示例值：name1

填写TOS Skill.md ZIP文件中的Skill名称。取值：

最多64个字符。

只能包含小写字母、数字和连字符（-）。

不能包含XML标签。

不能包含保留字：agentkit。

说明

不传入则默认根据SKILL.md文件解析，传入则根据SKILL.md进行一致性检查。

Description string 可选示例值：description1

填写TOS Skill.md ZIP文件中的Skill名称。取值：

最多1024个字符。

不能包含XML标签。

说明

不传入则默认根据SKILL.md文件解析，传入则根据SKILL.md进行一致性检查。

TosUrl string 必选示例值：https://agentkit-platform.tos-cn-beijing.volces.com/uploads//.zip

Skill.md ZIP文件在TOS中的地址。格式为https://${桶名}.${TOS 域名}/${object 完整路径}。

说明

允许使用TOS的公网地址或私网地址，即https://agentkit-platform.tos-cn-beijing.volces.com/****或https://agentkit-platform.tos-cn-beijing.ivolces.com/****。

SkillSpaces string[] 可选示例值：ss-yed0d8u1ogo2****

加入的Skill空间。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST https://agentkit.cn-beijing.volcengineapi.com?Action=UpdateSkill&Version=2025-10-30 HTTP/1.1​
{​
  "Id": "s-yed19lc8ow54****",​
  "Name": "name1",​
  "Description": "description1",​
  "TosUrl": "https://agentkit-platform.tos-cn-beijing.volces.com/uploads/****/****.zip",​
  "SkillSpaces": [​
    "ss-yed0d8u1ogo2****"​
  ],​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2026010618380711206000****",​
    "Action": "UpdateSkill",​
    "Version": "2025-10-30",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.01.28 15:04:17

这个页面对您有帮助吗？

有用

无用