システム構成図 A: Snowflakeサンプル参照MVP

Cacoo / AWS Documentation風。公式サンプルDBを売上・粗利の代替データとして使い、実装済み経路と将来のSnowflakeネイティブ構成を分離する。

Snowflake参照・シード

Snowflakeアカウント

アプリ実行層

LLMOps運用

利用者

Snowflake参照・シード層

変換・モデリング (dbt)

セマンティック層

Snowpark実行層

AIアクセス層 (Snowflake Cortex)

公式
サンプルDB

TPCH_SF1
学習用

注

注文・明細

売上・数量
割引

地

顧客・地域

国・地域
フィルタ

品

商品・原価

カテゴリ
代替

KPI

KPI定義
マスタ

dbtシード
CSV定義

TPCH
元テーブル

注文・明細
顧客・商品

KPI

KPI定義
マスタ

dbtシード
CSV定義

dbt
ステージング

ソース整理
型・粒度整備

dbt
マート

KPIマート
売上・粗利代替

dbt
テスト

将来の品質検証

KPI
意味モデル

YAML指標定義
ビジネスルール
階層・ルックアップ

Snowpark Python

UDF / SP / dbt Python
評価ランナー
トレース補強

Cortex Search
サービス

定義・指標・週報・ドキュメント
検索・引用取得

Cortex Analyst API

構造化データに対する
KPI質問・SQL生成・分析

Cortex Agents

ツール選択・計画・実行制御
マルチツール調整

KPI閲覧者

売上・粗利代替確認

地域分析者

地域KPIの比較
国/地域フィルタ

データアナリスト

深掘り分析・レポート作成
データ探索

Streamlit UI

サンプルKPI UI
チャット・QA・SQL確認

エージェント
ルーター

問い合わせ分類・ルーティング

プランナー
(LangGraph)

計画立案・ツール選択
状態管理・メモリ

ツール
アダプタ

ツール呼び出しアダプタ
(Cortex / Search / SQL 等)

トレース
ロガー

実行トレース記録
(入力・出力・コスト等)

GitHub
リポジトリ / CI

dbt / SQL / YAML / プロンプト
ユーティリティ・コード
テスト・データ検証

CI / CD

GitHub Actions
dbtビルド / テスト
pytest / 評価
セマンティック検証

ゴールデン評価

(回帰評価セット)
質問セット・期待値
正解SQL・結果
評価基準・閾値

トレース保存

トレース保存
クエリ・レスポンス
メトリクス・コスト

版管理
レジストリ

プロンプト・エージェント
dbt / セマンティックモデル
版管理

エラー分類

エラー分類・原因分析
改善アクション管理

人手レビュー

低信頼・エッジケース確認
承認・修正・コメント

RBAC / アクセス制御

ロール・権限管理（最小権限）
データ・機能アクセス制御

コスト
ガードレール

予算アラート・上限制御
トークン・クエリコスト監視

Snowflake参照

ロール別UI導線

dbtビルド / テスト
モデル・指標デプロイ

質問・文脈

回答・可視化

UI実行入口論理分岐

文書・参照

KPI定義参照

検索根拠

ツール呼び出し

実行先呼び出し

実行・制御

dbt Python
UDF / SP

評価 / トレース
拡張

実行ログ保存

改善適用（バージョン更新）

指標定義 / プロンプト改善

評価結果保存

失敗トレース / 回帰候補

設定差分参照

権限・コスト制約

トレース /
メトリクス

承認結果 /
フィードバック

修正依頼

サンプルDB

参照・シード層

エージェント実行