ServiceNow文档查询技能

从docs.servicenow.com和developer.servicenow.com搜索并检索文档。该技能提供对ServiceNow版本说明、平台文档以及面向开发者的API参考和指南的访问。

使用场景

当用户询问以下内容时使用此技能：

• ServiceNow API文档（GlideRecord、GlideAjax、GlideQuery等）
• 版本说明、补丁或新功能
• 平台配置或管理
• 脚本编写模式或最佳实践
• 可访问性、用户界面或用户偏好设置
• 任何ServiceNow产品或功能文档
• 开发者主题，如openFrameAPI、ScriptLoader、spContextManager或移动端API

工具

servicenow_search

搜索ServiceNow文档数据库。

参数：

• query（字符串，必需）- 搜索词（例如："GlideRecord"、"可访问性偏好设置"、"补丁说明"）
• limit（数字，默认值：10）- 返回的最大结果数量
• 版本（字符串，可选）- 按版本筛选（例如，"Washington DC"、"Zurich"、"Yokohama"）

示例：

{"query": "GlideAjax client script", "limit": 5}

servicenow_get_article

获取文档文章的完整内容。

参数：

• 网址（字符串，必需）- 文章网址（自动从 Zoomin 转换为 docs.servicenow.com）

示例：

{"url": "https://docs.servicenow.com/bundle/zurich-release-notes/page/release-notes/quality/zurich-patch-5.html"}

servicenow_list_versions

列出可用的 ServiceNow 文档版本/发行版。

参数：无需参数

servicenow_latest_release

获取最新 ServiceNow 版本的发行说明（自动检测最新版本）。

参数：无需参数

servicenow_dev_suggest

从 ServiceNow 开发者文档获取自动完成建议。

参数：

• 术语（字符串，必需）- 部分搜索词（例如："Gli"、"openFrame"、"spCon"）

示例：

{"term": "openFrame"}

servicenow_dev_search

搜索 ServiceNow 开发者文档（API、指南、参考）。返回 API 参考页面的 URL。

参数：

• query（字符串，必需）- 搜索词（例如："openFrameAPI"、"spContextManager"）
• limit（数字，默认值：10）- 返回的最大结果数

示例：

{"query": "ScriptLoader", "limit": 5}

servicenow_dev_guide

通过路径获取 ServiceNow 开发者指南。适用于 PDI 指南、开发者计划文档等。

参数：

• path（字符串，必需）- 指南路径（例如："developer-program/getting-instance-assistance"、"pdi-guide/requesting-an-instance"）
• release（字符串，默认值："zurich"）- 发行版本

示例：

{"path": "developer-program/getting-instance-assistance"}

URL 处理

• 搜索API：使用Zoomin API（servicenow-be-prod.servicenow.com）进行搜索
• 面向用户的URL：为提高可读性，自动转换为docs.servicenow.com
• 文章内容：通过带有适当请求头的Zoomin API端点获取
• 开发者文档搜索：使用developer.servicenow.com的GraphQL + databroker搜索API
• 开发者文档内容：直接从developer.servicenow.com页面获取

使用示例

用户："ServiceNow中的辅助功能首选项是什么？" → 使用servicenow_search查找辅助功能文档 → 使用servicenow_get_article获取完整内容 → 为用户总结首选项信息

用户："告诉我最新的ServiceNow补丁信息" → 使用servicenow_latest_release获取最新的发布说明 → 获取并总结补丁详情

用户："如何使用openFrameAPI？" → 使用servicenow_dev_suggest或servicenow_dev_search查找最佳开发者文档主题 → 返回API参考页面的URL（需要浏览器访问以获取完整内容）

用户："请展示获取实例的PDI指南" → 使用 servicenow_dev_guide，路径为 "pdi-guide/requesting-an-instance" → 返回完整指南内容

使用的API

• Zoomin 搜索 API: https://servicenow-be-prod.servicenow.com/search
• 内容来源:docs.servicenow.com (通过 Zoomin API 访问)
• 开发者搜索 API: https://developer.servicenow.com/api/now/uxf/databroker/exec
• 开发者建议 API: https://developer.servicenow.com/api/now/graphql
• 开发者指南 API: https://developer.servicenow.com/api/snc/v1/guides(公开，无需认证)

限制

• API 参考内容:developer.servicenow.com 的 API 参考页面需要浏览器访问。servicenow_dev_search返回URL，但无法获取完整的API文档内容。
• 指南内容：指南可通过servicenow_dev_guide无需验证即可完整获取。