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

查询 Record

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

我的收藏

本页目录：

接口介绍

本接口（/memory/v1/record/query）用于查询指定条件下的长期记忆。
支持根据 Memory ID、Actor ID、Session ID 等一个或多个条件组合，精准定位所需记录。
支持分页查询，可快速分批次获取查询结果，避免数据过载。

Method 与 URL

POST https://{服务访问地址}/memory/v1/record/query

使用示例

curl -i -k -X POST \\
  -H 'Content-Type: application/json' \\
  -H 'Authorization: Bearer ******************************' \\
  -H "x-tdai-service-id: tdai-mem-8i8t****" \\
  https://memory.tdai.tencentyun.com/memory/v1/record/query \\
  -d '{
    "memory_id": "tdai-mem-8i8t****",
    "limit": 3,
    "offset": 0
}'

请求参数

参数
是否必选
参数含义
配置方法及要求
memory_id
是
指定查询 Record 所关联的 Memory ID。
登录 Memory 智能体控制台 可复制 Memory ID。具体信息，参见 查看 Memory 详情。
actor_id
否
指定查询 Record 用户的唯一标识 ID。
数据类型：String。
长度限制：[1,128]。
字符规则：任意字符。
session_id
否
指定查询 Record 的 Session ID。
获取 Session ID，请参见 查询 Session。
where
否
where 指定查询条件，返回完全符合这些规则的事件。
说明：
当前仅支持使用 record_id、created_at、updated_at 字段设置查询条件。
数据类型：Object。
设置规则：以键值对的形式，定义事件消息体中字段的匹配规则。支持使用的操作符。
比较操作符：$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条开始返回。

响应消息

执行成功，输出如下信息。
{
  "code": 0,
  "message": "success",
  "data": {
    "memory_id": "tdai-mem-n0jm****",
    "records": [
      {
        "actor_id": "user-service-test",
        "session_id": "session-7fd3b2dd********",
        "record_id": "mem_c3e6154d********",
        "record_content": "用户要求所推荐的酒店必须配备健身房",
        "strategy_name": "instruction",
        "event_id": "event-8b4fe7c5********",
        "created_at": "2025-12-19T08:25:36.472000",
        "updated_at": "2025-12-19T09:32:11.791000"
      },
      {
        "actor_id": "user-service-test",
        "session_id": "session-7fd3b2dd********",
        "record_id": "mem_a816046c********",
        "record_content": "用户要求AI在规划行程时必须确保所有餐饮不含花生成分，因其对花生严重过敏",
        "strategy_name": "instruction",
        "event_id": "event-8b4fe7c5********",
        "created_at": "",
        "updated_at": "2025-12-19T09:32:11.704000"
      },
      {
        "actor_id": "user-service-test",
        "session_id": "session-7fd3b2dd********",
        "record_id": "mem_1ddf4606********",
        "record_content": "好的，已完全了解您的需求（偏好安静人少、喜爱美食、酒店需带健身房、对花生严重过敏）。为您精选的酒店（带健身房）：\\n\\n西湖庐驿精品酒店：位于西湖区，设计静谧，配备健身房，且远离闹市，符合您对安静的需求。\\n\\n杭州西溪紫金港希尔顿逸林酒店：靠近西溪湿地，设施完善，健身房专业，适合在第三天安排湿地行程时入住。",
        "strategy_name": "episodic",
        "event_id": "event-3378f7c2********",
        "created_at": "2025-12-19T09:32:11.618000",
        "updated_at": "2025-12-19T09:32:11.618000"
      }
    ],
    "total_count": 3
  }
}
参数名（一级）
参数名（二级）
参数名（三级）
参数含义
data
memory_id
-
记忆 ID。

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 数量。
中国站
目录