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

追加原始对话消息

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

我的收藏

本页目录：

接口介绍

本接口（/v3/conversation/add）用于向 Memory 实例追加一批原始对话消息（L0），在请求体的 messages 数组中单次提交一条或多条消息。写入规则如下：
会话归属：通过 session_id 将消息归属到指定会话。不传时服务端使用固定取值 default，不会自动生成临时会话；同一次请求的 messages 归属同一个 session_id。
作用域归属：通过 team_id / user_id / agent_id / task_id 四个身份维度将消息归属到指定作用域，抽取出的记忆会沉淀到对应的团队/用户/Agent/任务下。这四个维度均可选填，未传入时记忆抽取仍会在后台执行（归属到各维度的默认作用域下）。
写入数量：messages 数组单次最少 1 条、最多 100 条，且归属同一个 session_id。
后台处理：消息受理后，系统在后台自动执行记忆抽取，逐步沉淀为 L1 原子记忆、L2 场景记忆和 L3 核心记忆；沉淀结果不在本接口响应中返回，可通过对应层级的查询或检索接口观测。

Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/conversation/add

使用示例

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/add \\
  -d '{
    "team_id":"team-abc123",
    "user_id":"usr-456",
    "agent_id":"agt-xyz789",
    "session_id":"agent-main:sess-001",
    "messages":[
      {
        "role":"user",
        "content":"帮我查一下上周的会议纪要",
        "timestamp":"2026-07-22T10:00:00Z"
      },
      {
        "role":"assistant",
        "content":"好的，根据记忆，上周你参加了产品评审和团队周会两次会议...",
        "timestamp":"2026-07-22T10:00:05Z"
      }
    ]
  }'

请求参数

参数
是否必选
参数含义
配置方法及要求
team_id
否
团队 ID。
数据类型：String。
user_id
否
用户 ID。
数据类型：String。
agent_id
否
Agent ID（全局唯一）。
数据类型：String。
session_id
否
会话唯一标识 ID。
数据类型：String。
若未指定，服务端将统一使用固定值 default（不自动生成临时会话），单次请求内的所有 messages 共享同一个 session_id。
messages
是
本次写入的对话消息列表。
数据类型：Array；
数量限制：单次请求最少 1 条，最多支持 100 条。
数据结构：每条消息为 JSON 对象，具体信息，请参见 messages 元素字段说明。

messages 元素字段说明

参数
是否必选
参数含义
配置方法及要求
role
是
对话发言角色。
数据类型：String。
取值范围：user（用户发言）、assistant（AI 回复）。
content
是
消息文本内容。
数据类型：String。
长度限制：[1, 8192]，即单条上限 8 KB。
timestamp
否
消息发生时间。
数据类型：String。
格式：ISO 8601（例如 2026-07-22T10:00:00Z）。
缺省取服务端接收时刻。

响应示例

{
  "code":0,
  "message":"ok",
  "request_id":"req-7fd3b2dd",
  "data":{
    "accepted_ids":["msg-aaaa","msg-bbbb"],
    "accepted_versions":["v1","v1"],
    "total_count":2
  }
}
说明：
同步响应仅回执本接口受理结果（accepted_ids、accepted_versions 与 total_count）。系统会异步沉淀更高层的记忆条目，沉淀结果不在本接口的响应中返回，可通过对应层级的查询或检索接口观测。

响应参数说明

参数名（一级）
参数名（二级）
参数含义
data
accepted_ids
系统为本次写入的每条消息分配的主键 ID，顺序与请求 messages 数组一一对应。
accepted_versions
每条已受理消息的初始版本号，顺序与请求 messages 数组一一对应。
total_count
本次受理消息总数。

中国站