SuperAPI AI 工具集

generic-crud-operations

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:本技能提供一套通用的 ServiceNow 表操作方法,无需为每张表单独建工具,即可在 160 多张表上执行创建、读取、更新等 CRUD 操作,适合开发者、管理员和集成人员使用。

主要能力:包含模式发现(SN-Get-Table-Schema、SN-Discover-Table-Schema)、记录查询(SN-Query-Table)、按 sys_id 读取单条记录(SN-Get-Record)、创建记录(SN-Create-Record)、更新记录(SN-Update-Record)以及批量创建和批量更新(SN-Batch-Create、SN-Batch-Update)。查询支持过滤条件、字段选择、排序、limit 与 offset 分页。还可通过 REST 接口 /api/now/table/{table} 及带 sys_id 的路径执行对应 GET、POST、PATCH、PUT、DELETE,并使用 sysparm_query、sysparm_fields、sysparm_limit、sysparm_offset、sysparm_display_value 等参数。文档同时列出系统字段、引用字段、选项字段和日期时间字段的常见处理方式。

使用方式:操作前先用模式发现工具了解表结构,查询时指定所需字段并分页,创建或更新时提供合法字段值,引用字段需使用被引用表中的有效 sys_id。批量操作适合 5 至 10 条以上的多次操作。使用前需配置并运行 MCP ServiceNow 服务器,并具备目标表所需的服务端角色权限。

限制与说明:权限受表级 ACL 与角色限制,创建或更新可能因缺少写权限、字段值非法、引用无效或必填字段缺失而失败。原生工具路径优先使用 MCP,仅在 MCP 不支持时才考虑原始 REST,并需依托组织已配置的本地凭据助手,不得要求用户在对话中粘贴认证材料或生成含认证头的请求。