一、接口介绍
·检索文本：通过 query 传入要匹配的内容（必填）。
·返回数量：通过 limit 指定 Top-K 上限，不传时默认返回 5 条。
·预过滤窗：通过 session_id 限定会话，time_start / time_end 限定时间窗（含端点），用于召回前缩小检索范围；与 POST /conversation/query 同形。
注意：说明：
注意：本函数采用语义搜索（向量检索）机制进行相关性召回。其核心运行行为如下：
二、Method 与 URL
POST https://{服务访问地址}/v2/conversation/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/conversation/search \\ -d '{ "query": "日本旅游推荐路线", "limit": 5, "session_id": "session-trip-202604", "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 | 是 | – | 检索文本 / 关键词。用户输入的查询语句，系统将基于此文本进行语义匹配或关键词检索。长度限制：[1, 2048]，即上限 2 KB。 |
| limit | int | 否 | 5 | 最大返回结果数（Top-K）。取值范围：[1, 100]。说明：若不传或传 None，服务端默认返回相关性最高的 5 条记录。 |
| session_id | str | 否 | – | 会话限定过滤器。传入特定会话 ID 后，检索范围将仅局限于该会话内的关联内容；不传则在全量数据中检索。 |
| time_start | str | 否 | – | 时间窗起点（包含该时刻）。格式要求：ISO 8601 格式，例如："2026-05-25T10:00:00Z"。作用：用于过滤该时间点之后产生的数据。 |
| time_end | str | 否 | – | 时间窗终点（包含该时刻）。格式要求：ISO 8601 格式。与 time_start 配合可锁定一个历史时间段进行精确检索。 |
五、响应示例
{ "code": 0, "message": "ok", "request_id": "req-7fd3b2dd", "data": { "messages": [ { "id": "msg-aaaa", "role": "user", "content": "我打算 5 月份去日本旅游 7 天，预算 1.5 万元，请帮我推荐路线。", "timestamp": "2026-04-20T10:00:00Z", "score": 0.92 }, { "id": "msg-bbbb", "role": "assistant", "content": "建议关西线路：大阪 – 京都 – 奈良，5 月气候宜人，预算充足。", "timestamp": "2026-04-20T10:00:05Z", "score": 0.81 } ] }}
| 字段名 | 类型 | 说明 |
| data.messages | List | 命中的消息列表。排序规则：列表内的消息默认按相关性评分（score）由高到低（倒序）排列。数据结构：每条消息包含以下完整字段：id (str): 消息的唯一主键 ID。role (str): 发送者角色，可选值为 "user"、"assistant" 或 "system"。content (str): 命中的消息具体文本内容。timestamp (str): 消息产生的 ISO 8601 格式时间戳。score (float): 语义相关性置信度评分。仅在当前检索请求内有效，跨请求不可直接对比。 |