预览智能体查询图表图片¶
经过智能体使用授权后,读取当前工作区运行文件中的查询图表图片。
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"
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
是 |
消费工作区ID。 |
|
string |
是 |
用于本次使用授权的智能体ID。 |
|
string |
是 |
查询返回的运行图片文件ID。 |
|
string |
否 |
查询参数,优先于X-Agent-Workspace-ID;省略时为消费工作区。 |
目标智能体工作区只允许当前消费工作区或system。重新检查agent.use后读取当前消费工作区文件,不使用智能体定义工作区代替。内容须被识别为image/类型;成功带no-store、no-referrer和nosniff。没有浏览器预览转换或公开链接能力。
成功响应¶
HTTP/1.1 200 OK
<binary file content>
字段/响应项 |
类型 |
说明 |
|---|---|---|
|
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、机器码与实际诊断,不套其他文件协议错误包。
最后更新于