接口介绍
本接口（
/atom/search）用于在原子记忆中做语义检索。传入检索文本，并按需附加预过滤条件，即可拿到按相关度排序的 Top-K 命中结果：检索文本：通过
query 传入要匹配的内容（必填）。返回数量：通过
limit 指定 Top-K 上限，不传时默认返回 5 条。预过滤窗：通过
type 限定记忆类型（episodic（事实）/ persona（偏好）/ instruction（指令）），time_start / time_end 按 updated_at 限定时间窗，用于召回前缩小检索范围；与 POST /atom/query 同形。说明：
检索为 Top-K 召回语义，不提供
offset/total，单次返回不超过limit条。每项额外回带score字段，按score 倒序排列；score 跨请求不保证可比。Method 与 URL
POST https://{服务访问地址}/v2/atom/search
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer ******************************' \\-H "x-tdai-service-id: mem-8i8t****" \\https://memory.tdai.tencentyun.com/v2/atom/search \\-d '{"query": "用户旅游偏好","limit": 5,"type": "persona","time_start": "2026-04-01T00:00:00Z","time_end": "2026-04-30T23:59:59Z"}'
说明：
鉴权说明：所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。请求参数
参数名 | 类型 | 必填 | 默认值 | 描述说明 |
query | str | 是 | - | 检索文本 / 关键词。用户输入的查询语句，系统将基于此文本在记忆库中进行语义匹配。 |
limit | int | 否 | 5 | 最大返回结果数（Top-K）。 说明： 若不传或传 None，服务端默认返回相关性最高的 5 条记忆记录。 |
type | str | 否 | - | 原子记忆类型过滤器。传入后仅在指定类型的记忆中进行检索；不传则在所有记忆中全局检索。可选值包括： "episodic"：事实类记忆（如用户说过的经历、发生过的事）。 "persona"：偏好类记忆（如用户的习惯、人设、喜好）。 "instruction"：指令类记忆（如用户对 AI 下达的长期行为规范）。 |
time_start | str | 否 | - | 更新时间筛选起点（包含该时刻）。 筛选依据：基于记忆的最后更新时间（updated_at）。 格式要求：ISO 8601 格式，例如："2026-05-25T10:00:00Z"。 |
time_end | str | 否 | - | 更新时间筛选终点（包含该时刻）。 格式要求：ISO 8601 格式。 与 time_start 配合组成闭区间时间窗，用于限定检索该时间段内更新过的记忆。 |
响应示例
{"code": 0,"message": "ok","request_id": "req-7fd3b2dd","data": {"items": [{"id": "note-3a7b9c1d","type": "persona","content": "用户偏好关西线路，5 月出行，预算 1.5 万元。","created_at": "2026-04-20T10:05:30Z","updated_at": "2026-04-21T08:30:15Z","score": 0.94},{"id": "note-4e8d2f60","type": "persona","content": "用户偏好深度文化体验，避免过于密集的行程。","created_at": "2026-04-20T10:08:12Z","updated_at": "2026-04-20T10:08:12Z","score": 0.85}]}}
字段名 | 类型 | 说明 |
data.items | List | 命中的原子记忆列表。 排序规则：列表内的条目默认已**按相关性评分（score）由高到低（倒序）**排列。 数据结构：每条记忆包含以下完整字段： id (str): 原子记忆的唯一主键 ID。 type (str): 记忆类型（例如 "persona" 代表用户画像/偏好标签）。 content (str): 命中的原子记忆具体文本内容。 created_at (str): 该条记忆的首次创建时间戳（ISO 8601 格式）。 updated_at (str): 该条记忆的最后修改时间戳（ISO 8601 格式）。 score (float): 语义相关性置信度评分。仅在当前检索请求内有效，跨请求（不同 Query 之间）不可直接对比。 |
