核心用法
servicenow-docs 是专为 ServiceNow 平台开发者和管理员设计的文档检索技能，通过 Zoomin API 直连官方文档库 docs.servicenow.com。提供三大核心能力：
1. 智能搜索 (servicenow_search) —— 支持关键词检索 API 参考、脚本指南、平台功能文档，可按版本（如 Washington DC、Zurich）过滤结果
2. 全文获取 (servicenow_get_article) —— 根据搜索结果 URL 拉取完整文档内容，便于深度阅读与技术实现
3. 版本管理 (servicenow_list_versions) —— 列举可用文档版本，确保查询与当前实例版本匹配
典型场景包括：GlideRecord/GlideQuery API 用法查询、Business Rule 编写规范、脚本调试参考、平台新特性了解等。
显著优点
- 官方权威信源：直接对接 ServiceNow 官方文档数据库，内容准确性远超社区二手资料
- 版本精准匹配：支持按具体发行版过滤，避免版本差异导致的 API 行为误判
- 开发效率提升：无需离开对话环境即可获取技术参考，缩短问题排查周期
- 结构化输出：搜索结果包含标题、摘要、URL 等元信息，便于快速定位目标内容
潜在缺点与局限性
- 依赖外部 API：Zoomin API 可用性直接影响技能功能，存在单点故障风险
- 无离线缓存：每次查询实时拉取，网络延迟可能影响响应速度
- 权限边界模糊：未明确说明是否需要 ServiceNow 实例认证，部分企业文档可能受限
- 结果相关性依赖：复杂技术问题的搜索效果取决于关键词质量，可能需要多次迭代
适合人群
- ServiceNow 开发者（Script Include、Client Script、Business Rule 编写者）
- 平台管理员与配置专家
- ITSM/ITOM 实施顾问
- 准备 ServiceNow 认证考试的技术人员
常规风险
- 信息时效性：API 行为随版本更新可能变化，建议结合实例版本验证
- 生产环境慎用：文档示例代码直接用于生产前需充分测试，避免性能或安全副作用
- 数据出境注意：查询通过
servicenow-be-prod.servicenow.com域名，企业敏感信息场景需评估合规性