用途:在用户询问 SigNoz 相关“怎么做”“文档怎么说”“文档在哪”等问题时,检索并依据官方文档作答,答案需引用规范文档 URL。
主要能力:优先使用 SigNoz MCP 工具 signoz_search_docs(关键词检索,传 2 至 6 个关键词,保留产品与技术名称,去掉“how do I”等填充词;单一术语问题只传该术语;含两个意图的问题拆成两次调用;可用 section_slug 缩小范围)与 signoz_fetch_doc(按规范 URL 或 /docs/... 路径获取单页 markdown,可用 heading 缩小范围)。需检查 truncation_reason 与 available_headings,若因 size 截断则按最相关标题重新抓取;仍不完整应说明文档不完整,不得推断缺失内容不存在。
回退方式:MCP 不可用时直接 HTTP 抓取,文档原生支持 Accept: text/markdown。先 GET https://signoz.io/docs/sitemap.md 发现页面,再 GET https://signoz.io/docs/<path>/ 并带 Accept: text/markdown。
使用方式:先判断问题领域(埋点、OpenTelemetry 配置、查询、仪表盘、告警、排障、部署、API 文档),匹配启发式表则先读对应文件;再检索并抓取 1 至 3 个结果,窄问题抓一页,跨设置与排障可抓多页但保持精简;最后依据抓取内容作答并引用规范 URL。终端答案需按规范发出 open_docs(主引用页规范 URL)与 1 至 2 条 follow_up,不要发出 apply_filter。
限制:不得凭记忆构造 /docs/... URL,只能使用检索返回的 URL;signoz_fetch_doc 不接受 signoz:// 资源 URI;不得以空 searchText 调用检索,也不得无 URL 调用抓取;启发式覆盖有限,无对应条目时按 sitemap 分区浏览并优先设置、排障与 API 参考页。资料未提供具体收费、平台与效果信息。