接口介绍
MetadataClient 提供以下团队管理接口，用于创建、查询、更新、删除和列出团队资源。团队是 Memory 实例中的组织单元，用于管理 Agent、Task 和用户的归属关系。
create_team：创建新团队。
get_team：按团队 ID 查询团队详细信息。
update_team：更新团队名称等属性。
delete_teams：批量删除团队。
list_teams：列出指定用户所属的全部团队。
导入
from tencentdb_agent_memory.v3 import MetadataClient
方法签名
def create_team(self, p: Dict[str, Any]) -> Dict[str, Any]
def get_team(self, team_id: str) -> Dict[str, Any]
def update_team(self, p: Dict[str, Any]) -> Dict[str, Any]
def delete_teams(self, team_ids: List[str]) -> Dict[str, Any]
def list_teams(self,user_id_or_request: Union[str, Dict[str, Any], None] = None,*,pagination: Optional[Dict[str, Any]] = None,) -> Dict[str, Any]
使用示例
create_team
from tencentdb_agent_memory.v3 import MetadataClientmetadata = MetadataClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",)resp = metadata.create_team({"name": "Platform Team", # 必填，团队名称"description": "平台团队", # 可选，团队描述})print(resp)
get_team
resp = metadata.get_team("team-abc")print(resp)
update_team
resp = metadata.update_team({"team_id": "team-abc","name": "New Platform Team",})print(resp)
delete_teams
resp = metadata.delete_teams(["team-abc"])print(resp)
list_teams
resp = metadata.list_teams("user-123")for team in resp["items"]:print(team["name"])
请求参数
create_team
参数名 | 类型 | 必填 | 描述说明 |
name | str | 是 | 团队名称 |
get_team
参数名 | 类型 | 必填 | 描述说明 |
team_id | str | 是 | 团队 ID |
update_team
参数名 | 类型 | 必填 | 描述说明 |
team_id | str | 是 | 待更新的团队 ID |
name | str | 否 | 更新后的团队名称 |
delete_teams
参数名 | 类型 | 必填 | 描述说明 |
team_ids | List[str] | 是 | 待删除的团队 ID 列表 |
list_teams
参数名 | 类型 | 必填 | 描述说明 |
user_id | str | 是 | 用户 ID，查询该用户所属的全部团队 |
响应示例
create_team
{"team_id": "team-550e8400-e29b-41d4-a716-446655440000","name": "Platform Team","created_at_ms": 1723968000000}
get_team
{"team_id": "team-abc","name": "Platform Team","created_at_ms": 1723900000000,"updated_at_ms": 1723968000000}
list_teams
{"items": [{"team_id": "team-abc","name": "Platform Team","created_at_ms": 1723900000000}]}
响应参数说明
参数名 | 类型 | 参数含义 |
team_id | str | 团队唯一标识 ID |
name | str | 团队名称 |
created_at_ms | int | 创建时间，Unix 时间戳，单位为毫秒 |
updated_at_ms | int | 最后更新时间，Unix 时间戳，单位为毫秒 |
items | List[Dict] | 团队列表 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | 请求参数不合法（如 name 为空） | 检查参数是否符合约束条件 |
401 | API Key 无效或缺失 | 检查 Bearer Token 配置 |
404 | 指定团队不存在 | 确认团队 ID 是否正确 |
409 | 团队名称已存在 | 使用不同的团队名称 |
500 | 服务内部错误 | 稍后重试 |
