接口定义
本接口
query_sessions()用于根据指定条件查询会话列表。def query_sessions(self,actor_id: Optional[str] = None,session_id: Optional[str] = None,limit: Optional[int] = None,offset: Optional[int] = None,) -> Dict[str, Any]:
使用示例
import jsonsessions = client.query_sessions(actor_id="user-sdk-test",limit=3,offset=0)print(json.dumps(sessions, ensure_ascii=False))
入参描述
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
actor_id | 否 | 指定查询 Session 的用户 ID，以根据 Actor ID 过滤 Session。 | 数据类型：String 长度限制：[1,128] 字符规则：任意字符 |
session_id | 否 | 指定需查看的 Session ID。 | 为所创建的 Session 自动分配的具有唯一标识的 ID，通过 Session ID 查询 Session。 |
limit | 否 | 指定返回的最大会话数量。 | 数据类型：Integer，正整数。 取值范围：1～1000。 默认值：10。 |
offset | 否 | 指定返回结果列表的起始偏移量。 | 数据类型：Integer，正整数。 默认值：0，表示从数据集的第一条记录开始返回。 示例：offset=20 表示跳过前20条记录，从第21条开始返回。 |
出参描述
{"memory_id": "tdai-mem-bp0c****","sessions": [{"session_id": "session-ab13a89e********","memory_id": "tdai-mem-bp0c****","actor_id": "user-sdk-test","name": "Travel_Consultation","created_at": "2025-12-15T14:33:46.501243","updated_at": "2025-12-15T14:33:46.501243"}],"total_count": 1}
参数名（一级） | 参数名（二级） | 参数含义 |
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 数量。 |
