SuperAPI AI 工具集

debugging-mutations

部署与运维

查看项目

更新于 10-16 05:54

技能介绍

用途:在针对 ServiceNow 执行工具调用后,核实实际发生了什么,或诊断为何未生效。属于事后验证手段,不能替代选择正确的工具。

主要能力(工具):snow_inspect_mutations 按时间戳经 sys_audit 检查 INSERT/UPDATE/DELETE 记录变更;snow_get_logs 按时间过滤查询平台日志,log_table 可取 syslog(默认)、syslog_app_scope、syslog_transaction、sys_script_execution_history;snow_session_context 输出已认证用户、角色、当前 Update Set 与域;snow_get_script_output 获取先前脚本输出;snow_trace_execution 做服务端脚本执行追踪;snow_get_flow_execution_logs 获取 Flow Designer 执行历史;snow_get_inbound_http_logs 与 snow_get_outbound_http_logs 查 REST 调用日志;snow_audit_trail_analysis 做审计轨迹与异常检测;snow_manage_flow 配合 verify=true 验证 Flow 变更。

使用方式:Table API/REST 变更流程为:记录当前时间戳或使用相对窗口(如 "30s"),执行要验证的工具,再用 since=<timestamp> 或 since="30s" 调用 snow_inspect_mutations,查看变更记录与字段旧→新值,对比预期与实际。Flow Designer 变更需用 verify=true 或 action=check_execution flow_id=<id> 检查执行上下文、运行与输出;后者会返回 state、status、timing、errors 及来自 sys_flow_context、sys_hub_flow_run、sys_hub_flow_output 的输出。选择工具时可据症状判断,如脚本错误用 level="error" 的日志,权限 403 用 session context,出站 REST 失败用 outbound 日志。

限制与注意:Flow Designer 的 GraphQL 变更不被 sys_audit 捕获,不能通过 snow_inspect_mutations 查看;sys_audit 只捕获成功的 Table API/REST 记录变更,失败操作无审计轨迹;失败操作需查 syslog 与 sys_transaction_log。sys_audit 字段值上限 255 字符,截断时会提示。可结合 snapshot_record 获取记录当前状态,用 tables 过滤聚焦特定表。文档提醒不要每次调用都依赖这些工具,应修正上游问题,如误用 raw GlideRecord、用占位符代替真实 sys_id、跳过 Update Set 等。