• LOGIC
  • METRIC
  • HUMAN
  • CLEAN

AIエージェントでSQLロジックの監査を自動化する方法

Mode Analyticsをエージェントに接続すれば、ダッシュボードの背後にあるコードを詳細に検証できます。接続後は、AIがクエリや定義をスキャンしてミスを特定します。

このページについてAIに聞く

すぐに答え

AIを使ってMode AnalyticsのSQLをチェックできますか?

エージェントがModeから特定のクエリやフィールド定義を直接取得します。そのロジックを、あらかじめ設定したメトリクスのルールと比較することで、不一致を特定します。コードが要件からどのように逸脱しているか、詳細な内訳を確認できます。

検出された問題の分類

監査結果の分類

AIはModeワークスペース内で見つかった内容を以下のカテゴリに分類します。

LOGIC

SQLロジックの不備

構文エラーや結合(JOIN)のミスを特定します。実行できないクエリや、誤ったデータを返すクエリのリストを作成します。

METRIC

定義の不一致

計算フィールドの定義とビジネスルールを比較します。メトリクスの計算がドキュメントと一致しない場合にフラグを立てます。

HUMAN

手動確認が必要

AIが判断しにくい曖昧なロジックを見つけた場合、確認を促します。コードが本当に間違っているのか、あるいはAIが認識できない書き方なのかを判断してください。

CLEAN

検証済みコード

SQLが意図したメトリクスと一致していることを確認します。監査を通過したクエリの要約を受け取れます。

ワークフロー

監査開始時にAIが行うプロセス

エージェントがModeワークスペース内を移動し、生のロジックを収集します。

  1. クエリの収集

    Modeワークスペースをスキャンし、レポートで使用されている特定のSQLコードを見つけ出します。

    list_mode_queries
  2. 定義の確認

    計算フィールドの基となるロジックを取得し、メトリクスが実際にどのように構築されているかを確認します。

    list_mode_definitions
  3. レポートの検証

    レポートの出力データを確認し、出力結果がクエリのロジックと一致しているかを検証します。

    get_mode_report
  4. エラーの特定

    収集したデータと指示内容を比較し、不一致がある箇所をハイライトします。

    list_mode_queries

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って監査を開始できます。

出発点

括弧内のテキストを、実際のModeレポート名やフィールド名に書き換えて使用してください。

Mode Analytics Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_SRi8OhPiH6AqqyQpnSFSA21WRVtjdvVcCqhb8EAY/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Mode Analytics capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "mode-analytics-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SRi8OhPiH6AqqyQpnSFSA21WRVtjdvVcCqhb8EAY/mcp"
    }
  }
}
チャットにコピー04
  • 'Marketing Dashboard'内のすべてのクエリをリストアップし、収益計算が正しいか確認してください。

  • 'User Growth'レポートにある計算フィールド 'active_users' の定義を教えてください。

  • 'Sales Performance'クエリのSQLを監査し、重複した結合が発生していないか確認してください。

  • 'Monthly Churn'レポートのロジックを、以下のビジネスルールと比較してください: [ルールを貼り付け]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

Mode Analyticsを一度接続すれば、すぐに質問できます。

Vinkiusのダッシュボードからアカウントを連携するだけです。認証情報は暗号化されて保持されるため、すぐにModeのデータについてエージェントに質問を開始できます。

Mode AnalyticsをAIと連携する

FAQ

監査の動作について

  • 01

    AIはMode内のSQLクエリを書き換えることができますか?

    いいえ。AIができるのはクエリと定義の読み取りのみです。コードの編集は、Mode上で手動で行う必要があります。

  • 02

    AIはModeのすべてのレポートを見ることができますか?

    コネクタツールを通じてアクセス権限を与えたレポートやクエリであれば、AIはそれらを確認できます。

  • 03

    AIは新しい計算フィールドを作成できますか?

    いいえ。エージェントは既存の定義をリストアップして検証することのみ可能です。Modeに新しいフィールドを書き込むことはできません。

  • 04

    メトリクスが「間違っている」とAIはどうやって判断するのですか?

    プロンプトの中で、比較対象となる正しいロジックやビジネスルールを提示する必要があります。それに基づいて判断を行います。

  • 05

    既存のModeダッシュボードでも動作しますか?

    はい。ダッシュボードが、エージェントがアクセス可能なクエリや計算フィールドを使用していれば問題なく動作します。

  • Mode Analyticsに関するその他の質問は、コネクタのページで確認できます。 Mode Analytics Connectorの全機能を見る

『Mode Analytics』を Claude、Cursor、ChatGPT などに接続