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