SuperAPI AI 工具集

query-generation

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:把自然语言描述的数据需求翻译为 ServiceNow 查询、脚本与报表配置,包括编码查询、GlideRecord 查询、GlideAggregate 汇总脚本和仪表板报表过滤条件,支持多条件 AND/OR、日期与相对时间、动态查询。

主要能力:掌握编码查询运算符(=、!=、LIKE、STARTSWITH、ISEMPTY、IN、BETWEEN、INSTANCEOF 等)及 AND(^)、OR(^OR)、^NQ 分组;使用 javascript:gs.daysAgo()、beginningOfThisMonth() 等日期函数;生成 GlideRecord 的 addQuery、addOrCondition、addEncodedQuery、addActiveQuery;生成 GlideAggregate 的 COUNT、AVG、SUM、MIN 及 groupBy、addTrend;创建 sys_report 记录(列表、折线、饼图等)。

使用方式:先通过 SN-Get-Table-Schema 或 sys_dictionary REST 接口校验字段,再用 SN-Query-Table 或 GET /api/now/table/{table}?sysparm_query= 测试查询,最后用 SN-Create-Record 或 POST /api/now/table/sys_report 创建报表。示例命令:curl -u "$SN_USER:$SN_PASS" "$SN_INSTANCE/api/now/table/incident?sysparm_query=active=true^priority=1&sysparm_fields=sys_id,number&sysparm_limit=10"。

适用场景:构建列表与模块的复杂编码查询、报表过滤条件、脚本化数据检索、按优先级或分组统计、趋势与成本汇总。

限制与前提:需要 itil、report_user、admin 或目标表读权限,并了解编码查询语法与 GlideRecord/GlideAggregate API。查询可能因字段拼写、值大小写、ACL 限制而无结果或结果过多;日期比较需注意日期与日期时间类型及时区;点走查过深会影响性能;聚合计数可能受 ACL 影响。建议先校验字段、增量测试、用 setLimit 限制结果、优先用 GlideAggregate 做聚合、避免用未校验输入构造查询。具体收费与平台支持情况暂未提供。