# 获取会话详情

`GET` `/api/session/detail`

根据会话ID或业务键(bizKey)查询会话完整信息，包含Token消耗统计和会话当前状态(sessionStatus)。sessionStatus可能的值：IDLE(空闲就绪)、PROCESSING(执行中)、WAITING_PERMISSION(等待权限确认)、ERROR(执行出错)。bizKey与sessionId二选一，bizKey优先级更高。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

## 请求参数

### 请求头参数

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

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| sessionId | integer | 否 | 会话ID，与bizKey二选一 |
| bizKey | string | 否 | 业务键，与sessionId二选一，优先级高于sessionId |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | SessionDetailVO | 响应数据 |
|     sessionId | integer | 会话ID |
|     principalId | integer | 主体ID |
|     agentId | integer | 智能体ID |
|     projectId | integer | 项目会话归属的项目ID，临时会话为 null |
|     modelName | string | 使用的模型名称 |
|     title | string | 会话标题 |
|     gmtCreate | string | 创建时间 |
|     gmtModified | string | 最后修改时间 |
|     lastActiveTime | string | 最后活跃时间 |
|     sessionStatus | string | 会话当前状态，可选值：IDLE-空闲就绪可发送新消息、PROCESSING-智能体正在执行、WAITING_PERMISSION-等待用户权限确认、ERROR-上次执行出错（会话仍可继续使用） |
|     totalPromptTokens | integer | 累计 Prompt Token 数 |
|     totalCompletionTokens | integer | 累计 Completion Token 数 |
|     totalTokens | integer | 累计总 Token 数 |
|     totalCachedTokens | integer | 累计缓存 Token 数 |
|     totalReasoningTokens | integer | 累计推理 Token 数 |
|     triggerSourceType | 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处理 |