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 のどちらのレイテンシが必要ですか、またサービス名でグループ化しますか?」確認は短く保ってください — 質問は最大で 1 つか 2 つです。軽微なあいまいさ（チャートタイプの好み）については、妥当なデフォルトを選び、その前提を記載してください。
4. 確定する前にプレビューします。 まず preview-graph を呼び出し、ユーザーにインラインプレビューを表示し、create-graph を呼び出す前に確認します。複数のグラフの場合は、1 つずつプレビューして確認します。
5. create-graph でグラフを作成します。 enums.md の列挙値の大文字小文字を正確に使用してください。
6. 作成された内容を確認します — ダッシュボードの URL と、そのグラフが何を示すかの 1 行の説明を提示します。

既存のグラフを複製する

グラフの複製またはコピーを求められた場合は、get-dashboard を呼び出して完全な設定（式、プロダクトタイプ、クエリ、groupBy、表示設定）を取得し、それらの値を create-graph で再現します。グラフのタイトルだけから推測しないでください — タイトルは基になる設定からずれることがあります。

ガイドライン

• 簡潔にしてください — 途中のツール呼び出しを実況しないでください。 「まず、キーを検出しましょう」や「ではチャートを構築します」といった前置きは省いてください。必要であれば、返信の冒頭に短い一文を添えるだけで十分です（例:「最近のログをレベル別にチャート化します。」）。その後は、ただツールを呼び出すだけにしてください。
• 1 つの複雑なグラフよりも、複数の焦点を絞ったグラフを優先してください。 3 つのすっきりしたグラフがあるダッシュボードは、5 つの重複する式を持つ 1 つのグラフに勝ります。
• クエリを構築する前に必ず get-keys を呼び出してください。 誤ったフィールド名による、気づかないうちの空の結果を防ぎます。

チャートタイプの選択

• Line chart — 時系列の傾向。時間経過に伴うエラー率、レイテンシのパーセンタイル、リクエスト量。
• Bar chart（またはヒストグラム） — ディメンション間の比較。サービス別のエラー、エンドポイント別のリクエスト。
• Table — チャートでは詳細を伝えきれない、複数のディメンションを持つ詳細な内訳。

アグリゲーター

• 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。