mcpField
C
creating-box-plot-insights

creating-box-plot-insights

github.com/posthogデータ・データベース7657 回インストール今日更新
リポジトリ

creating-box-plot-insights について

イベントデータまたは HogQL から PostHog の箱ひげ図インサイトを作成するスキルです。クエリ方式の選択から分布の検証、保存、結果確認までを案内します。

主な機能

  1. 01Trends または SQL の選択
  2. 02数値プロパティによる箱ひげ図作成
  3. 03HogQL の要約統計の検証
  4. 04PostHog インサイトの保存と確認

活用シーン

  1. 01イベントプロパティの時間別分布の可視化
  2. 02独自のグループ化や結合による分布の作図
  3. 03保存済み箱ひげ図のクエリと結果の確認

MCP 対応

PostHog MCP ツールで Trends または SQL クエリを実行し、インサイトを作成して、保存済みの結果を取得・検証します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/posthog/skills --skill creating-box-plot-insights

インストール後、Claude Code で/creating-box-plot-insightsを入力して読み込まれたか確認します。

同梱ファイルreferences/sql-examples.md

詳細

ボックスプロットのインサイトの作成

ボックスプロットには分布データが必要で、事前に集計された平均値や合計値では作成できません。ユーザーの質問を表現できる、最もシンプルなクエリタイプを選んでください。

クエリタイプの選択

以下のすべてに当てはまる場合は、標準のプロダクト分析ボックスプロットを使用します。

  • Trends がサポートするイベント、アクション、またはウェアハウステーブルがデータソースである。
  • 分布する値を含む数値プロパティが 1 つある。
  • ユーザーが通常の時間範囲での分布を求めている。

ユーザーがカスタムのグループ化、結合、派生値、または独自の SQL を必要とする場合は、SQL ボックスプロットを使用します。HogQL を記述する前に querying-posthog-data を読み、references/sql-examples.md を出発点として使用してください。

標準的な Trends クエリを再現するためだけに SQL を使用しないでください。

標準のプロダクト分析ボックスプロット

  1. イベントまたはアクションと、その数値プロパティを特定します。保存する前に、プロパティが数値であることを確認してください。
  2. ソースが TrendsQuery の InsightVizNode を構築します。
    • 系列のイベントまたはアクションを設定します。
    • math_property に数値プロパティを設定します。
    • trendsFilter.display に BoxPlot を設定します。
    • 質問に合った日付範囲と間隔を選択します。
  3. posthog:query-trends でクエリを実行します。
  4. 分布の行が返された場合は、posthog:insight-create で保存します。
  5. posthog:insight-get で読み戻し、プロパティ、間隔、表示形式を確認します。

数値の math_property がないボックスプロットは無効です。ユーザーが分布する値としてイベント数を求めている場合を除き、イベント数で代用しないでください。

SQL ボックスプロット

SQL は、X 軸と系列の各組み合わせに対して、事前に集計した 1 行を返す必要があります。データベースでサマリーを計算してください。クライアントで、取得件数が制限された結果の行からパーセンタイルを計算してはいけません。

必要な数値の役割：

  • 最小値
  • 25 パーセンタイル
  • 中央値
  • 平均値
  • 75 パーセンタイル
  • 最大値

最も扱いやすい結果形式では、次のエイリアスを使用します。

x, series, min, p25, median, mean, p75, max

x と series は省略可能です。

  • 全体で 1 つの分布にする場合、または系列ごとにボックスを 1 つ表示する場合は、xAxisColumn を null に設定します。
  • 系列を 1 つだけにする場合は、seriesColumn を null に設定します。

保存する前に posthog:execute-sql で HogQL を検証します。次の点を確認してください。

  • 必要な統計値がすべて数値である。
  • 各行で min <= p25 <= median <= p75 <= max が成り立つ。
  • 平均値が最小値と最大値の間にある。
  • X 軸と系列の各組み合わせが 1 回だけ出現する。
  • 系列は最大 200 個、X 軸と系列の組み合わせは最大 10,000 個である。

次の形式を posthog:insight-create で保存します。

{
  "query": {
    "kind": "DataVisualizationNode",
    "source": {
      "kind": "HogQLQuery",
      "query": "<validated HogQL>"
    },
    "display": "BoxPlot",
    "chartSettings": {
      "boxPlot": {
        "xAxisColumn": "x",
        "seriesColumn": "series",
        "minColumn": "min",
        "p25Column": "p25",
        "medianColumn": "median",
        "meanColumn": "mean",
        "p75Column": "p75",
        "maxColumn": "max",
        "excludeOutliers": true
      }
    }
  }
}

クエリで異なる名前を使用している場合は、実際のエイリアスを使用します。6 つの統計値を、それぞれ Y 軸の系列として割り当てないでください。

保存したインサイトの検証

  1. posthog:insight-get で保存したインサイトを読み込みます。
  2. posthog:insight-query で実行します。
  3. 結果に想定した列があり、ボックスごとに 1 行あることを確認します。
  4. インサイトのリンク、分布する数値、そのグループ化の選択を報告します。

行ごとのサマリーに欠損または無効な値がある場合、PostHog はそのボックスを省略し、有効なボックスは表示したままにします。省略されるボックスが想定外の場合は、SQL を修正してください。

関連スキル

  • querying-posthog-data - SQL ボックスプロットの HogQL を作成または変更する前に必要です。
  • formatting-insight-axes - 値の軸に通貨、期間、パーセンテージ、またはその他の書式設定が必要な場合に使用します。
  • building-a-dashboard - ボックスプロットをダッシュボード上の他のインサイトと一緒に配置する場合に使用します。

コメント

Markdown 対応