名称： servicenow-docs
描述： 搜索并获取 ServiceNow 文档、发行说明和开发者文档（API、参考、指南）。通过 Zoomin 使用 docs.servicenow.com，以及 developer.servicenow.com API 获取开发者主题内容。
元数据：
clawdbot:
emoji: "📘"
read_when:
- 回答关于 ServiceNow 功能、API 或脚本编写的问题时
- 查找发行说明或补丁信息时
- 寻找 GlideRecord、GlideAjax、工作流等文档时
- 研究 ServiceNow 平台能力时
从 docs.servicenow.com 和 developer.servicenow.com 搜索并获取文档。此技能提供对 ServiceNow 发行说明、平台文档以及面向开发者的 API 参考和指南的访问。
当用户询问以下内容时使用此技能：
- ServiceNow API 文档（GlideRecord、GlideAjax、GlideQuery 等）
- 发行说明、补丁或新功能
- 平台配置或管理
- 脚本编写模式或最佳实践
- 可访问性、用户界面或用户偏好设置
- 任何 ServiceNow 产品或功能文档
- 开发者主题，如 openFrameAPI、ScriptLoader、spContextManager 或移动端 API
搜索 ServiceNow 文档数据库。
参数：
- query (字符串，必需) - 搜索词（例如："GlideRecord"、"accessibility preferences"、"patch notes"）
- limit (数字，默认：10) - 返回的最大结果数
- version (字符串，可选) - 按版本筛选（例如："Washington DC"、"Zurich"、"Yokohama"）
示例：
{"query": "GlideAjax client script", "limit": 5}
获取文档文章的完整内容。
参数：
- url (字符串，必需) - 文章 URL（会自动从 Zoomin 转换为 docs.servicenow.com 格式）
示例：
{"url": "https://docs.servicenow.com/bundle/zurich-release-notes/page/release-notes/quality/zurich-patch-5.html"}
列出可用的 ServiceNow 文档版本/发行版。
参数： 无必需参数
获取最新 ServiceNow 版本的发行说明（自动检测最新版本）。
参数： 无必需参数
从 ServiceNow 开发者文档获取自动补全建议。
参数：
- term (字符串，必需) - 部分搜索词（例如："Gli"、"openFrame"、"spCon"）
示例：
{"term": "openFrame"}
搜索 ServiceNow 开发者文档（API、指南、参考）。返回 API 参考页面的 URL。
参数：
- query (字符串，必需) - 搜索词（例如："openFrameAPI"、"spContextManager"）
- limit (数字，默认：10) - 返回的最大结果数
示例：
{"query": "ScriptLoader", "limit": 5}
通过路径获取 ServiceNow 开发者指南。适用于 PDI 指南、开发者计划文档等。
参数：
- path (字符串，必需) - 指南路径（例如："developer-program/getting-instance-assistance"、"pdi-guide/requesting-an-instance"）
- release (字符串，默认："zurich") - 发行版本
示例：
{"path": "developer-program/getting-instance-assistance"}
用户："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"
→ 返回完整的指南内容
https://servicenow-be-prod.servicenow.com/searchhttps://developer.servicenow.com/api/now/uxf/databroker/exechttps://developer.servicenow.com/api/now/graphqlhttps://developer.servicenow.com/api/snc/v1/guides（公开，无需认证）servicenow_dev_search 返回 URL，但无法获取完整的 API 文档内容。servicenow_dev_guide 完全获取，无需认证。