システム構成図 A: 実小売取引MVP

Cacoo / AWS Documentation風。Online Retail IIの実小売取引とRAIOPS-24/39の限定live経路を使い、client-side orchestratorが現在のrouting owner、native Cortex Agentsは有償プラン移行後の再評価候補であることを分離する。

実小売取引・シード

Snowflakeアカウント

アプリ実行層

LLMOps運用

利用者

実小売取引・シード層

変換・モデリング (dbt)

セマンティック層

Snowpark実行層

AIアクセス層 (Snowflake Cortex)

実小売
取引データ

Online Retail II
UCI / CC BY 4.0

注

注文・明細

売上・数量
実取引

地

顧客・地域

国・地域
フィルタ

品

商品
明細

コード・説明
原価は未対応

KPI

KPI定義
マスタ

dbtシード
CSV定義

実取引
RAWテーブル

注文・明細
顧客国・商品

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
(native)

有償プラン移行後の
再評価候補

KPI閲覧者

売上・粗利代替確認

地域分析者

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

データアナリスト

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

Streamlit UI

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

Client-side Agent
Orchestrator

routing owner
Search / Analyst backend

プランナー
(LangGraph)

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

ツール
アダプタ

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

トレース
ロガー

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

GitHub
リポジトリ / CI

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

CI / CD

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

ゴールデン評価

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

トレース保存

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

版管理
レジストリ

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

エラー分類

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

人手レビュー

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

RBAC / アクセス制御

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

コスト
ガードレール

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

実データロード

ロール別UI導線

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

質問・文脈

回答・可視化

UI実行入口論理分岐

文書・参照

KPI定義参照

検索根拠

ツール呼び出し

実行先呼び出し

実行・制御

dbt Python
UDF / SP

評価 / トレース
拡張

実行ログ保存

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

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

評価結果保存

失敗トレース / 回帰候補

設定差分参照

権限・コスト制約

トレース /
メトリクス

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

修正依頼

実小売データ

取引・シード層

エージェント実行