接口介绍
本接口（/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-test-001","session_id": "session-PTVM****","strategy": ["旅游关注维度"],"content": "美食维度","order_by": {"created_at": -1},"limit": 5,"offset": 0}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
memory_id | 是 | 指定搜索 Record 所关联的 Memory ID。 | |
actor_id | 是 | 指定搜索 Record 用户的唯一标识 ID。 | 数据类型：String 长度限制：[1,20] 字符规则：任意字符 |
session_id | 是 | 指定搜索 Record 的 Session ID。 | |
content | 是 | 指定搜索的关键词，用于匹配记录内容。 | 字符串类型，例如：用户偏好。 |
strategy | 是 | 指定 Record 策略类型。 | 数据类型为 String 数组。默认支持如下策略，可自定义其他策略： Semantic Strategy：语义信息。 Summary Strategy：事实总结。 User Preference Strategy：用户偏好。 |
where | 是 | 指定查询条件的对象，通过键值对指定字段的匹配规则，返回满足指定条件的事件。 说明： 当前仅支持使用 record_id、created_at、updated_at 字段设置查询条件。 | 支持使用的操作符。 比较操作符：$eq（等于，默认可省略）、$ne（不等于）、$gt（大于）、$gte（大于等于）、$lt（小于）、$lte（小于等于）。 集合操作符：$in（包含在数组中）、$nin（不包含在数组中） 查询条件设置示例。
|
order_by | 否 | 指定返回的 Record 的排序方式。 | 支持如下两种方式。 -1：降序。默认按照 Record 的创建时间降序排列。 1：升序。 |
limit | 否 | 指定返回的 Record 数量。 | 数据类型：int，正整数。 取值范围：1～100。 默认值：10。 |
offset | 否 | 指定返回结果列表的起始偏移量。 | 数据类型：int，正整数。 取值范围：[0,∞]。 默认值：0，表示从数据集的第一条记录开始返回。 示例：offset=20表示跳过前20条记录，从第21条开始返回。 |
响应消息
执行成功，输出如下信息。
{"code": 0,"message": "","data": {"records": [{"created_at": 1757384676,"event_ids": ["event-Ej9s****"],"record_content": "用户对美食有浓厚的兴趣","record_id": "record-ChV****D","score": 0.65423244,"strategy_name": "User Perference Strategy","updated_at": 1757384676},{"created_at": 1757384695,"event_ids": ["event-Ej9s****"],"record_content": "用户喜欢人少、安静的地方，对美食特别感兴趣。","record_id": "record-uJ4t****","score": 0.5492037,"strategy_name": "Semantic Strategy","updated_at": 1757384695},{"created_at": 1757384730,"event_ids": ["event-Ej9s****"],"record_content": "在2023年的杭州，在旅游方面，[++]对美食特别感兴趣。","record_id": "record-Drsz****","score": 0.5148556,"strategy_name": "旅游关注维度","updated_at": 1757384730},{"created_at": 1757384698,"event_ids": ["event-Ej9s****"],"record_content": "用户对花生严重过敏，预订餐厅时需特别注意。","record_id": "record-Z3ro****","score": 0.47972357,"strategy_name": "Semantic Strategy","updated_at": 1757384698},{"created_at": 1757384693,"event_ids": ["event-Ej9s****"],"record_content": "用户计划下周去杭州进行为期3天的旅行。","record_id": "record-RCMU****","score": 0.45423132,"strategy_name": "Semantic Strategy","updated_at": 1757384693}],"total_count": 5}}
参数名 | 子参数（一级） | 子参数（二级） | 参数含义 |
data | records | record_id | 长期记忆 ID，唯一标识该记录的标识符。 |
| | record_content | 记录内容，描述 Record 记忆的实际信息。 |
| | strategy_name | 生成该记录的策略名称，例如：User_Preference_Strategy、Semantic_Strategy 等。 |
| | created_at | Record 创建时间。 |
| | updated_at | Record 最后一次更新时间。 |
| | score | 相关性得分。 |
| total_count | - | 符合查询条件的总 Record 数量。 |
