文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>开发者工具>Python SDK>Record 管理>查询 Record

查询 Record

最近更新时间：2026-01-05 21:02:52

我的收藏

本页目录：

接口定义

本接口query_records()用于查询指定条件下的长期记忆内容。
可根据 Actor ID、Session ID 等一个或多个条件组合，精准定位所需记录。
支持分页查询，可快速分批次获取查询结果，避免数据过载。
def query_records(self,
                  actor_id: Optional[str] = None,
                  session_id: Optional[str] = None,
                  where: Optional[Dict[str, Any]] = None,
                  limit: Optional[int] = None,
                  offset: Optional[int] = None,
                  ) -> Dict[str, Any]:

使用示例

import json

records = client.query_records(
    session_id="session-1c54d41af19343fc",
    # where={"importance": "high"},
    limit=15,
    offset=0
)
print(json.dumps(records, ensure_ascii=False))

入参描述

参数
是否必选
参数含义
配置方法及要求
actor_id
否
指定查询 Record 用户的唯一标识 ID。
数据类型：String。
长度限制：[1,128]。
字符规则：任意字符。
session_id
否
指定查询 Record 的 Session ID。
获取会话 ID，请参见 查询 Session。
where
否
where 指定查询条件，返回完全符合这些规则的事件。
说明：
当前仅支持使用 record_id、created_at、updated_at 字段设置查询条件。
数据类型：Dict。
设置规则：以键值对的形式，定义事件消息体中字段的匹配规则。支持使用的操作符。
比较操作符：$eq（等于，默认可省略）、$ne（不等于）、$gt（大于）、$gte（大于等于）、$lt（小于）、$lte（小于等于）。
集合操作符：$in（包含在数组中）、$nin（不包含在数组中）
如下表示查找 status 字段等于 "ACTIVE" 且 score 字段大于等于80的记录。
{
  "where": {
    "status": "ACTIVE",
    "score": { "$gte": 80 }
  }
}
limit
否
指定返回的 Record 数量。
数据类型：integer，正整数。
取值范围：1～1000。
默认值：10。
offset
否
指定返回结果列表的起始偏移量。
数据类型：integer，正整数。
默认值：0，表示从数据集的第一条记录开始返回。
示例：offset=20表示跳过前20条记录，从第21条开始返回。

出参描述

执行成功，输出如下信息。
{
    "memory_id": "tdai-mem-bp0c****",
    "records": [
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a*******",
            "record_id": "mem_2c33235c********",
            "record_content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。",
            "strategy_name": "episodic",
            "event_id": "event-63fb98fa********",
            "created_at": "2025-12-15T08:29:04.233000",
            "updated_at": "2025-12-15T08:29:04.233000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_0230efad********",
            "record_content": "太好了，酒店要带健身房，另外我对花生严重过敏，预订餐厅时请务必注意。",
            "strategy_name": "episodic",
            "event_id": "event-2855d62a********",
            "created_at": "2025-12-15T08:29:04.152000",
            "updated_at": "2025-12-15T08:29:04.152000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_e607197e********",
            "record_content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。",
            "strategy_name": "episodic",
            "event_id": "event-724c5fe6********",
            "created_at": "2025-12-15T08:29:04.070000",
            "updated_at": "2025-12-15T08:29:04.070000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_9194dbe2********",
            "record_content": "用户选择酒店时要求配备健身房",
            "strategy_name": "persona",
            "event_id": "event-2855d62a********",
            "created_at": "2025-12-15T08:29:03.974000",
            "updated_at": "2025-12-15T08:29:03.974000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_04b4f7c4********",
            "record_content": "用户对花生严重过敏，预订餐厅时需要特别注意避免花生成分",
            "strategy_name": "persona",
            "event_id": "event-2855d62a********",
            "created_at": "2025-12-15T08:29:03.882000",
            "updated_at": "2025-12-15T08:29:03.882000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_a92fd1f5********",
            "record_content": "用户偏好前往人少、安静的地方，并对美食特别感兴趣",
            "strategy_name": "instruction",
            "event_id": "event-4d48e3ab********",
            "created_at": "2025-12-15T08:28:44.247000",
            "updated_at": "2025-12-15T08:28:44.247000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_42a39b8c********",
            "record_content": "我喜欢人少、安静的地方，对美食特别感兴趣。",
            "strategy_name": "episodic",
            "event_id": "event-4d48e3ac********",
            "created_at": "2025-12-15T08:28:44.165000",
            "updated_at": "2025-12-15T08:28:44.165000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_ed3613e3********",
            "record_content": "好的，已为您推荐杭州三日行程。第一天，我们聚焦西湖经典。清晨从断桥残雪出发，漫步白堤，感受水墨画般的湖光山色。随后乘船登岛探访三潭印月，下午登雷峰塔俯瞰全景，傍晚在曲院风荷赏夕阳，晚上则去河坊街夜市品尝地道小吃。\\n\\n第三天，探索湿地与运河文化。上午在西溪湿地乘坐摇橹船，听船娘小调，感受水乡慢生活；下午逛一逛桥西历史街区和文艺的小河直街，参观工艺美术博物馆，在咖啡馆小憩后即可轻松结束旅程，准备返程。\\n\\n第二天，体验禅意与宋韵。上午前往灵隐寺景区祈福，在法喜寺的黄墙拍照打卡；下午沉浸于宋城，体验AR剧本杀并观看《宋城千古情》演出；如果傍晚还有精力，可以去九溪烟树享受清凉的溪水。",
            "strategy_name": "episodic",
            "event_id": "event-0811d41c********",
            "created_at": "2025-12-15T08:28:44.087000",
            "updated_at": "2025-12-15T08:28:44.087000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_df44763c********",
            "record_content": "嗨，帮我规划一个下周去杭州的3天行程。",
            "strategy_name": "episodic",
            "event_id": "event-6deb0d74********",
            "created_at": "2025-12-15T08:28:43.997000",
            "updated_at": "2025-12-15T08:28:43.997000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_72a24002********",
            "record_content": "用户对美食特别感兴趣",
            "strategy_name": "persona",
            "event_id": "event-4d48e3ac********",
            "created_at": "2025-12-15T08:28:43.912000",
            "updated_at": "2025-12-15T08:28:43.912000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_ca3d15f2********",
            "record_content": "用户喜欢人少、安静的地方",
            "strategy_name": "persona",
            "event_id": "event-4d48e3ac********",
            "created_at": "2025-12-15T08:28:43.828000",
            "updated_at": "2025-12-15T08:28:43.828000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_8c9cfe6b********",
            "record_content": "收到！考虑到您女朋友的喜好。这是为您和您女友定制的杭州三日行程：\\n\\n第一天：上午游茅家埠、杨公堤；下午观天目里美术馆现代展览。晚餐于胜利河美食街 品尝安全地道的本帮菜。\\n\\n第二天：上午早访灵隐寺，漫步幽静天竺路。下午重点参观 浙江省博物馆之江馆 重磅国际艺术大展。晚餐体验本地 新丰小吃（已规避风险）。\\n\\n第三天：上午于 西溪湿地乘摇橹船。下午在小河直街 咖啡馆悠闲小憩，结束旅程。",
            "strategy_name": "episodic",
            "event_id": "event-b99185bd********",
            "created_at": "2025-12-15T08:28:14.823000",
            "updated_at": "2025-12-15T08:28:14.823000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_69ba43ce********",
            "record_content": "完美！哦对了，我女朋友更喜欢现代艺术，有什么地方可以推荐吗？",
            "strategy_name": "episodic",
            "event_id": "event-1ce29851********",
            "created_at": "2025-12-15T08:28:14.767000",
            "updated_at": "2025-12-15T08:28:14.767000"
        },
        {
            "actor_id": "user-sdk-test",
            "session_id": "session-1c54d41a********",
            "record_id": "mem_8618618b********",
            "record_content": "用户的女朋友喜欢现代艺术",
            "strategy_name": "persona",
            "event_id": "event-1ce29851********",
            "created_at": "2025-12-15T08:28:14.700000",
            "updated_at": "2025-12-15T08:28:14.700000"
        }
    ],
    "total_count": 14
}
参数（一级）
参数（二级）
参数含义
memory_id
-
记忆 ID。
records
actor_id
用户 ID。
session_id
Session 的唯一标识 ID。
record_id
长期记忆 ID，唯一标识该记录的标识符。
record_content
记录内容，描述 Record 记忆的实际信息。
strategy_name
生成记录的策略名称。默认支持如下策略，可自定义其他策略。
persona：画像记忆。持久化存储用户画像、社交关系与偏好特征，支撑跨会话的个性化服务与身份一致性。
episodic：事件记忆。自动提取并时序化存储用户行为、决策与经历，构建交互编年史。支撑对话里程碑回溯，实现基于历史事实的主动服务。
event_id
事件 ID。
created_at
Record 创建时间。
updated_at
Record 最后一次更新时间。
total_count
-
符合查询条件的总 Record 数量。
中国站
目录