CreateSkillDraft - 创建 Skill 草稿
在指定工作空间中创建 Skill，并生成可继续编辑的草稿版本。可以基于已有版本派生草稿，也可以指定目标版本和提交说明。
接口说明
请求说明
在指定工作空间中创建 Skill，并生成可继续编辑的草稿版本。可以基于已有版本派生草稿，也可以指定目标版本和提交说明。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
agentcore:CreateSkillDraft |
create |
*Skill
|
无 | 无 |
请求语法
POST /workspaces/{workspaceId}/skills HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspaceId |
string |
是 |
工作空间 ID |
550e8400-e29b-41d4-a716-446655440000 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体 |
|
| basedOnVersion |
string |
否 |
基于此版本 fork，不填则创建新 Skill |
0.0.1 |
| commitMsg |
string |
否 |
提交说明 |
初始版本 |
| skillCard |
string |
否 |
Skill 卡片 JSON 字符串，包含完整 Skill 信息 |
{"name":"customer-service-skill","description":"..."} |
| skillName |
string |
是 |
Skill 名称 |
customer-service-skill |
| targetVersion |
string |
否 |
指定草稿版本号，不填则自动递增 |
0.0.2 |
调用“创建 Skill 草稿”接口时，请按参数定义传入：工作空间 ID、请求体。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
RestResult |
||
| data |
string |
返回数据。 |
skill-1234567890abcdef |
| requestId |
string |
请求 ID。 |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
“创建 Skill 草稿”接口的响应包含：请求 ID、返回数据。
示例
正常返回示例
JSON格式
{
"data": "skill-1234567890abcdef",
"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 | ResourceAlreadyExist | Resource already exists: %s. | 指定的资源已存在 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。