需要查 Coralogix 官方产品文档时：用 cx…

当用户询问 Coralogix 平台功能、配置、UI 操作、集成、API key、告警/SLO/仪表盘等官方文档而非租户实时遥测数据时，用 `cx docs search` + `cx docs fetch` 检索并阅读官方文档。

适用场景

解决思路

1. 用 `cx docs search <query>` 按关键词查找 Coralogix 官方文档页；结果返回带编号的标题和 `/docs/` 下的路径后缀。
2. 用 `cx docs fetch <suffix>` 下载单个文档页为 markdown；传入从 `cx docs search` 得到的 suffix。
3. 在 `search` 命令上用 `--limit` 控制最大结果数，范围 1–20，默认 5。
4. 两个命令都可用 `-o json` 或 `-o toon` 输出机器可读结果。
5. 可直接参考示例：`cx docs search "explore spans" --limit 5`；`cx docs search "OpenTelemetry traces"`；`cx docs fetch user-guides/data_exploration/spans/`；`cx docs search "API keys" -o json`。
6. 标准流程：先用 2–4 个聚焦关键词执行 `cx docs search`，不要用完整句子。
7. 从搜索结果中选择最相关的 suffix。
8. 对该 suffix 执行 `cx docs fetch`。
9. 基于 fetch 到的内容回答；仅在需要时再 fetch 其他页面。
10. 示例流程：用户问 "How do I show spans in the Coralogix website?" 时，先执行 `cx docs search "explore spans" --limit 5`，再执行 `cx docs fetch user-guides/data_exploration/spans/`，然后总结 Explore → spans dataset → Spans/Traces/Flows tabs → drilldown。
11. `cx docs search` 技巧：从 2–4 个聚焦词开始，不要用完整句子。
12. 若无匹配，尝试同义词或更宽泛词，例如用 `"tracing"` 代替 `"distributed trace waterfall view"`。
13. 当第一页命中含糊时，增大 `--limit`。
14. 搜索结果使用 `/docs/` 下的路径后缀而非完整 URL；将这些后缀直接传给 `cx docs fetch`。
15. `cx docs fetch` 技巧：传入来自 `cx docs search` 的 suffix，例如 `user-guides/data_exploration/spans/`；完整 URL 会被拒绝。
16. `cx docs fetch` 一次只取一个页面；先选最佳匹配。
17. 排障：无搜索结果时，放宽或改写查询；尝试“功能名 + 类别”，如 `"spans UI"`、`"OTel ingestion"`。
18. 排障：fetch 到的页面太窄时，搜索父主题，或用相关词再搜一次。
19. 排障：用户想要自己的实际数据时，切换到 `cx logs`、`cx spans`、`cx metrics` 或 alerts；文档描述产品，不包含租户内容。
20. 相关替代：遥测查询用 `cx-telemetry-querying`；告警用 `cx-alerts`；仪表盘用 `cx-dashboards`。

适用边界 · 注意事项

• 不适用于查询租户的实时 logs/spans/traces/metrics/alerts/cases，也不适用于发现租户数据中的字段路径；这些应改用 `cx logs`、`cx spans`、`cx metrics`、`cx alerts`、`cx cases`、`cx search-fields`。
• 不适用于查询 DataPrime 语法/命令；应改用 `cx dataprime list` / `cx dataprime show`。
• 当问题不依赖 Coralogix 当前产品行为或 UI 导航，或环境中没有 Coralogix `cx` CLI/无法访问 Coralogix 官方文档时，不适用。