该接口用于来查看具体对话消息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
rdsai:GetMessages |
none |
*全部资源
|
无 | 无 |
请求语法
GET HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ConversationId |
string |
否 |
对话 Id。 |
941c6f59-acf5-4e11-9adc-31e52e1f**** |
| FirstId |
string |
否 |
首条消息 Id。 |
038866af-a050-4bc5-bfad-b7bfc838**** |
| Limit |
integer |
否 |
分页查询时设置的每页行数。取值范围：1~100。默认值：100。 |
10 |
| EventMode |
string |
否 |
||
| WorkspaceId |
string |
否 |
ContextDB 工作空间 ID |
00000000-0000-4000-8000-000000000001 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
对象。 |
||
| Data |
array<object> |
查询结果。 |
|
|
array<object> |
查询结果。 |
||
| Answer |
string |
回复。 |
您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我具体需求！ |
| ConversationId |
string |
会话 id。 |
9cbbe885-b240-4803-9d15-6781a3fd**** |
| CreatedAt |
string |
创建时间。 |
1763986004 |
| Events |
array<object> |
||
|
array<object> |
|||
| ApprovalStatus |
string |
工具调用审批状态 |
pending |
| CallId |
string |
工具调用 ID |
call-example |
| ConversationId |
string |
会话 ID |
conversation-example |
| Description |
string |
工具调用说明 |
Search ContextDB records |
| MessageId |
string |
消息 ID |
message-example |
| RoundId |
string |
工具审批轮次 ID |
round-example |
| ToolArguments |
object |
工具调用参数 |
|
| ToolName |
string |
工具名称 |
contextdb.search |
| answer |
string |
||
| event |
string |
||
| Feedback |
string |
反馈。 |
like |
| GenerationFinishedAt |
string |
||
| GenerationStartedAt |
string |
||
| GenerationStatus |
string |
||
| Id |
string |
消息 Id。 |
84dc9f9b-424a-404d-9c36-35e9d000**** |
| LastSentEntryId |
string |
||
| MessageFiles |
array<object> |
||
|
object |
|||
| Id |
string |
||
| PreviewUrl |
string |
||
| Type |
string |
||
| UploadFileId |
string |
上传文件 ID |
file-example |
| Query |
string |
查询语句。 |
实例rm-bp14as9914vd3**** 磁盘使用率，是否需要扩容 |
| RetrieverResources |
array |
检索资源。 |
|
|
any |
资源。 |
测试字段，不用关注。 |
|
| StreamKey |
string |
||
| HasMore |
boolean |
是否有下一页。 |
true |
| Limit |
integer |
查询结果条数上限。 |
100 |
| RequestId |
string |
请求 Id。 |
FE9C65D7-930F-57A5-A207-8C396329**** |
示例
正常返回示例
JSON格式
{
"Data": [
{
"Answer": "您询问的实例rm-bp14as9914vd3**** 磁盘使用率为23%，暂时不需要进行扩容。如果您需要进一步查看某个实例的详细配置、性能监控或进行其他操作，请告诉我具体需求！",
"ConversationId": "9cbbe885-b240-4803-9d15-6781a3fd****",
"CreatedAt": "1763986004",
"Events": [
{
"ApprovalStatus": "pending",
"CallId": "call-example",
"ConversationId": "conversation-example",
"Description": "Search ContextDB records",
"MessageId": "message-example",
"RoundId": "round-example",
"ToolArguments": {
"test": "test",
"test2": 1
},
"ToolName": "contextdb.search",
"answer": "",
"event": ""
}
],
"Feedback": "like",
"GenerationFinishedAt": "",
"GenerationStartedAt": "",
"GenerationStatus": "",
"Id": "84dc9f9b-424a-404d-9c36-35e9d000****",
"LastSentEntryId": "",
"MessageFiles": [
{
"Id": "",
"PreviewUrl": "",
"Type": "",
"UploadFileId": "file-example"
}
],
"Query": "实例rm-bp14as9914vd3**** 磁盘使用率，是否需要扩容",
"RetrieverResources": [
"测试字段，不用关注。"
],
"StreamKey": ""
}
],
"HasMore": true,
"Limit": 100,
"RequestId": "FE9C65D7-930F-57A5-A207-8C396329****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | The provided parameter 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 后重试。 |
| 404 | UserNotFound | User does not exist. | 用户不存在。 |
| 404 | ConversationNotFound | Conversation does not exist. | 会话不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。