读取任务MCP App资源

读取已绑定到运行任务的应用资源。URI是资源标识;实际服务地址和凭据由后端解析。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/mcp-apps/resource

调用前准备

准备当前环境的个人访问令牌、工作区ID,以及已返回应用描述的运行任务。使用原任务的工具ID、应用资源URI或工具名称;当前身份仍须有智能体使用权限和相应连接/服务权限。参见任务范围与结果。

请求参数

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/mcp-apps/resource" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  --data '{"tool_id":"tool-example","uri":"ui://example/card.html"}'

参数

类型

是否必填

说明

workspace_id

string

是

当前环境的工作区ID,与X-Workspace-ID一致。

task_id

string

是

该应用所属的智能体运行任务ID。

X-Workspace-ID

string

是

请求所属工作区。

X-API-Key

string

是

当前环境的个人访问令牌。

uri

string

是

原任务已绑定的绝对资源URI,原样使用;无凭据,最多2048字节。

tool_id

string

否

将URI查找范围缩小到原任务中的一个工具。

成功响应

{
  "code": 0,
  "data": {
    "uri": "ui://example/card.html",
    "contents": [
      {
        "uri": "ui://example/card.html",
        "mimeType": "text/html",
        "text": "<p>示例应用</p>"
      }
    ]
  }
}

字段

类型

说明

code

integer

成功为0。

data.uri

string

请求的资源URI。

data.contents

object(对象数组)

资源内容块。

data.contents[].uri

string

该内容块的URI;不要假设所有块都等于请求URI。

data.contents[].mimeType

string

可选MIME类型,键名保留camelCase。

data.contents[].text

string

文本内容;MCP资源路径与blob二选一。

data.contents[].blob

string

Base64编码内容;MCP资源路径与text二选一。

data.contents[]._meta

JSON值

可选资源元数据,按提供方合同保留。

错误响应

HTTP / code

条件与处理

400 / 2

JSON或字段、URI、选择器不合法。

403 / 5

当前智能体使用或相应权限被拒绝。

404 / 3

任务不在当前范围,或工具/URI未绑定。

409 / 2

任务已failed、canceled或rejected,不能继续应用操作。

502 / 1

MCP资源提供方响应无效;与工具自身is_error不同。

503 / 15

运行时或提供方不可用。

500 / 1

未分类内部或持久化失败;消息使用本地化通用说明。

错误使用本地化message;认证层还可能返回字符串code/msg。恢复及环境状态见 任务内知识检索。

最后更新于