帮你快速理解、总结文档立即下载
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>开发者参考>V3 版本>HTTP>原始对话>语义检索原始对话消息

语义检索原始对话消息

最近更新时间：2026-07-28 10:20:01

我的收藏

本页目录：

接口介绍

本接口（/v3/conversation/search）用于对 L0 原始对话消息执行语义检索。功能说明如下：
检索方式：基于 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]，值越高越相关。

中国站