方法介绍
versions 用于查看 Skill 的历史变更记录。功能说明如下：版本列表：返回指定 Skill 的全部历史版本信息，按版本号降序排列。
变更类型：每条记录包含变更类型（如
created、content_update、file_added），便于追踪修改历史。分页查询：支持通过
pagination 参数分页获取历史版本。导入
from tencentdb_agent_memory.v3 import SkillClient
方法签名
def versions(self,skill_id: str,*,pagination: Optional[Dict[str, Any]] = 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.versions(skill_id="skill-abc123", # 必填，Skill IDpagination={"limit": 10, "offset": 0}, # 可选，分页参数)for v in result["items"]:print(f"v{v['version']}: {v['created_at']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
skill_id | str | 是 | Skill ID |
pagination | Dict | 否 | 分页参数，含 limit（每页数量）和 offset（偏移量） |
team_id | str | 否 | 团队 ID，覆盖构造时的默认值 |
agent_id | str | 否 | Agent ID，覆盖构造时的默认值 |
user_id | str | 否 | 用户 ID，覆盖构造时的默认值 |
task_id | str | 否 | Task ID，覆盖构造时的默认值 |
响应示例
{"items": [{"version": 3,"created_at": "2026-08-15T14:30:00Z","change_type": "content_update"},{"version": 2,"created_at": "2026-08-10T09:00:00Z","change_type": "file_added"},{"version": 1,"created_at": "2026-08-01T10:00:00Z","change_type": "created"}],"total": 3}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
items | List[Dict] | 版本列表，按版本号降序排列 |
items[].version | int | 版本号 |
items[].created_at | str | 该版本创建时间 |
items[].change_type | str | 变更类型 |
total | int | 总版本数 |
错误码
错误码 | 触发场景 | 处理建议 |
404 | Skill 不存在 | 检查 skill_id 是否正确 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
500 | 服务内部错误 | 可有限重试 |
