ServiceNow只读查询

技能简介

该技能提供对 ServiceNow 平台的安全只读访问，通过 Table API、Attachment API、Aggregate API 和 Service Catalog API 获取数据，支持记录查询、附件下载、统计聚合和服务目录检索。

能做什么

• 按条件查询 ServiceNow 表记录并筛选字段
• 根据 sys_id 获取单条记录详情
• 下载附件内容及元数据信息
• 执行聚合统计（计数、平均值、最大最小值等）
• 浏览服务目录项和变量配置
• 查看记录的历史评论和工作日志

使用说明

安装准备

1. 确保系统已安装 Node.js 运行时环境
2. 克隆或下载技能文件到本地目录

配置认证

在技能目录下创建 .env 文件，填入以下环境变量：

SERVICENOW_DOMAIN=myinstance.service-now.com
SERVICENOW_USERNAME=your_username
SERVICENOW_PASSWORD=your_password

常用命令示例

查询最近的故障单：

node cli.mjs list incident --sysparm_limit 5 --sysparm_fields number,short_description,priority

按条件过滤查询：

node cli.mjs list cmdb_ci --sysparm_query "operational_status=1^install_status=1" --sysparm_limit 10

获取单条记录：

node cli.mjs get incident <sys_id> --sysparm_fields number,opened_at

临时覆盖认证信息：

node cli.mjs list incident --domain myinstance.service-now.com --username admin --password "***" --sysparm_limit 3

下载附件：

node cli.mjs attach list --sysparm_query "table_name=incident" --sysparm_limit 5
node cli.mjs attach file <sys_id> --out /tmp/attachment.bin

聚合统计：

node cli.mjs stats incident --sysparm_query "active=true^priority=1" --sysparm_count true

服务目录查询：

node cli.mjs sc catalogs --sysparm_text "laptop" --sysparm_limit 5
node cli.mjs sc items --sysparm_text "mac" --sysparm_limit 5

输入与输出

见下方输入与输出表格。

项目	内容
输入	ServiceNow 实例域名、认证凭据、目标表名/API端点、查询条件、字段筛选、数量限制、sys_id
输出	JSON格式记录数据、附件文件、聚合统计结果、服务目录列表、字段元数据、历史时间线
适用人群	ServiceNow管理员、IT运维人员、业务分析师、开发测试人员
不包含	数据写入功能、批量导出到外部存储、实时同步、可视化报表

 

风险提示

• 该技能仅支持 GET 请求，禁止执行 POST、PUT、PATCH、DELETE 等写操作
• 密码以明文形式存储在 .env 文件中，需妥善保管文件权限
• 建议设置 sysparm_limit 限制返回记录数，避免大数据量查询影响性能
• 生产环境建议使用专用只读账号，降低数据泄露风险

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/thesethrose/servicenow-agent/SKILL.md
来源类型：GitHub 开源仓库