# 查询执行历史

`GET` `/api/agent/schedule/executionHistory`

分页查询定时任务的执行历史记录。agentIds按运行记录的实际智能体筛选，与taskId取交集，不受当前默认智能体变化影响。传 taskId 时查询指定任务的执行历史（行为与旧版一致）；不传 taskId 时查询该用户身份下所有定时任务触发的执行记录，跨任务按时间倒序分页。返回记录包含 taskId、taskName、sessionId 等字段，可用于跨任务列表展示和跳转会话详情。

**迁移进来的历史运行**：通过「迁移历史运行记录」接口登记的运行也会出现在本列表中，按迁移时传入的 createdAt 参与排序，因此显式传入 createdAt 即可还原源端的历史顺序。这类记录只读，仅支持查询和随任务删除，不支持挂起、恢复、终止、重试、补充输入和订阅事件流。本列表的记录本身不带来源标识，需要在界面上区分或决定是否渲染管控按钮时，可用记录中的 requestId 调用「智能体运行」模块的「查询运行记录详情」接口，该接口返回的 triggerSource 为 imported 即表示迁移进来的历史运行。

## 请求参数

### 请求头参数

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

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentIds | array | 否 | 智能体ID列表，使用单个逗号分隔参数，如101,102；自动去重后最多20个，必须为正整数，不接受空值或重复参数键。未传时保留原查询行为。 |
| taskId | integer | 否 | 任务ID，不传则查询该用户所有任务的执行记录 |
| page | integer | 否 | 页码，从1开始 |
| size | integer | 否 | 每页记录数，取值范围1~100 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | PageResultTaskExecutionRecord | 响应数据 |
|     items | array | 数据列表 |
|         runId | integer | - |
|         taskId | integer | - |
|         taskName | string | - |
|         sessionId | integer | - |
|         requestId | string | - |
|         executionTime | string | - |
|         status | string | - |
|         rounds | integer | - |
|         totalTokens | integer | - |
|         durationMs | integer | - |
|         errorCode | string | - |
|         errorMessage | string | - |
|     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处理 |