# 读取任务MCP App资源

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

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

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

## 调用前准备

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

## 请求参数

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

```bash
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"}'
```

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

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `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查找范围缩小到原任务中的一个工具。 |

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

## 成功响应

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

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

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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。恢复及环境状态见 [任务内知识检索](../../../../developer/cli/tasks/runtime-knowledge.md)。
