发送对话消息。
调试
您可以在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**** |
| EnableThinking |
string |
否 |
深度思考模式开关。 |
true |
| Language |
string |
否 |
对白语言。 |
zh-cn |
| ModelId |
string |
否 |
模型 ID。 |
qwen3.7-max |
| RegionId |
string |
否 |
地域 ID。 |
cn-beijing |
| ResumeCallId |
string |
否 |
本次恢复执行的工具审批调用 ID。控制台完成当前审批轮次的全部决定后传入，用于继续中断的 ChatMessage Loop；普通对话不传。 |
call-example |
| ThinkEffort |
string |
否 |
思考深度。 枚举值：
|
default |
| Timezone |
string |
否 |
时区，默认为Asia/Shanghai。 |
UTC |
| ToolApprovalMode |
string |
否 |
本次 Conversation 的工具审批模式。可选值：read_only（只读，拒绝写工具）、manual（写工具需人工审批）、auto（由审批子智能体自动判断；needs_human 时转人工审批）。传入后更新当前 Conversation 的审批模式。 |
manual |
| WorkspaceId |
string |
否 |
ContextDB 工作空间 ID |
00000000-0000-4000-8000-000000000001 |
| EventMode |
string |
否 |
事件输出类型，支持 inline 和 separate，默认 inline。inline 时，工具调用事件、子任务事件、文档事件会统一放到 event = message 的 answer 字段中。separate 时，工具调用时间、子任务事件、文档事件，有各自的 event。 |
inline |
| Files |
array<object> |
否 |
||
|
object |
否 |
|||
| TransferMethod |
string |
否 |
||
| Type |
string |
否 |
||
| UploadFileId |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
对象。 |
||
| Answer |
string |
回答内容。 |
您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我你的具体需求！ |
| ApprovalStatus |
string |
工具调用审批状态 |
pending |
| CallId |
string |
工具调用 ID |
call-example |
| ConversationId |
string |
对话 Id。 |
9cbbe885-b240-4803-9d15-6781a3fd**** |
| CreatedAt |
integer |
创建时间。 |
1763986004 |
| Description |
string |
工具调用说明 |
Search ContextDB records |
| Event |
string |
事件。 |
MysqlIOException |
| Id |
string |
消息 Id。 |
60b335ca-124d-4ee1-864b-de554987**** |
| MessageId |
string |
消息 ID。 |
oas8pwy2-slxw-sf98-bx83-cb2hkktl**** |
| Mode |
string |
查询模式。 |
以后会下线，不用关注。 |
| RequestId |
string |
请求 Id。 |
FE9C65D7-930F-57A5-A207-8C396329**** |
| RoundId |
string |
工具审批轮次 ID |
round-example |
| TaskId |
string |
异步任务 ID。 |
01c3d43d-9466-4bd5-8196-4cbbce08**** |
| ToolArguments |
object |
工具调用参数 |
|
| ToolName |
string |
工具名称 |
contextdb.search |
示例
正常返回示例
JSON格式
{
"Answer": "您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我你的具体需求！",
"ApprovalStatus": "pending",
"CallId": "call-example",
"ConversationId": "9cbbe885-b240-4803-9d15-6781a3fd****",
"CreatedAt": 1763986004,
"Description": "Search ContextDB records",
"Event": "MysqlIOException",
"Id": "60b335ca-124d-4ee1-864b-de554987****",
"MessageId": "oas8pwy2-slxw-sf98-bx83-cb2hkktl****",
"Mode": "以后会下线，不用关注。",
"RequestId": "FE9C65D7-930F-57A5-A207-8C396329****",
"RoundId": "round-example",
"TaskId": "01c3d43d-9466-4bd5-8196-4cbbce08****",
"ToolArguments": {
"test": "test",
"test2": 1
},
"ToolName": "contextdb.search"
}错误码
|
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助手专业版并确保订单有效 |
| 400 | FileUploadValidationError | The uploaded file reference is invalid. | 上传的文件引用无效。 |
| 400 | InvalidWorkspaceId.Missing | WorkspaceId is required for the ContextDB management App. | 使用 ContextDB 管理应用时必须提供 WorkspaceId。请指定本次请求所属的 ContextDB 工作空间后重试。 |
| 400 | InvalidWorkspaceId.Conflict | The request contains conflicting WorkspaceId values. | 请求中提供的 WorkspaceId 相互冲突。请确保请求中各位置的工作空间标识一致后重试。 |
| 400 | InvalidWorkspaceId.Value | WorkspaceId is invalid. | WorkspaceId 无效。请检查工作空间标识，指定有效的 ContextDB WorkspaceId 后重试。 |
| 422 | InvalidToolApprovalMode | Invalid ToolApprovalMode value. | ToolApprovalMode 参数值无效。 |
| 403 | ModelSelectionRequiresPaidOrder | Selecting a non-default model requires a valid paid order. | 选择非默认模型需要有效的付费订单。 |
| 403 | FileUploadForbidden | The uploaded file is not accessible to the current user. | 当前用户无权访问该上传文件。 |
| 404 | UserNotFound | User does not exist. | 用户不存在。 |
| 404 | CustomAgentNotFound | The custom agent was not found or is not accessible. | 自定义智能体不存在或当前用户无权访问。 |
| 503 | ToolApprovalUnavailable | The tool approval service is temporarily unavailable. | 工具审批服务暂时不可用，请稍后重试。 |
| 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 额度已耗尽，请等待额度恢复或购买容量包。 |
| 429 | RateLimitError | The request was rejected because the invocation rate limit was exceeded. | 请求因超过调用频率限制而被拒绝。 |
| 409 | PendingToolApproval | The conversation has pending tool approvals. | Conversation 存在待处理的工具审批，完成全部审批后再继续对话。 |
| 409 | ToolApprovalResumeInvalid | The specified tool approval call cannot be resumed. | 指定的工具审批调用无法恢复。 |
| 409 | ConversationBusy | The conversation is already resuming a tool approval round. | Conversation 正在恢复工具审批，当前请求无法并发执行。 |
| 409 | FileUploadConflict | The uploaded file conflicts with the current request. | 上传文件与当前请求存在冲突。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。