一、接口介绍
·版本查询：支持按版本号查询历史版本，不传 version 则返回最新版本。
·内容控制：通过 include_content 控制是否返回 Skill 内容字段，仅需元数据时可设为 false。
·文件清单：通过 include_manifest 控制是否返回资源文件清单。
二、Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/get
三、使用示例
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/get \\ -d '{ "skill_id":"skill-abc123", "include_content":true, "include_manifest":false }'
四、Body 参数
| 参数 | 是否必选 | 参数含义 | 配置方法及要求 |
| skill_id | 是 | Skill ID。 | 数据类型：String。 |
| version | 否 | 指定版本号，不传则返回最新版本。 | 数据类型：Integer。 |
| include_content | 否 | 是否返回 content 字段。 | 数据类型：Boolean。默认 true。 |
| include_manifest | 否 | 是否返回文件清单。 | 数据类型：Boolean。默认 false。 |
| 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-ghi789", "data":{ "skill_id":"skill-abc123", "name":"python-tips", "content":"—\\nname: python-tips\\n—\\n# Tips\\n", "version":3, "metadata":{"category":"programming"}, "manifest":["README.md","examples/usage.py"], "created_at":"2026-08-01T10:00:00Z", "updated_at":"2026-08-15T14:30:00Z" }}
六、响应参数说明
| 参数名（一级） | 参数名（二级） | 参数含义 |
| data | skill_id | Skill ID。 |
| | name | Skill 名称。 |
| | content | Skill 内容（include_content=false 时不返回）。 |
| | version | 当前版本号。 |
| | metadata | 自定义元数据。 |
| | manifest | 文件清单（include_manifest=true 时返回）。 |
| | created_at | 创建时间。 |
| | updated_at | 最后更新时间。 |
七、错误码
| HTTP 状态码 | 错误信息 | 说明 |
| 401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
| 404 | SKILL_NOT_FOUND | 指定 Skill 不存在。 |
| 500 | Internal error | 服务内部错误，可有限重试。 |