# 预览智能体查询图表图片

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

经过智能体使用授权后，读取当前工作区运行文件中的查询图表图片。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{id}/agents/{agent_id}/query-visuals/{file_id}/preview
```

## 调用前准备

`BASE_URL` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

准备同一环境的产品凭据MOI_KEY和WORKSPACE_ID；BASE_URL包含产品前缀。所有ID从实际查询结果取得，示例数据仅展示结构。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --fail-with-body -sS "$BASE_URL/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/query-visuals/$FILE_ID/preview" \
  -H "X-API-Key: $MOI_KEY" -H "X-Workspace-ID: $WORKSPACE_ID" \
  -o "$OUTPUT_FILE"
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `id` | string | 是 | 消费工作区ID。 |
| `agent_id` | string | 是 | 用于本次使用授权的智能体ID。 |
| `file_id` | string | 是 | 查询返回的运行图片文件ID。 |
| `agent_workspace_id` | string | 否 | 查询参数，优先于X-Agent-Workspace-ID；省略时为消费工作区。 |

目标智能体工作区只允许当前消费工作区或system。重新检查agent.use后读取当前消费工作区文件，不使用智能体定义工作区代替。内容须被识别为image/类型；成功带no-store、no-referrer和nosniff。没有浏览器预览转换或公开链接能力。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```text
HTTP/1.1 200 OK
<binary file content>
```

:::::
:::::{tab-item} 字段说明

| 字段／响应项 | 类型 | 说明 |
| --- | --- | --- |
| `Content-Type` | string | 从实际图片内容识别。 |
| `响应体` | bytes（字节流） | 图片原始字节。 |

成功响应没有统一code/data外层；临时文件和图片流直接返回字节。

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32005,
    "message": "示例本地化错误",
    "data": {
      "reason": "ADMISSION_DENIED"
    }
  }
}
```

:::::
:::::{tab-item} 字段说明

| HTTP | code／形式 | 条件 |
| --- | --- | --- |
| 400 | JSON-RPC或无响应体 | 路径／目标范围无效，或文件ID无效。 |
| 403 | JSON-RPC -32005 | 智能体使用授权未通过。 |
| 404 | 无响应体 | 文件读取失败或内容为空。 |
| 415 | 无响应体 | 内容未识别为图片。 |
| 503 | 无响应体 | handler依赖不可用。 |

外层身份／任务证明的拒绝还可能先于此handler；保持原始HTTP、机器码与实际诊断，不套其他文件协议错误包。

:::::
::::::
:::::::
