创建 Agent 私有 Skill

可以通过该接口，创建当前 Agent API Key 所属 LoopAgent 的私有 Skill。

仅支持 LoopAgent；普通 Agent、Flow Agent 和 Workflow 不支持。
仅创建当前 Agent API Key 所属 Agent 的私有 Skill。
仅接受 .skill、.zip；压缩包最大 20 MiB，最多 200 个有效文件，单文件解压后最大 5 MiB，整包解压后最大 64 MiB。
包内根目录或唯一顶层目录下必须包含 SKILL.md，且 frontmatter 必须包含 name。
创建不会自动把 Skill 挂载到 Agent，也不会自动保存或发布 Agent 版本。

请求方式

POST

调用地址

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

调用验证

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

请求

请求示例

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

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

此代码块在浮窗中显示

请求头

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

请求参数（Form Data）

参数	类型	必填	说明
`file`	File	是	`.skill` 或 `.zip` 技能包。
`category_id`	String	否	Skill 分类 ID；不传时创建为空分类。

响应

响应示例

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

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

此代码块在浮窗中显示

成功响应

字段	类型	说明
skill_id	String	新建 Skill ID。
name	String	Skill 名称。
version	String	Skill 版本号。

失败响应

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

状态码

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