查询 Session

最近更新时间:2025-09-12 21:41:51

我的收藏

接口定义

本接口query_sessions()用于获取与特定 Memory 和用户关联的所有 Session 列表。
def query_sessions(
memory_id: str | None = None,
actor_id: str | None = None,
order_by: Dict[str, int] | None = None,
limit: int | None = None,
offset: int | None = None
) -> Dict[str, Any]

使用示例

import json
from tdaimemory import MemoryClient

sessions = client.query_sessions(
order_by={"created_at": -1},
limit=3,
offset=0
)
print(json.dumps(sessions, ensure_ascii=False))

入参描述

参数
是否必选
参数含义
配置方法及要求
memory_id
指定查询 Session 需关联的记忆库 ID。
登录 Memory 智能体控制台,可在 Memory 服务概览页面复制 Memory ID。具体可以参见 查看 Memory
actor_id
指定查询 Session 的用户 ID。
数据类型:String
长度限制:[1,20]
字符规则:任意字符
order_by
指定返回的 Session 的排序方式。
支持如下两种方式。
-1:降序。默认按照 Session 的创建时间降序排列。
1:升序。
limit
指定返回的会话数量。
数据类型:int,正整数。
取值范围:1~100。
默认值:10。
offset
指定返回结果列表的起始偏移量。
数据类型:int,正整数。
默认值:0,表示从数据集的第一条记录开始返回。
示例:offset=20 表示跳过前20条记录,从第21条开始返回。

出参描述

{
"sessions": [
{
"created_at": 1757407397,
"session_id": "session-1WNJ****",
"session_name": "Travel_Consultation",
"updated_at": 1757407397
}
],
"total_count": 1
}
参数名
参数含义
seesions
列出满足查询条件的所有 Session。
session_id:Session 的唯一标识 ID。
session_name:Session 的会话名称。
created_at:Session 的创建时间。
updated_at:Session 的最后一次更新时间。
total_count
满足查询条件的 Session 数量。