发送对话消息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
rdsai:ChatMessages |
none |
*全部资源
|
无 | 无 |
请求语法
POST /v1/chat-messages HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Query |
string |
是 |
查询内容。 |
实例rm-bp14as9914vd3**** 磁盘使用率，是否需要进行扩容 |
| ConversationId |
string |
否 |
对话 Id。 |
fea7bdca-e848-44dd-b1ae-852472b8**** |
| ParentMessageId |
string |
否 |
父消息 Id。 |
84dc9f9b-424a-404d-9c36-35e9d000**** |
| Inputs |
object |
否 |
任务输入。 |
|
| CustomAgentId |
string |
否 |
用户专属 AgentId。 |
d1b7d639-f34e-44c7-8231-987da14d**** |
| RegionId |
string |
否 |
地域 ID。 |
cn-beijing |
| Timezone |
string |
否 |
时区，默认为Asia/Shanghai。 |
UTC |
| Language |
string |
否 |
对白语言。 |
zh-cn |
| EnableThinking |
string |
否 |
||
| ThinkEffort |
string |
否 |
||
| ModelId |
string |
否 |
||
| EventMode |
string |
否 |
事件输出类型，支持 inline 和 separate，默认 inline。inline 时，工具调用事件、子任务事件、文档事件会统一放到 event = message 的 answer 字段中。separate 时，工具调用时间、子任务事件、文档事件，有各自的 event。 |
|
| Files |
array<object> |
否 |
||
|
object |
否 |
|||
| Type |
string |
否 |
||
| TransferMethod |
string |
否 |
||
| UploadFileId |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
对象。 |
||
| RequestId |
string |
请求 Id。 |
FE9C65D7-930F-57A5-A207-8C396329**** |
| Answer |
string |
回答内容。 |
您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我你的具体需求！ |
| ConversationId |
string |
对话 Id。 |
9cbbe885-b240-4803-9d15-6781a3fd**** |
| CreatedAt |
integer |
创建时间。 |
1763986004 |
| MessageId |
string |
消息 ID。 |
oas8pwy2-slxw-sf98-bx83-cb2hkktl**** |
| Mode |
string |
查询模式。 |
以后会下线，不用关注。 |
| Event |
string |
事件。 |
MysqlIOException |
| Id |
string |
消息 Id。 |
60b335ca-124d-4ee1-864b-de554987**** |
| TaskId |
string |
异步任务 ID。 |
01c3d43d-9466-4bd5-8196-4cbbce08**** |
示例
正常返回示例
JSON格式
{
"RequestId": "FE9C65D7-930F-57A5-A207-8C396329****",
"Answer": "您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我你的具体需求！",
"ConversationId": "9cbbe885-b240-4803-9d15-6781a3fd****",
"CreatedAt": 1763986004,
"MessageId": "oas8pwy2-slxw-sf98-bx83-cb2hkktl****",
"Mode": "以后会下线，不用关注。",
"Event": "MysqlIOException",
"Id": "60b335ca-124d-4ee1-864b-de554987****",
"TaskId": "01c3d43d-9466-4bd5-8196-4cbbce08****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 451 | ContentModeration | Content moderation violation. | 请求中存在不合规内容 |
| 400 | InvalidParameter | The provided parameter is invalid. | 无效的参数。 |
| 400 | InvalidOrder | No valid order found, please check whether RDS Copilot Professional Edition has been activated and ensure that the order is valid. | 没有有效订单，请检查是否已开通RDS AI助手专业版并确保订单有效 |
| 404 | UserNotFound | User does not exist. | 用户不存在。 |
| 429 | TooManyRequests | The current maximum concurrent requests have exceeded the threshold. | 当前最大并发请求已超过阈值，请购买AI容量包提升并发上限或减少当前并发请求。 |
| 429 | MoQuotaExceeded | The MO token quota of the routed Standard instance has been exhausted and the request is rate limited. Please wait for quota recovery or purchase a capacity pack. | 实例的 MO Token 额度已耗尽，请求已被限流。请等待额度恢复或购买容量包以继续使用。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。