# 查询指定会话附件详情

`GET` `/api/agent/attachment/getBySession`

返回指定会话的基本信息及其所有附件列表，支持按附件来源过滤。支持通过sessionId或bizKey定位会话，bizKey优先级更高。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| sessionId | integer | 否 | 会话ID，与bizKey二选一 |
| bizKey | string | 否 | 业务键，与sessionId二选一，优先级高于sessionId。传入bizKey时系统自动解析对应的会话 |
| source | string | 否 | 附件来源过滤（可选），可选值：USER_UPLOAD-用户上传，AGENT_GENERATED-智能体生成，不传表示全部 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | RecentSessionAttachmentVO | 响应数据 |
|     sessionId | integer | 会话ID |
|     sessionTitle | string | 会话标题 |
|     sessionCreatedAt | string | 会话创建时间 |
|     attachmentCount | integer | 该会话下的附件数量 |
|     attachments | array | 附件列表 |
|         attachmentId | integer | 附件ID |
|         messageId | integer | 关联的消息ID（附件所属消息，可能为空） |
|         fileName | string | 文件名 |
|         fileType | string | 文件类型 |
|         fileSize | integer | 文件大小（字节） |
|         source | string | 来源：USER_UPLOAD（用户上传）/ AGENT_GENERATED（智能体生成） |
|         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处理 |