接口介绍
本接口（/memory/v1/record/search）用于根据关键词语义与策略类型检索相关的长期记忆。
Method 与 URL
POST https://{服务访问地址}/memory/v1/record/search使用示例
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/search \\-d '{"memory_id": "tdai-mem-8i8t****","actor_id": "user-service-test","query": "美食","type": "episodic"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 是 | 指定搜索 Record 所关联的 Memory ID。 | |
actor_id | 否 | 指定查询 Record 用户的唯一标识 ID。 | 数据类型：String。 长度限制：[1,128]。 字符规则：任意字符。 |
session_id | 否 | 指定查询 Record 的 Session ID。 | |
query | 否 | 指定搜索的关键词，用于匹配记录内容。 | 数据类型：String。 长度限制：无。 字符规则：任意字符。 |
type | 否 | 指定 Record 策略类型。 | 数据类型：String。 默认采用以下 persona 和 episodic 策略配置。 说明： 若不配置该参数，默认启用"全选"，召回所有策略类型的 Record。 persona：画像记忆。持久化存储用户画像、社交关系与偏好特征，支撑跨会话的个性化服务与身份一致性。 episodic：事件记忆。自动提取并时序化存储用户行为、决策与经历，构建交互编年史。支撑对话里程碑回溯，实现基于历史事实的主动服务。 支持用户自定义其他策略方案。登录 Memory 智能体控制台，在 Memory 详情页面的长期记忆策略区域，复制自定义的策略。具体信息，请参见 查看 Memory。 |
limit | 否 | 指定返回的 Record 数量。 | 数据类型：integer，正整数。 取值范围：1～100。 默认值：10。 |
enable_rerank | 否 | 指定是否启用 LLM 重排序。 | 数据类型：Boolean。 取值范围：true（启用）、false（不启用）。 默认值：true。 |
响应消息
执行成功，输出如下信息。
{"code": 0,"message": "success","data": {"records": [{"record_id": "mem_7141ab18********","record_content": "基于您喜欢安静和美食的偏好，我为您优化了行程，避开了团队游客扎堆的景点，专注于幽静的体验和地道的风味。\\n\\n第一天：避世西湖\\n清晨漫步杨公堤与茅家埠，享受静谧湖景。午餐在老字号「奎元馆」吃虾爆鳝面。下午乘船访三潭印月，傍晚在湖边茶社小坐。晚餐去本地人爱的胜利河美食街尝地道风味。\\n\\n第二天：禅意之路\\n一早探灵隐寺，然后沿幽静天竺路步行至法喜寺。午餐在「知竹」吃素面。下午深入云栖竹径看竹海。晚餐用「新丰小吃」的喉口馒头等市井味道收尾。\\n\\n第三天：水乡慢生活\\n全天在西溪湿地坐摇橹船，深入芦苇荡享受宁静。午后往文艺的小河直街，在运河畔的咖啡馆小坐休憩，结束旅程。","type": "episodic","updated_time": "","activity_start_time": "2025-12-01T00:00:00Z","activity_end_time": "2025-12-03T23:59:59Z","scene_name": "我（AI）在和用户做杭州三日游行程规划，包含住宿与饮食安排","event_id": "event-3255fd3a********"}],"total_count": 1}}
参数名 | 子参数（一级） | 子参数（二级） | 参数含义 |
data | records | record_id | 长期记忆 ID，唯一标识该记录的标识符。 |
| | actor_id | Session 中所包含的一个或多个用户 ID。 |
| | session_id | Session 的唯一标识 ID。 |
| | record_content | 记录内容，描述 Record 记忆的实际信息。 |
| | type | Record 策略类型。默认支持如下策略，可自定义其他策略。 persona：画像记忆。持久化存储用户画像、社交关系与偏好特征，支撑跨会话的个性化服务与身份一致性。 episodic：事件记忆。自动提取并时序化存储用户行为、决策与经历，构建交互编年史。支撑对话里程碑回溯，实现基于历史事实的主动服务。 |
| | activity_start_time | 活动/事件的开始时间，表示与记录内容相关活动开始的时间戳。 |
| | activity_end_time | 活动/事件的结束时间，表示与记录内容相关活动结束的时间戳。 |
| | updated_time | Record 最后一次更新时间。 |
| | scene_name | 情境概述，补充记忆抽取时的背景。 |
| | event_id | 生成 Record 的事件 ID。 |
| total_count | - | 符合查询条件的总 Record 数量。 |
