预览智能体查询图表图片

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

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从实际查询结果取得,示例数据仅展示结构。

请求参数

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"

字段

类型

是否必填

说明

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。没有浏览器预览转换或公开链接能力。

成功响应

HTTP/1.1 200 OK
<binary file content>

字段/响应项

类型

说明

Content-Type

string

从实际图片内容识别。

响应体

bytes(字节流)

图片原始字节。

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

错误响应

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

HTTP

code/形式

条件

400

JSON-RPC或无响应体

路径/目标范围无效,或文件ID无效。

403

JSON-RPC -32005

智能体使用授权未通过。

404

无响应体

文件读取失败或内容为空。

415

无响应体

内容未识别为图片。

503

无响应体

handler依赖不可用。

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

最后更新于