腾讯云数据库 AI 服务 add_conversation — 追加原始对话消息

一、接口介绍

·会话归属：通过 session_id 将本次写入的消息归属到指定会话。

·消息内容：通过 messages 数组传入消息列表，每条消息包含 role / content / timestamp 三个字段。

项	值
HTTP 方法与路径	POST /v2/conversation/add
HTTP 文档	追加原始对话消息
函数签名	add_conversation(session_id, messages)

二、使用示例

result = client.add_conversation( session_id="sess-trip-202604", messages=[ {"role": "user", "content": "我打算 5 月去日本…"}, {"role": "assistant", "content": "建议关西线路…"}, ],)print(result["accepted_ids"]) # ["msg-aaaa", "msg-bbbb"]

注意：说明：

注意：client 实例的构造方式参见新建客户端；异步调用时将方法前加 await 即可。

三、请求参数

参数名	类型	必填	描述说明
session_id	str	是	会话唯一标识 ID。
messages	List[Dict]	是	上下文消息列表。数量限制：单次请求最少 1 条，最多支持 100 条。数据结构：每条消息为 JSON 对象，包含以下字段：role (string): 角色类型，可选值为 "user"、"assistant" 或 "system"。content (string): 消息的具体文本内容。timestamp (string): 时间戳（选填）。若缺省，则由服务端自动生成并打戳。

四、返回信息

返回字典包含本次受理结果与请求追踪 ID：

注意：说明：

注意：同步响应仅回执本接口受理结果（accepted_ids 与 total_count）。系统会异步沉淀更高层的记忆条目，沉淀结果不在本接口的响应中返回，可通过对应层级的查询或检索接口观测。

{ "accepted_ids": ["msg-aaaa", "msg-bbbb"], "total_count": 2, "trace_id": "tr-xxxxxxxx-xxxxxxxx"}

字段	类型	说明
accepted_ids	List[str]	系统为本次写入的每条消息分配的主键 ID，顺序与请求 messages 数组一一对应。
total_count	int	本次受理的消息条数。
trace_id	str	请求追踪 ID（来自响应头 x-trace-id）。

五、错误处理

错误码	触发场景	处理建议
400	messages 为空数组、超过 100 条、role 取值非法。	请校验入参后重试。
429	写入触发限流。	退避重试。
500	服务端错误。	记录 trace_id 后重试或上报。