接口定义
本接口
search_sessions()提供基于关键词模糊搜索会话名称。def search_sessions(self,query: str,actor_id: Optional[str] = None,limit: Optional[int] = None,offset: Optional[int] = None,) -> Dict[str, Any]:
使用示例
import jsonsearch_result = client.search_sessions(query="Travel",limit=2,)print(json.dumps(search_result, ensure_ascii=False))
入参描述
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
actor_id | 否 | 指定查询 Session 的用户 ID。 | 数据类型：String。 长度限制：[1,128]。 字符规则：任意字符。 |
query | 是 | 指定搜索的关键词。 | 数据类型：String。 限制：当前仅支持使用 Session Name 中包含的关键词搜索。 |
limit | 否 | 返回的最大会话数量。 | 数据类型：Integer。 默认值：3 取值范围：[1,1000]。 |
offset | 否 | 指定返回结果列表的起始偏移量。 | 数据类型：Integer，正整数。 默认值：0，表示从数据集的第一条记录开始返回。 示例：offset=20 表示跳过前20条记录，从第21条开始返回。 |
出参描述
执行成功，输出如下信息。
{"memory_id": "tdai-mem-bp0c****","sessions": [{"actor_id": "user-sdk-test","session_id": "session-ab13a89e********","session_name": "Travel_Consultation_update","created_at": "2025-12-15T14:33:46.501243","updated_at": "2025-12-15T15:00:03.151124"},{"actor_id": "actor-1","session_id": "session-96b22c66********","session_name": "Travel_Consultation_update","created_at": "2025-12-14T19:02:07.034377","updated_at": "2025-12-14T19:02:07.962080"}],"total_count": 2}
参数名（一级） | 参数名（二级） | 参数含义 |
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 数量。 |
