一、接口介绍
·检索方式：基于 query 文本进行智能检索，结合语义理解与关键词匹配，返回带相关性评分（score）的消息列表，score 越高表示与查询文本的相关性越强。
·过滤条件：支持按会话（session_id）过滤以缩小检索范围。time_start / time_end 参数当前已可传入但检索时暂未生效，传时间范围不会影响检索结果。
·返回数量：单次最多返回 100 条结果，默认返回 5 条。
二、Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/conversation/search
三、使用示例
curl -i -k -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/conversation/search \\ -d '{ "team_id":"team-abc123", "user_id":"usr-456", "agent_id":"agt-xyz789", "query":"上周会议纪要", "limit":5, "session_id":"agent-main:sess-001" }'
四、请求参数
| 参数 | 是否必选 | 参数含义 | 配置方法及要求 |
| team_id | 否 | 团队 ID。 | 数据类型：String。 |
| user_id | 否 | 用户 ID。 | 数据类型：String。 |
| agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
| task_id | 否 | Task ID。 | 数据类型：String。 |
| query | 是 | 检索关键词或短语。 | 数据类型：String。长度限制：[1, 2048]。 |
| limit | 否 | 返回的最大命中条数。 | 数据类型：Integer。取值范围：[1, 100]。默认值：5。 |
| session_id | 否 | 会话 ID，用于限定检索范围。 | 数据类型：String。 |
| time_start | 否 | 检索时间范围起点（暂未生效）。 | 数据类型：String。格式：ISO 8601（如 2026-07-01T00:00:00Z）。当前可传入但检索时暂未使用，传时间范围不会影响检索结果。 |
| time_end | 否 | 检索时间范围终点（暂未生效）。 | 数据类型：String。格式：ISO 8601（如 2026-07-22T23:59:59Z）。当前可传入但检索时暂未使用，传时间范围不会影响检索结果。 |
五、响应示例
{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "messages":[ { "id":"msg-bbbb", "version":"v1", "role":"assistant", "content":"好的，根据记忆，上周你参加了产品评审和团队周会两次会议…", "timestamp":"2026-07-22T10:00:05Z", "score":0.95 }, { "id":"msg-aaaa", "version":"v1", "role":"user", "content":"帮我查一下上周的会议纪要", "timestamp":"2026-07-22T10:00:00Z", "score":0.92 } ] }}
六、响应参数说明
| 参数名（一级） | 参数名（二级） | 参数含义 |
| data | messages | 检索命中消息列表，按 score 降序排列。 |
| | messages[].id | 消息唯一 ID。 |
| | messages[].version | 消息当前版本号。 |
| | messages[].role | 消息角色：user 或 assistant。 |
| | messages[].content | 消息内容。 |
| | messages[].timestamp | 消息时间戳，ISO 8601 格式。 |
| | messages[].score | 语义相关度评分，取值范围 [0, 1]，值越高越相关。 |