# 分页查询运行记录列表

`GET` `/api/agent/run/listTasks`

按主体维度分页查询智能体运行记录列表，支持按状态和智能体ID过滤。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| status | string | 否 | 状态过滤条件，可选值：CREATED、PROCESSING、COMPLETED、FAILED、CANCELLED |
| agentId | integer | 否 | 智能体ID过滤条件，传入则只返回该智能体的运行记录 |
| page | integer | 否 | 页码，从1开始 |
| size | integer | 否 | 每页记录数，取值范围1~100 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | PageResultAgentRunSummary | 响应数据 |
|     items | array | 数据列表 |
|         requestId | string | - |
|         agentId | integer | - |
|         agentName | string | - |
|         agentDeleted | boolean | - |
|         sessionId | integer | - |
|         status | string | - |
|         currentStep | integer | - |
|         totalTokens | integer | - |
|         triggerSource | string | - |
|         model | string | - |
|         createdAt | integer | - |
|         startedAt | integer | - |
|         completedAt | integer | - |
|         sessionTitle | string | - |
|         userInput | string | - |
|         assistantMessageStatus | string | - |
|         userMessageId | integer | - |
|         assistantMessageId | integer | - |
|     total | integer | 总记录数 |
|     page | integer | 当前页码，从1开始 |
|     pageSize | integer | 每页大小 |
|     totalPages | integer | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |