create-graph

创建图表和仪表板

前提条件

此技能使用以下 LaunchDarkly MCP 工具：

• preview-graph — 内嵌渲染图表预览，但不保存
• create-graph — 将图表添加到现有仪表板
• create-dashboard — 创建新的空仪表板
• list-dashboards — 列出现有仪表板
• get-dashboard — 获取仪表板的完整配置，包括其中的图表
• get-keys — 查找某种产品类型可用的指标、属性和键

所有这些工具都需要 projectKey（例如 "default"）。

概述

你正在构建可观测性图表。这些工具对参数要求很严格——枚举值一旦填错，API 就会拒绝调用。构建查询前务必先使用 get-keys，确认维度名称确实存在。

功能

• list-dashboards — 列出现有仪表板，以检查重复项或查找目标
• get-dashboard — 获取现有仪表板的完整配置，包括其中的图表
• create-dashboard — 创建新仪表板
• preview-graph — 内嵌渲染图表预览
• create-graph — 将图表添加到仪表板
• get-keys — 查找某种产品类型可用的指标、属性和键

如果用户的请求纯粹是数据可视化，请专注于当前任务，不要调用无关工具。

工作流

1. 确定目标仪表板。 如果用户已经指定了某个仪表板（按 ID 或名称），就直接向其中添加图表。否则，调用 list-dashboards，询问用户是要使用现有仪表板，还是用 create-dashboard 创建一个新的。
2. 了解数据结构。 构建查询前，先针对相关产品类型调用 get-keys。不同服务的属性名称可能各不相同，例如 service_name、service.name 或 serviceName。猜测只会浪费工具调用。
3. 如果请求含糊不清，请用普通文本简短询问。 例如：“我找到了几个与延迟相关的键。你想要 P50 还是 P95 延迟？要按服务名称分组吗？”澄清问题要简短，最多一两个。若只是轻微歧义（例如图表类型偏好），请合理默认，并说明你的假设。
4. 提交前先预览。 先调用 preview-graph，向用户展示内嵌预览并征求确认，然后再调用 create-graph。如果要创建多个图表，请逐个预览并确认。
5. 使用 create-graph 创建图表。 枚举值的大小写必须与 enums.md 完全一致。
6. 确认创建结果——提供仪表板 URL，并用一句话说明图表展示的内容。

复制现有图表

如果用户要求复制或克隆图表，请调用 get-dashboard 获取完整配置（表达式、产品类型、查询、groupBy 和显示设置），然后在 create-graph 中复用这些值。不要只根据图表标题猜测——标题可能与底层配置不一致。

指南

• 保持简洁，不要叙述中间的工具调用。 不要使用“首先，我来查找键”或“现在我来构建图表”之类的开场白。如有需要，开头用一句简短的话即可（例如“正在按级别构建近期日志图表。”）；之后直接调用工具。
• 优先创建多个重点明确的图表，而不是一个复杂图表。 包含 3 个清晰图表的仪表板，胜过包含 5 个相互重叠表达式的单个图表。
• 构建查询前务必调用 get-keys。 这样可以避免字段名称错误导致结果悄无声息地为空。

图表类型选择

• Line chart — 用于展示时间序列趋势，例如随时间变化的错误率、延迟百分位数和请求量。
• Bar chart（或直方图）— 用于比较不同维度的数据，例如按服务统计的错误数、按端点统计的请求数。
• Table — 用于展示涉及多个维度的详细分类数据，尤其是在图表无法清楚呈现这些细节时。

聚合器

• Count — 事件总数（最常用）。需要 column=""（空字符串）。
• CountDistinct — 不重复值。用户、会话、标记键。
• Avg、P50、P90、P95、P99 — 延迟分布。
• Sum — 数值总和（负载大小、收入）。

常见错误

• 将小写的 sessions 用作 productType。正确值为 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。