接口介绍
本接口 (/memory/v1/session/query) 用于获取与特定 Memory 和用户关联的所有 Session 列表。
Method 与 URL
POST https://{服务访问地址}/memory/v1/session/query使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer ******************************' \\-H "x-tdai-service-id: tdai-mem-8i8t****" \\https://memory.tdai.tencentyun.com/memory/v1/session/query \\-d '{"memory_id": "tdai-mem-8i8t****","actor_id": "user-service-test"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 是 | 指定查询 Session 需关联的记忆库 ID。 | |
actor_id | 否 | 指定查询 Session 的用户 ID。 | 数据类型：String。 长度限制：[1,128]。 字符规则：任意字符。 |
session_id | 否 | 指定需查看的 Session ID。 | 为所创建的 Session 自动分配的具有唯一标识的 ID，通过 Session ID 查询 Session。 |
limit | 否 | 指定返回的最大会话数量。 | 数据类型：Integer，正整数。 取值范围：1～1000。 默认值：10。 |
offset | 否 | 指定返回结果列表的起始偏移量。 | 数据类型：Integer，正整数。 默认值：0，表示从数据集的第一条记录开始返回。 示例：offset=20表示跳过前20条记录，从第21条开始返回。 |
响应消息
执行成功，输出如下信息。
{"code": 0,"message": "success","data": {"memory_id": "tdai-mem-n0jm****","sessions": [{"session_id": "session-7fd3b2dd********","memory_id": "tdai-mem-n0jm91jd","actor_id": "user-service-test","name": "Travel_Consultation","created_at": "2025-12-19T15:52:00.662249","updated_at": "2025-12-19T15:52:00.662249"}],"total_count": 1}}
参数名（一级） | 参数名（二级） | 参数名（三级） | 参数含义 |
data | memory_id | - | 当前查询的 Memory ID。 |
| session | actor_id | Session 中所包含的一个或多个用户 ID。 |
| | session_id | Session 的唯一标识 ID。 |
| | session_name | Session 的会话名称。 |
| | created_at | Session 的创建时间。 |
| | updated_at | Session 的最后一次更新时间。 |
| total_count | - | 满足查询条件的 Session 数量。 |
