# 根据消息ID查询附件

`GET` `/api/agent/attachment/getByMessage`

返回指定消息关联的所有附件列表，支持用户上传和智能体生成的输出文件。智能体生成的附件其 fileName 可能带相对工作区的路径前缀，展示文件名请使用 pureFileName 字段

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| messageId | integer | 是 | 消息ID |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | array | 响应数据 |
|     attachmentId | integer | 附件ID |
|     fileName | string | 文件名。智能体生成的附件此字段可能带相对工作区的路径前缀，如 agent_session/tmp/报告.pdf；展示文件名请改用 pureFileName |
|     pureFileName | string | 纯文件名（已剥离目录部分），展示附件名称时请用此字段 |
|     fileExtension | string | 文件扩展名 |
|     contentType | string | 文件MIME类型 |
|     fileSize | integer | 文件大小（字节） |
|     virtualPath | string | 虚拟路径 |
|     source | string | 附件来源：USER_UPLOAD / AGENT_GENERATED |
|     previewUrl | string | 附件预览URL，前端可直接用于图片渲染或文件预览 |
| 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处理 |