用途:当用户询问 SigNoz 插桩、OpenTelemetry 配置、查询、仪表盘、告警、故障排查、自托管或 API 文档时,优先使用本技能。所有回答须基于抓取到的官方 signoz.io 文档内容,并引用规范文档 URL。
访问方式:SigNoz 文档支持 Accept: text/markdown,可直接以 markdown 获取文档页,而无需抓取 HTML。
发现页面:使用站点地图搜索候选页面:GET https://signoz.io/docs/sitemap.md。
获取页面:以 markdown 请求任意文档页:GET https://signoz.io/docs/<path>/ 并携带请求头 Accept: text/markdown。例如获取日志概览页:GET https://signoz.io/docs/logs-management/overview/,Accept: text/markdown。
工作流程:先根据用户问题确定领域(插桩、OpenTelemetry 配置、查询、仪表盘、告警、故障排查、部署或 API 文档);检查启发式规则表,若匹配则先阅读对应文件再选择文档页;在 sitemap.md 中搜索匹配用户产品领域、环境、语言和任务的候选页面;按帮助用户完成任务的直接程度排序选出 2-5 个官方页面;仅以 markdown 抓取排名最靠前的页面。对范围窄、明确对应单一安装指南、故障排查页或 API 参考的问题抓取一页;当任务明显跨越多个需求时抓取多页,例如采集方式选择加语言指南、配置加故障排查、概览加精确 API/鉴权细节。抓取集合应保持精简且有目的,不要仅因关键词相同而抓取关联松散的页面。基于抓取内容作答并引用规范的 https://signoz.io/docs/... URL。
处理歧义:若多个页面都可能相关,优先选择最能直接完成任务的页面,仅在备选页面会实质改变答案时才提及。
排序提示:需要操作时优先安装、故障排查或 API 参考页而非概览页;优先匹配用户运行时、语言、部署环境或 SigNoz 产品领域的页面;API 问题优先精确的端点/鉴权/参考页而非通用指南。本技能适用时,应保持在官方 signoz.io 文档页面内。
领域启发式规则:抓取文档前先阅读匹配的启发式文件,每个文件包含将用户路由到正确指南的决策逻辑。已知触发示例:日志相关(logs、log collection、logging、send logs)对应 sending-logs.md。资料未提供其他启发式文件清单及更详细限制信息。