用途:snow_execute_script 用于在 ServiceNow 实例上执行后台脚本,它不使用官方的 Scripts - Background 模块,而是自建传输通道,首次调用时自动部署一个 Scripted REST 端点。
两条执行路径:每次调用先走同步路径,即 POST 到 Serac 安装的 Scripted REST 端点,脚本内联求值并在 HTTP 响应中返回结果,通常 1–3 秒。同步 POST 未返回可用响应体时会回退到定时任务路径:创建 sysauto_script 作业和两秒后触发的 sys_trigger 行,再轮询 sys_properties 等待完成标记,延迟从 4 秒到完整超时(默认 30 秒)。脚本抛错会返回 HTTP 500,客户端视为端点不可用而回退,因此有 bug 的脚本可能被执行多次,不要用此工具调试会修改数据的脚本。
端点与权限:首次调用会通过 Table API 创建 sys_ws_definition(name = Serac Script Executor,service_id = snow_flow_exec)和 sys_ws_operation(name = Execute Script,http_method = POST,relative_path = /execute,requires_authentication = true)。实际 URL 形如 /api/<namespace>/snow_flow_exec/execute,namespace 由实例决定。创建和修改 Scripted REST API 需要 web_service_admin 角色(admin 包含它),但端点脚本首句检查 gs.hasRole('admin'),其他角色会收到 HTTP 403 与 Forbidden。仅有 web_service_admin 的集成用户会部署成功却每次被拒,诊断显示为 no candidate URL responded with success=true,这并非路由问题。
返回解读:外层 success 表示 MCP 工具是否完成,即使脚本抛错也为 true;data.success 是脚本自身结果,false 表示抛错,错误信息在 data.error。值得读的字段包括 metadata.method(实际走的路径)、data.executed、data.result、data.output(print/info/warn/error 数组)、data.execution_id、data.fallback_warning。
限制与注意:脚本需兼容两条路径,仅支持 ES5,只有 gs.print/gs.info/gs.warn/gs.error 会被捕获,data.result 需为 JSON 形状。scheduled_job_pending 表示轮询超时,恢复应使用 snow_get_script_output 并检查 metadata.source 是否为 sys_properties。runAsUser、scope 等参数实际无效。requireConfirmation 流程不建议使用。另有五个工具共用该端点。其余内容资料未完整提供。