接口定义
本接口
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 jsonfrom tdaimemory import MemoryClientsessions = client.query_sessions(order_by={"created_at": -1},limit=3,offset=0)print(json.dumps(sessions, ensure_ascii=False))
入参描述
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 否 | 指定查询 Session 需关联的记忆库 ID。 | |
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 数量。 |