接口介绍
本接口（
/conversation/add）用于将一段原始对话消息写入 Memory。在请求体中通过 session_id 指定会话归属，并在 messages 数组中单次提交一条或多条消息：会话归属：通过
session_id 将消息归属到指定会话；不传 session_id 时由平台自动生成一个临时 session。写入数量：
messages 数组单次最少传 1 条、最多传 100 条消息，归属同一个 session_id。Method 与 URL
POST https://{服务访问地址}/v2/conversation/add
使用示例
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/add \\-d '{"session_id": "session-trip-202604","messages": [{"role": "user","content": "我打算 5 月份去日本旅游 7 天，预算 1.5 万元，请帮我推荐路线。","timestamp": "2026-04-20T10:00:00Z"},{"role": "assistant","content": "建议关西线路：大阪 - 京都 - 奈良，5 月气候宜人，预算充足。","timestamp": "2026-04-20T10:00:05Z"}]}'
说明：
鉴权说明：所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
session_id | 是 | 会话唯一标识 ID。 | 数据类型：String。 |
messages | 是 | 本次写入的对话消息列表 | 数据类型：Array； 数量限制：单次请求最少 1 条，最多支持 100 条。 数据结构：每条消息为 JSON 对象，具体信息，请参见messages 元素字段说明。 |
messages 元素字段说明
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
role | 是 | 对话发言角色 | 数据类型：String。 取值范围： user（用户发言）、assistant（AI 回复）。 |
content | 是 | 消息文本内容 | 数据类型：String。 长度限制：[1, 8192]，即单条上限 8 KB。 |
timestamp | 否 | 消息发生时间 | 数据类型：String。 格式：ISO 8601（例如 2026-04-20T10:00:00Z）。缺省取服务端接收时刻。 |
响应示例
说明：
同步响应仅回执本接口受理结果（
accepted_ids 与 total_count）。系统会异步沉淀更高层的记忆条目，沉淀结果不在本接口的响应中返回，可通过对应层级的查询或检索接口观测。{"code": 0,"message": "ok","request_id": "req-7fd3b2dd","data": {"accepted_ids": ["msg-aaaa", "msg-bbbb"],"total_count": 2}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | accepted_ids | 系统为本次写入的每条消息分配的主键 ID，顺序与请求 messages 数组一一对应。 |
| total_count | 本次受理消息总数。 |
