腾讯云数据库 AI 服务 add

接口介绍
将一段原始对话消息写入 Memory。传入会话 ID 与消息数组，单次最少传 1 条、最多传 100 条消息，归属同一个 session_id：
会话归属：通过 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 后重试或上报。
﻿

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

add_conversation — 追加原始对话消息

本页目录：

接口介绍

使用示例

请求参数

返回信息

错误处理

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

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

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