接口描述
分页查询指定会话的消息事件（对话历史）。
GET /v2/enterprises/{enterpriseId}/managedagent/message-events输入参数
路径参数
参数 | 类型 | 说明 |
enterpriseId | string | WorkBuddy 企业 ID |
查询参数
参数 | 类型 | 说明 |
page | integer | 页码，从 1 开始，缺省 1 |
pageSize | integer | 每页条数，缺省 20，上限 100 |
eventType | string | 按事件类型过滤 |
agentId（必填） | string | Agent 业务 ID |
sessionId（必填） | string | 会话 ID |
subagentId | string | 可选，只看指定子 Agent 产生的事件 |
请求体
无（GET / DELETE 不带请求体，条件走路径与查询参数）
输出参数
（
200，业务出参包装在 code / data / msg / requestId 中）DescribeMessageEventListResponse 返回当前页的事件数据。
字段 | 类型 | 说明 |
totalCount | integer | TotalCount 该会话的消息事件总数（分页前）。 |
messageEventSet | MessageEventSet 当前页的消息事件列表，按 Sequence 升序。 |
示例
输入示例
GET /v2/enterprises/{enterpriseId}/managedagent/message-events?page=1&pageSize=20Authorization: Bearer pt_<YOUR_APP_KEY>
输出示例
{"code": 0,"data": {"messageEventSet": [{"eventType": "USER","message": {"content": "string","tokenUsage": {"inputTokens": 1,"outputTokens": 1,"scope": "string","totalTokens": 2}},"occurredAt": "string","sequence": 1,"toolCall": {"durationMs": 1,"endedAt": "string","expertId": "1200345678901234567","expertName": "数据分析助手","expertVersion": "1.0.0","input": "string","output": "string","parentToolCallId": "1200345678901234567","startedAt": "string","status": "PENDING","subAgentId": "736918300000000001","subAgentName": "数据分析助手","toolCallId": "1200345678901234567","toolName": "数据分析助手"}}],"totalCount": 1},"msg": "OK","requestId": "3c6d138e-1234-5678-9abc-def012345678"}
错误码
说明：
错误码 | 说明 |
FailedOperation.SessionHistoryUnavailable | 会话历史暂不可用 |
InternalError.SessionHistoryFailed | 会话历史操作失败 |
InternalError.TracingNotConfigured | 未配置链路追踪 |
InvalidParameter.InvalidRequestBody | 请求体不合法 |
InvalidParameter.SessionIDRequired | 缺少 SessionId |
InvalidParameter.TracingRequest | 链路查询请求不合法 |
ResourceNotFound.SessionNotFound | 会话不存在 |
