用途
create-graph 用于构建可观测性图表和仪表盘。它从日志、追踪、错误、会话、指标和事件数据中生成图表，可先内联预览，再保存到 LaunchDarkly 仪表盘。该技能面向需要将可观测性数据可视化的场景，帮助用户把查询结果转化为可复用的图表。
主要能力
该技能依赖以下 LaunchDarkly MCP 工具：
- preview-graph — 内联渲染图表预览，不保存。
- create-graph — 向已有仪表盘添加图表。
- create-dashboard — 创建新的空仪表盘。
- list-dashboards — 列出已有仪表盘。
- get-dashboard — 获取仪表盘的完整配置，包括其图表。
- get-keys — 发现某产品类型可用的指标、属性和键。
所有工具都需要 projectKey（例如 "default"）。
使用方式
工作流程如下：
- 确定目标仪表盘。如果用户已有特定仪表盘（按 ID 或名称），直接向其添加图表。否则调用 list-dashboards，提供定位已有仪表盘或使用 create-dashboard 新建的选项。
- 发现数据形态。在构建查询前，针对相关产品类型调用 get-keys。属性名称因服务而异（service_name、service.name、serviceName 等），猜测会浪费工具调用。
- 对模糊请求，以普通文本提出简短澄清问题。例如："我找到了几个与延迟相关的键。您想要 P50 还是 P95 延迟，是否按服务名分组？"澄清保持简短，最多一两个问题。对于轻微歧义（如图表类型偏好），做出合理默认并说明假设。
- 提交前先预览。先调用 preview-graph，向用户展示内联预览，确认后再调用 create-graph。多个图表时，逐个预览并确认。
- 使用 create-graph 创建图表，使用 enums.md 中精确的枚举大小写。
- 确认创建结果——提供仪表盘 URL 和图表内容的一行描述。
复制已有图表时，调用 get-dashboard 获取完整配置（表达式、产品类型、查询、groupBy、显示设置），然后在 create-graph 中复现这些值。不要仅凭图表标题猜测——标题可能与底层配置不一致。
图表类型与聚合器
图表类型选择：
- 折线图 — 时间序列趋势。如随时间变化的错误率、延迟百分位、请求量。
- 柱状图（或直方图）— 跨维度比较。如按服务的错误、按端点的请求。
- 表格 — 多维度详细分解，图表无法传达细节时使用。
聚合器：
- Count — 事件总数（最常用）。需要 column=""（空字符串）。
- CountDistinct — 唯一值。如用户、会话、标志键。
- Avg、P50、P90、P95、P99 — 延迟分布。
- Sum — 数值总计（如负载大小、收入）。
适用场景
适用于需要从可观测性数据创建仪表盘和图表的场景，例如监控错误率、延迟分布、请求量、按服务或端点比较指标等。也适用于复制或复用已有图表配置。
限制与注意事项
常见错误包括：
- 将 productType 写成小写 sessions。应为 Sessions（PascalCase）。参见 enums.md。
- 在 Count 表达式上省略 column。API 要求该字段，需传空字符串 ""。
- 使用 count_distinct 或 Count_distinct。应为 CountDistinct（PascalCase，无下划线）。
- 未先调用 get-keys 就构建查询，因属性名错误而得到空结果。
- 对 get-keys 使用仅日期格式（2026-03-04）。需要带时间的完整 ISO 格式：2026-03-04T00:00:00Z。
指南：保持简洁，不要叙述中间工具调用；优先使用多个聚焦的图表而非一个复杂图表；构建查询前始终调用 get-keys。