方法介绍
get 用于按 Skill ID 查询 Skill 的详细信息。功能说明如下：版本查询：支持按版本号查询历史版本，不传
version 则返回最新版本。内容控制：通过
include_content 控制是否返回 Skill 内容字段，仅需元数据时可设为 False 以提高性能。文件清单：通过
include_manifest 控制是否返回资源文件清单。导入
from tencentdb_agent_memory.v3 import SkillClient
方法签名
def get(self,skill_id: str,*,version: Optional[int] = None,include_content: Optional[bool] = None,include_manifest: Optional[bool] = None,team_id: Optional[str] = None,agent_id: Optional[str] = None,user_id: Optional[str] = None,task_id: Optional[str] = None,) -> Dict[str, Any]
使用示例
from tencentdb_agent_memory.v3 import SkillClientwith SkillClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:# 查询最新版本result = client.get("skill-abc123") # 必填，Skill IDprint(result["name"], result["content"])# 查询指定版本result = client.get("skill-abc123", version=3) # 可选，指定版本号# 仅查询元数据，不返回 contentresult = client.get("skill-abc123", include_content=False) # 可选，默认 True
请求参数
参数名 | 类型 | 必填 | 描述说明 |
skill_id | str | 是 | Skill ID |
version | int | 否 | 指定版本号，不传则返回最新版本 |
include_content | bool | 否 | 是否返回 content 字段，默认 True |
include_manifest | bool | 否 | 是否返回文件清单，默认 False |
team_id | str | 否 | 团队 ID，覆盖构造时的默认值 |
agent_id | str | 否 | Agent ID，覆盖构造时的默认值 |
user_id | str | 否 | 用户 ID，覆盖构造时的默认值 |
task_id | str | 否 | Task ID，覆盖构造时的默认值 |
响应示例
{"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"}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
skill_id | str | Skill ID |
name | str | Skill 名称 |
content | str | Skill 内容（ include_content=False 时不返回） |
version | int | 当前版本号 |
metadata | Dict | 自定义元数据 |
manifest | List[str] | 文件清单（ include_manifest=True 时返回） |
created_at | str | 创建时间 |
updated_at | str | 最后更新时间 |
错误码
错误码 | 触发场景 | 处理建议 |
404 | Skill 不存在 | 检查 skill_id 是否正确 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填参数 |
500 | 服务内部错误 | 可有限重试 |
