核心功能
servicenow-docs 是一套面向 ServiceNow 平台的综合文档检索技能,通过官方 Zoomin API 和 developer.servicenow.com 接口,提供两类核心能力:
平台文档检索(docs.servicenow.com)
servicenow_search: 搜索产品文档、发行说明、配置指南servicenow_get_article: 获取完整文章内容servicenow_list_versions/servicenow_latest_release: 版本管理与最新补丁追踪
开发者文档检索(developer.servicenow.com)
servicenow_dev_suggest: API 自动补全建议servicenow_dev_search: 开发者 API、指南搜索servicenow_dev_guide: 获取 PDI 指南、开发者项目文档等完整内容
显著优势
1. 来源权威性:直接对接 ServiceNow 官方文档系统,内容经官方维护更新
2. 版本覆盖全:支持按版本过滤(Washington DC、Zurich、Yokohama 等),可追溯历史补丁
3. 场景适配佳:既满足管理员查询平台配置,也支持开发者检索 GlideRecord、GlideAjax、openFrameAPI 等脚本 API
4. URL 自动优化:内部 Zoomin API 结果自动转换为用户友好的 docs.servicenow.com 链接
局限性与风险
1. API 参考内容限制:servicenow_dev_search 仅返回 API 页面 URL,无法直接拉取完整 API 文档内容,需用户浏览器访问
2. 版本时效性:搜索结果可能包含多版本内容,需主动指定 version 参数确保准确性
3. 无实时实例连接:仅提供文档查询,无法直接操作用户的 ServiceNow 实例
4. 依赖外部服务:Zoomin 和 developer.servicenow.com 的可用性直接影响技能响应
适用人群
- ServiceNow 管理员(查询配置、补丁、发行说明)
- 平台开发者(检索 Glide API、脚本模式、最佳实践)
- ITSM 顾问(研究平台功能边界与版本特性)
- 学习培训人员(获取官方 PDI 指南和入门文档)
安全评估
技能仅执行只读文档查询,不修改任何数据,也不访问用户实例。但开发者 API 返回的第三方链接需用户自行甄别,建议优先使用 servicenow_dev_guide 获取可直接渲染的官方指南内容。