方法介绍
list 用于按过滤条件分页查询 Skill 列表。功能说明如下：过滤条件：支持按
team_id、agent_id、name 等字段筛选 Skill。分页查询：通过
pagination 参数控制每页数量（limit）和偏移量（offset）。返回结构：返回符合条件的 Skill 列表及总数。
导入
from tencentdb_agent_memory.v3 import SkillClient
方法签名
def list(self,*,filters: Optional[Dict[str, Any]] = None,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.list(filters={"team_id": "team-abc123"}, # 可选，过滤条件pagination={"limit": 20, "offset": 0}, # 可选，分页参数)for skill in result["items"]:print(f"{skill['name']} v{skill['version']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
filters | Dict | 否 | 过滤条件，支持按 team_id、agent_id、name 等字段筛选 |
pagination | Dict | 否 | 分页参数，含 limit（每页数量）和 offset（偏移量） |
team_id | str | 否 | 团队 ID，覆盖构造时的默认值 |
agent_id | str | 否 | Agent ID，覆盖构造时的默认值 |
user_id | str | 否 | 用户 ID，覆盖构造时的默认值 |
task_id | str | 否 | Task ID，覆盖构造时的默认值 |
响应示例
{"items": [{"skill_id": "skill-abc123","name": "python-tips","version": 3,"created_at": "2026-08-01T10:00:00Z","updated_at": "2026-08-15T14:30:00Z"}],"total": 42}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
items | List[Dict] | Skill 列表 |
items[].skill_id | str | Skill ID |
items[].name | str | Skill 名称 |
items[].version | int | 当前版本号 |
items[].created_at | str | 创建时间 |
items[].updated_at | str | 最后更新时间 |
total | int | 符合条件的总数 |
错误码
错误码 | 触发场景 | 处理建议 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填参数 |
500 | 服务内部错误 | 可有限重试 |
