一、接口介绍
·即时可用：创建后 Skill 即处于可用状态，可通过 listing 和 search 被 Agent 发现。
·内容格式：推荐使用 YAML frontmatter 格式编写 Skill 内容。
·资源文件：支持通过 resources 参数附加资源文件（代码示例、配置文件等）。
·自定义元数据：通过 metadata 参数存储分类、标签等自定义信息。
二、Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/create
三、使用示例
curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/skill/create \\ -d '{ "name":"python-tips", "content":"—\\nname: python-tips\\ndescription: Python coding tips\\n—\\n# Tips\\n", "metadata":{"category":"programming"} }'
四、Body 参数
| 参数 | 是否必选 | 参数含义 | 配置方法及要求 |
| name | 是 | Skill 名称。 | 数据类型：String。 |
| content | 是 | Skill 内容，推荐使用 YAML frontmatter 格式。 | 数据类型：String。 |
| resources | 否 | 附加资源文件列表。 | 数据类型：Array of Object。每个元素含 path、content、mime_type、encoding 字段。 |
| metadata | 否 | 自定义元数据。 | 数据类型：Object。 |
| team_id | 否 | 团队 ID。 | 数据类型：String。 |
| agent_id | 否 | Agent ID。 | 数据类型：String。 |
| user_id | 否 | 用户 ID，覆盖鉴权凭证中的默认值。 | 数据类型：String。 |
| task_id | 否 | Task ID，覆盖鉴权凭证中的默认值。 | 数据类型：String。 |
五、响应示例
{ "code":0, "message":"ok", "request_id":"req-stu901", "data":{ "skill_id":"skill-abc123", "version":1 }}
六、响应参数说明
| 参数名（一级） | 参数名（二级） | 参数含义 |
| data | skill_id | 新创建的 Skill ID。 |
| | version | 初始版本号，固定为 1。 |
七、错误码
| HTTP 状态码 | 错误信息 | 说明 |
| 400 | request: Invalid input | 请求参数不合法，如 name 或 content 为空。 |
| 401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
| 409 | SKILL_ALREADY_EXISTS | 同名 Skill 已存在。 |
| 500 | Internal error | 服务内部错误，可有限重试。 |