一、接口介绍
·会话归属：通过 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 | 本次受理消息总数。 |