Query natural language query history logs
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AgentName |
string |
No |
Agent name. Leave empty to query all. |
demo-luma-agent |
| After |
string |
No |
Cursor: the messageId of the last entry on the previous page. |
eyJ0cyI6MTcxN... |
| Limit |
integer |
No |
Number of entries to return. Default 20, maximum 50. |
10 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| Message |
string |
Error message. |
AgentNotFound |
| RequestId |
string |
The unique identifier generated by Alibaba Cloud for this request. |
6FB52207-7621-5292-BDF2-A17E2E984160 |
| Data | QueryAskLumaLogResult |
The returned result. |
true |
| Code |
string |
Interface return code: 200: Indicates success. Others: Indicate error codes. For error code details, see Error Codes. |
Success |
| Success |
boolean |
Returns true when the operation is successful. |
true |
Content.MessageAttachments additional notes:
Only records with Source=CHAT carry this field (message list in AGUI format).
For records with Source=MCP, this field is null and is not output during JSON serialization.
Examples
Success response
JSON format
{
"Message": "AgentNotFound",
"RequestId": "6FB52207-7621-5292-BDF2-A17E2E984160",
"Data": {
"Entries": [
{
"MessageId": "msg_xxx",
"ConversationId": "conv_xxx",
"AgentName": "my-agent",
"Question": "帮我统计一下最近的订单数据。",
"Status": "RUNNING, SUCCEEDED, FAILED, TIMEOUT",
"ClarificationNeeded": false,
"ClarificationQuestion": "您指的是哪张表?",
"Content": {
"TextAttachments": [
"\"**top 5 城市**: 北京(120)...\""
],
"QueryAttachments": [
{
"Query": "\"SELECT city, COUNT(*) AS cnt FROM events GROUP BY city\"",
"Result": {
"Schema": [
{
"Name": "name",
"Type": "VARCHAR"
}
],
"Rows": "[[\"北京\",120],[\"上海\",98]] ",
"RowCount": 2,
"TotalRows": 2,
"IsTruncated": false
}
}
],
"MessageAttachments": [
{
"Id": "msg_123456_a1b2c3d4",
"Role": "assistant",
"Content": "根据您的问题,我将查询过去7天的事件量...",
"Metadata": {
"Attachments": {
"Name": "acs:eventbridge:cn-hangzhou:12345:eventhouse/system-rocketmq/namespace/rmq-cn-xxx/table/order",
"Type": "inner-resource/event-table"
}
},
"ToolCallId": "call_xxx",
"ToolCalls": [
{
"Id": "call_xxx",
"Type": "function",
"Function": {
"Name": "discoverMetadata",
"Arguments": "{}"
}
}
]
}
]
},
"IsError": false,
"ErrorCode": "ExecutionFailed",
"ErrorMessage": "Agent with name 'xxx' not found for account 1186xxx",
"CreatedAt": "1717200000000",
"DurationMs": 3200,
"Source": "MCP, CHAT"
}
],
"LastKey": "",
"HasMore": false
},
"Code": "Success",
"Success": true
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 403 | ServiceNotEnable | Service not enable |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.