ServiceNow只读数据探查工具，支持表记录查询、附件下载、聚合统计、服务目录变量读取及历史记录追踪，零写入风险。
说明：
## 核心功能
`servicenow-agent` 是一款面向 ServiceNow 平台的只读型 CLI 工具，专为安全的数据探查场景设计。它封装了 ServiceNow 四大核心 API（Table API、Attachment API、Aggregate API、Service Catalog API）的 GET 操作，完全禁止写入行为（POST/PUT/PATCH/DELETE）。
### 显著优点
– **零风险只读设计**：从架构层面限制为 GET 方法，杜绝误操作导致的数据变更或删除
– **多维度数据访问**：支持表记录查询（list/get）、单条记录精准获取、附件元数据与内容下载、聚合统计（count/avg/min/max/sum）、服务目录变量读取、字段结构探测及工单历史时间线回溯
– **灵活的查询能力**：完整的 `sysparm_*` 参数体系，支持复杂查询条件、字段筛选、显示值转换、分页控制
– **批量工作流支持**：通过 JSON 批处理文件可执行多表关联查询，内置推荐预设（事件模式检查、历史记录模板、附件追踪）
– **认证方式灵活**：支持 `.env` 环境变量配置或命令行实时覆盖
### 潜在局限
– **只读限制**：无法用于创建、更新或删除记录，不满足运维操作需求
– **Node.js 依赖**：需要运行时环境支持，增加部署复杂度
– **性能约束**：建议主动设置 `sysparm_limit` 避免大数据量超时，聚合统计优于全量下载
– **服务目录空结果**：特定搜索条件下可能返回空数组，需调整查询策略
### 适用人群
– ITSM/ITIL 分析师需快速审计工单状态与历史
– 安全合规团队进行只读数据取证与附件收集
– 开发测试人员验证表结构与服务目录配置
– 项目经理提取统计报表与趋势分析
### 常规风险提示
– 凭证（用户名/密码）以明文或环境变量形式存储，需确保 `.env` 文件权限管控
– 附件下载可能涉及敏感文件内容，需遵循组织数据分级策略
– 聚合查询若未合理设置 `sysparm_group_by`，可能对源系统造成计算压力
– 建议优先使用 `schema` 探测字段名，避免无效查询消耗 API 配额
会员专属
