接口介绍
Metadata 团队管理接口用于创建、查询、更新、删除和列出团队资源。团队是 Memory 实例中的组织单元，用于管理 Agent、Task 和用户的归属关系。共5个接口：
接口 | 方法 | 功能 |
/v3/team/create | POST | 创建团队 |
/v3/team/get | POST | 获取团队信息 |
/v3/team/update | POST | 更新团队 |
/v3/team/delete | POST | 批量删除团队 |
/v3/team/list | POST | 列出团队 |
创建团队
创建一个新团队。
POST /v3/team/create
请求参数
字段 | 类型 | 必选 | 说明 |
name | string | 是 | 团队名称 |
description | string | 否 | 团队描述 |
请求示例
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/team/create \\-d '{"name":"Platform Team","description":"平台团队"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"team_id":"team-abc","name":"Platform Team","created_at_ms":1758096000000}}
响应 data
字段 | 类型 | 说明 |
team_id | string | 新创建的团队唯一标识 ID |
name | string | 团队名称 |
created_at_ms | int | 创建时间 |
获取团队信息
按团队 ID 查询团队详细信息。
POST /v3/team/get
请求参数
字段 | 类型 | 必选 | 说明 |
team_id | string | 是 | 团队 ID |
请求示例
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/team/get \\-d '{"team_id":"team-abc"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"team_id":"team-abc","name":"Platform Team","created_at_ms":1758096000000,"updated_at_ms":1758182400000}}
响应 data
字段 | 类型 | 说明 |
team_id | string | 团队 ID |
name | string | 团队名称 |
created_at_ms | int | 创建时间 |
updated_at_ms | int | 最后更新时间 |
更新团队
更新团队名称等属性。
POST /v3/team/update
请求参数
字段 | 类型 | 必选 | 说明 |
team_id | string | 是 | 待更新的团队 ID |
name | string | 否 | 更新后的团队名称 |
请求示例
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/team/update \\-d '{"team_id":"team-abc","name":"New Platform Team"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"team_id":"team-abc","updated_at_ms":1758268800000}}
响应 data
字段 | 类型 | 说明 |
team_id | string | 已更新的团队 ID |
updated_at_ms | int | 最后更新时间 |
批量删除团队
批量删除指定团队。
POST /v3/team/delete
请求参数
字段 | 类型 | 必选 | 说明 |
team_ids | string[] | 是 | 待删除的团队 ID 列表 |
请求示例
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/team/delete \\-d '{"team_ids":["team-abc"]}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"deleted":true}}
响应 data
字段 | 类型 | 说明 |
deleted | bool | 删除是否成功 |
列出团队
列出指定用户所属的全部团队。
POST /v3/team/list
请求参数
字段 | 类型 | 必选 | 说明 |
user_id | string | 是 | 用户 ID |
limit | int | 否 | 每页返回数量 |
offset | int | 否 | 分页偏移量 |
请求示例
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/team/list \\-d '{"user_id":"user-123"}'
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"items":[{"team_id":"team-abc","name":"Platform Team","created_at_ms":1758096000000},{"team_id":"team-def","name":"Data Team","created_at_ms":1758182400000}]}}
响应 data
字段 | 类型 | 说明 |
items | array | 团队列表 |
items[].team_id | string | 团队 ID |
items[].name | string | 团队名称 |
items[].created_at_ms | int | 创建时间 |
错误码
HTTP 状态码 | 错误信息 | 说明 |
400 | request: Invalid input | 请求参数不合法。 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
| Missing x-tdai-service-id header | 请求头中未携带 x-tdai-service-id。 |
404 | TEAM_NOT_FOUND | 指定团队不存在。 |
409 | TEAM_NAME_ALREADY_EXISTS | 团队名称已存在。 |
500 | Internal error | 服务内部错误，可有限重试。 |