Skip to main content
execute_task 有两种模式：validateOnly: true 只校验模板和参数，不创建任务；正常调用会创建并启动云采集任务。

​
参数

parameters 在原始 MCP 接口中是 JSON 字符串：
部分客户端会替你把对象序列化成字符串；如果调用时报参数类型错误，请显式传入上面形式的 JSON 对象字符串。

​
参数规则

  • 使用 inputSchema[].field 作为 key，未知 key 会以 unmapped_parameters 失败。
  • MultiInput 字段始终传 string[]，即使只有一个值。
  • 对 source-backed 字段，先精确查询模板取得根级 sourceOptions，再把所选 option 的 key 作为字段值。
  • 依赖其他字段的数据源选项可通过 validateOnly: true 逐级取得。

​
先校验再执行

预检响应包含 status、canExecuteNow、blockingIssues、nextAction、normalizedParametersPreview，并可能包含下一层 sourceOptions。success: true 只表示本次校验请求成功；是否可以执行应以 canExecuteNow 为准。 确认 canExecuteNow: true 后，移除 validateOnly 或改为 false 再执行。

​
MCP Tasks 与兼容模式

支持 MCP Tasks 的客户端应优先以 Task 模式调用，并通过 tasks/get 查看状态、通过 tasks/result 获取最终执行结果。execute_task 的 Task 支持是可选能力，实际可用性取决于客户端。 不支持 MCP Tasks 的客户端会在创建并启动成功后收到 accepted 和八爪鱼 taskId。等待约 10-30 秒，再调用 export_data(taskId) 轮询采集和导出进度。
正整数 targetMaxRows 只适用于 MCP Tasks，并通过轮询后尽力发送停止请求，因此可能略有超出，不是严格行数上限。
另请参阅：工作流程示例、search_templates、export_data