エージェント スキル

メリディアンには、マーケティング ミックス モデリング(MMM)のライフサイクル全体でデータ サイエンティストやエンジニアを支援するように設計された、インタラクティブなエージェント スキルのスイートが用意されています。

エージェント スキルは、オープンなエージェント スキル仕様に準拠しており、AI コーディング アシスタントに分野固有の専門知識を提供します。これにより、データの準備、事前分布の構成、モデルの適合、診断の分析、予算の最適化、シナリオの計画を支援できます。


エージェント スキルとは

エージェント スキルは、指示、参照テンプレート、スクリプトを含む、モジュール化と標準化がなされた機能パッケージです。AI コーディング アシスタントに統合すると、エージェントはスキルを利用して次のことが可能になります。

  • 手順ごとの詳しいガイド: API 全体を記憶する必要なく、複雑な統計構成を操作できます。
  • スキーマ マッピングの推論: 元の CSV 列ヘッダーを分析し、KPI、メディア費用、インプレッション、リーチ / 頻度、コントロール変数に適切なマッピングを提案します。
  • 人間参加型の制御の維持: 重要なチェックポイントで構成の提案(ベイズ事前分布、ノットの選択、費用制約など)を提示し、ユーザーの確認を得たうえで実行します。
  • 再現可能な Python スクリプトの生成: 標準の Python 仮想環境(python3 script.py)で直接実行可能なスタンドアロンの Python スクリプトを生成します。

利用可能なメリディアン スキル

メリディアンには、MMM ジャーニーの各ステージをカバーする 5 つの専門スキルが含まれています。

スキル 識別子 説明 主な出力
ドキュメント コンサルタント meridian-doc-consultant 関連するメリディアンのドキュメントを引用して、概念、数学、構成に関する質問に回答します。 グラウンディングされた技術的な説明とリファレンス
モデルの構築 meridian-model-building CSV データの読み込み、列のマッピング、ModelSpec と事前分布の設定、探索的データ分析(EDA)、MCMC フィッティング、モデルの保存について説明します。 Python スクリプト、EDA HTML レポート、保存されたモデルファイル(.binpb
結果のビジュアリゼーション meridian-result-visualization 適合モデルを読み込んで、MCMC 収束ヘルスチェック(Reviewer)と 2 ページの概要レポート(Summarizer)を生成します。 ヘルスチェック HTML、概要結果 HTML
予算の最適化 meridian-budget-optimization 固定または柔軟な予算の最適化と目標 ROI の費用シナリオを構成して実行します。 予算最適化レポートの HTML
シナリオ プランナー meridian-scenario-planner シナリオ プランナーのデータを準備し、Looker Studio ダッシュボードを作成するための引き継ぎ手順を提供します。 シナリオ プランナーのデータファイル(.binpb)、ダッシュボードの URL

インストールと検出

メリディアン スキルはオープンソース リポジトリで直接配布され、標準のエージェント ツールを使用してワークスペースに追加できます。

Skills CLI を使用してインストールする

お使いの環境に Node.js / npm がインストールされている場合は、npx skills を使用してすべてのメリディアン スキルまたは特定の個別スキルをインストールできます。

# Install all Meridian skills into your workspace
npx skills add google/meridian
# Or install a specific skill (e.g., model building)
npx skills add google/meridian --skill meridian-model-building

手動またはリポジトリ内での検出

npx を使用しない場合や、純粋な Python 環境で作業している場合は、次の操作を行います。

  • リポジトリ内検出:google/meridian リポジトリ内で直接クローンを作成または開発する場合、互換性のある AI コーディング アシスタントが、.agents/skills.json のワークスペース マニフェストと skills/ ディレクトリを使用して、利用可能なすべてのスキルを自動的に検出します。
  • 手動コピー: skills/ サブフォルダ(meridian_model_building/ など)をリポジトリからプロジェクトの .agents/skills/ ディレクトリに直接コピーできます。

対応している環境

メリディアン スキルは、オープンなエージェント スキル仕様に基づいて構築されています。オープン標準(標準の Markdown 指示とモジュラー Python テンプレート)を使用しているため、エージェント スキル標準に対応するあらゆるエージェント コーディング環境、IDE 拡張機能、CLI ツールと互換性があります。


人間参加型の安全性と検証

メリディアン スキルは、チェックポイント駆動型設計に従います。インタラクティブ セッション中、次の処理を行う前にエージェントは一時停止し、ユーザーに確認を求めます。

  1. データセットの列マッピングを確定する。
  2. ベイズ事前分布パラメータ(ROI の事前分布やノット間隔など)を設定する。
  3. 長時間の MCMC 事後分布サンプリング ジョブを実行する。
  4. 生成されたスクリプトをローカル環境に対して実行する。

これにより、自動スクリプト作成のメリットを得ながら、モデリングの決定に関する完全な可視性と制御を維持できます。