# 查询会话后台任务

`GET` `/api/session/backgroundTasks`

查询当前登录用户指定会话下的后台子任务运行记录。返回CREATED、PROCESSING、SUSPENDED、COMPLETED、FAILED、CANCELLED状态的任务；已删除的记录不返回。

## 请求参数

### 请求头参数

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

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| sessionId | integer | 是 | 父会话ID |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | array | 响应数据 |
|     taskType | string | 后台任务类型，可选值：SUBAGENT（子智能体） |
|     taskId | string | 后台任务ID，用于查询任务详情 |
|     taskSessionId | string | 后台任务所属的子会话ID，以字符串返回以避免JavaScript精度丢失 |
|     taskName | string | 后台任务技术标识 |
|     description | string | 供界面展示的简短任务说明 |
|     status | string | 任务状态，可选值：CREATED、PROCESSING、SUSPENDED、COMPLETED、FAILED、CANCELLED |
|     statusReason | string | 任务失败或取消的中文原因说明；其他状态为空 |
|     model | string | 任务使用的模型名称 |
|     currentStep | integer | 当前执行步骤数 |
|     totalTokens | integer | 累计消耗Token数 |
|     startedAt | integer | 任务开始时间，Unix毫秒时间戳 |
|     completedAt | integer | 任务结束时间，Unix毫秒时间戳；完成、失败或取消时记录，未结束时为空 |
|     gmtCreate | string | 任务创建时间 |
| 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处理 |