用 LaunchDarkly MCP…

在需要通过 LaunchDarkly MCP 将日志、追踪、错误、会话、指标或事件可视化为图表并保存到仪表盘时使用。

适用场景

解决思路

1. 所有 LaunchDarkly MCP 工具调用都要带 projectKey（例如 "default"）。
2. 可用工具包括：list-dashboards 列出现有仪表盘以检查重复或寻找目标；get-dashboard 获取现有仪表盘完整配置（含图表）；create-dashboard 创建新的空仪表盘；preview-graph 内联渲染图表预览但不保存；create-graph 将图表添加到已有仪表盘；get-keys 发现指定 product type 可用的 metrics、attributes、keys。
3. 明确目标仪表盘：如果用户已指定仪表盘（按 ID 或名称），直接把图表加到该仪表盘；否则调用 list-dashboards，让用户选择现有仪表盘或用 create-dashboard 新建。
4. 在构建查询前，针对相关 product type 调用 get-keys 发现数据形状；属性名跨服务不同，例如 service_name、service.name、serviceName，不要猜。
5. 对含糊请求，用普通文本问简短澄清问题，最多 1-2 个。例如：发现多个延迟相关 key 时，问要 P50 还是 P95，以及是否按服务名分组。
6. 对轻微含糊（例如图表类型偏好），采用合理默认值并说明假设。
7. 提交前先调用 preview-graph 给用户展示内联预览，确认后再调用 create-graph；多个图表要逐个预览、逐个确认。
8. 调用 create-graph 创建图表时，枚举大小写要严格使用 enums.md 中的精确值。
9. 创建完成后确认结果：提供仪表盘 URL，并用一句话说明图表展示的内容。
10. 复制或拷贝现有图表时，调用 get-dashboard 获取完整配置（expressions、product type、query、groupBy、display settings），再在 create-graph 中复现这些值；不要只凭图表标题猜测，标题可能已偏离底层配置。
11. 保持简洁，不要叙述中间工具调用；不要写“首先我来发现 keys”“现在我来构建图表”之类前言。必要时只在回复开头写一句简述，例如“正在按级别构建近期日志图表”，之后直接调用工具。
12. 优先创建多个聚焦图表，而不是一个复杂图表；3 个清晰图表优于 1 个含 5 个重叠表达式的图表。
13. 始终在构建查询前调用 get-keys，避免字段名错误导致静默空结果。
14. 按场景选图表类型：Line chart 用于时间序列趋势，例如错误率随时间、延迟百分位、请求量。
15. 按场景选图表类型：Bar chart（或 histogram）用于跨维度比较，例如按服务统计错误、按端点统计请求。
16. 按场景选图表类型：Table 用于包含多个维度的详细分解，图表无法表达细节时使用。
17. 使用 Count 聚合器统计总事件（最常用）；必须传 column=""（空字符串）。
18. 使用 CountDistinct 聚合器统计唯一值，例如用户、会话、flag keys。
19. 使用 Avg、P50、P90、P95、P99 聚合器分析延迟分布。
20. 使用 Sum 聚合器统计数值总量，例如 payload size、revenue。
21. 避免把 productType 写成小写 sessions；应使用 Sessions（PascalCase），参见 enums.md。
22. 不要在 Count 表达式中省略 column；API 要求传空字符串 ""。
23. 不要使用 count_distinct 或 Count_distinct；应使用 CountDistinct（PascalCase，无下划线）。
24. 不要未调用 get-keys 就构建查询，否则属性名错误会导致空结果。
25. get-keys 不要使用仅日期格式（例如 2026-03-04）；需要带时间的完整 ISO 格式，例如 2026-03-04T00:00:00Z。
26. 当用户请求纯粹是可视化数据时，保持在任务范围内，不要调用无关工具。

适用边界 · 注意事项

• 未配置或无法访问远程托管的 LaunchDarkly MCP server，或没有对应 projectKey 时不适用。
• 请求与数据可视化无关时，不要使用这些工具。
• 不适用于非 LaunchDarkly 可观测性数据源或无需保存到 LaunchDarkly 仪表盘的场景。