任务范围与结果读取¶
身份与工具选择¶
这两个任务路径使用当前请求身份、工作区及任务保存的工具清单。后端重新检查当前智能体使用权限,私有连接凭据按当前调用者解析;不使用任务owner替另一成员取得凭据。已完成的任务仍可用于应用读取和调用;failed、canceled、rejected被拒绝。终态不是一律可用或一律禁止。
资源读取按URI和可选tool_id在任务清单中匹配,URI前后不得带空白,不接受userinfo。它是绝对资源标识,不是浏览器提供任意服务器URL的入口。多个工具同URI且不限定ID时,当前实现取首个匹配项,不能宣称拒绝所有URI歧义。
工具调用的tool_name优先于tool_id;名称可匹配平台名称或持久化的原MCP名称/服务名。名称匹配到多个允许应用访问的工具时拒绝。必须有有效应用描述,visibility未限制时允许两种用途,显式仅model的工具不能从应用调用。ID和名称前后空白会被拒绝。
资源及调用结果¶
返回位置 |
读取规则 |
|---|---|
|
资源内容使用camelCase;不要改写成mime_type。 |
|
MCP读取分支要求二选一;blob为合法Base64,空文本仍是已提供text。 |
|
产品调用结果用snake_case,值可为任意JSON或显式null。 |
|
普通false也会返回。true是工具结果失败,HTTP200不等于业务操作成功。 |
MCP资源Provider校验1至16个内容块,每块文本或Base64编码字符串不超过2MiB;这是逐块限制,不是整份响应总上限。发布API服务页面走对应工作流资源owner,不能机械套用MCP网络分支的全部校验。资源内容块URI只校验非空,不能推断它等于请求URI。
MCP工具调用保留提供方isError结果为产品is_error;网络/协议失败和工具报告失败分别处理。当前资源读取对无效提供方结果可502,调用路径的提供方异常经运行时不可用映射503,不能复制相同HTTP表。
调用结果直接返回调用者,不能据此宣称已更新模型对话或整个运行结果。实际工具可以执行写入或外部调用,失败/超时后先按工具业务查询结果,不自动重试,也不将任务completed当成工具成功。发布API服务调用经当前调用者与当前有效角色进入相应owner;不能由浏览器填写角色字段。