# 查询运行记录详情

`GET` `/api/agent/run/getTask`

根据请求ID查询单次智能体运行的完整信息，包括执行状态、步骤、Token消耗、错误信息等

## 请求参数

### 请求头参数

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

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| requestId | string | 是 | 运行记录的请求ID |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | AgentRunDetail | 响应数据 |
|     requestId | string | - |
|     principalId | integer | - |
|     agentId | integer | - |
|     agentName | string | - |
|     agentDeleted | boolean | - |
|     sessionId | integer | - |
|     status | string | - |
|     currentStep | integer | - |
|     totalTokens | integer | - |
|     model | string | - |
|     userMessageId | integer | - |
|     assistantMessageId | integer | - |
|     errorCode | string | - |
|     errorMessage | string | - |
|     triggerSource | string | - |
|     workerNode | string | - |
|     createdAt | integer | - |
|     startedAt | integer | - |
|     completedAt | 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处理 |