プロダクト・サービス設計書 | 埼大人流ナッジ研究所

01 全体提供形態 (Product Delivery Modes)

本プロダクトは、顧客のシステム成熟度およびAI活用レベルに応じて3つの提供形式を持つ。

Mode 01

1. 標準Web API (REST)

FastAPIで構築されたRESTful API。仕様書（OpenAPI/Swagger）と認証キー（API Key）を提供。鉄道・空港・大手SIerの既存システムへ直接組込み。

Mode 02

2. ラピッドUI (BIセット)

Looker Studio等の既存BIツールを活用し画面を爆速構築。自治体・商業施設の現場担当者向け。スクラッチ画面開発費を不要化。

Mode 03 ★NEW

3. MCP Connector (AI)

Anthropic社策定の業界標準「Model Context Protocol」準拠。自治体・コンサルの社内AIエージェント（Claude/Cursor等）からTool直接呼び出し。

02 コアAPI仕様 (REST API & FastMCP)

2.1 人流解析・予測API (Core API 01)

独自の高精度な位置推定と、未来の混雑予測値・死角滞留リスクを計算するコアエンジン。

POST /v1/analytics/crowd-risk

リクエストボディ (JSON):

{
  "location_id": "saitama_omiya_west_01",
  "coordinates": {"lat": 35.9063, "lng": 139.6240},
  "target_timestamp": "2027-01-15T18:00:00Z",
  "spatial_resolution_m": 10
}

レスポンスボディ (JSON):

{
  "status": "success",
  "crowd_density_index": 0.82,
  "risk_level": "HIGH",
  "anomaly_flags": ["STAGNATION_DETECTED", "BLIND_SPOT_CONGESTION"],
  "predicted_people_count": 420,
  "confidence_score": 0.94
}

2.2 行動変容（ナッジ）トリガー生成API (Core API 02)

動的ウォーカビリティと混雑回避数理モデルに基づき、安全・平準化ルートおよびナッジ文言を自動生成。

POST /v1/nudge/route

リクエストボディ (JSON):

{
  "origin": {"lat": 35.9063, "lng": 139.6240},
  "destination": {"lat": 35.9010, "lng": 139.6200},
  "departure_time": "2027-01-15T18:05:00Z",
  "user_segment": "PEDESTRIAN_GENERAL",
  "nudge_intensity": "MODERATE"
}

レスポンスボディ (JSON):

{
  "recommended_route_id": "route_bypass_04",
  "walkability_score": 88,
  "estimated_time_sec": 480,
  "nudge_message": "現在、駅前メイン通りが大変混雑しています。季節の灯りがともる「緑道ルート」がスムーズで安全です（徒歩+2分）。",
  "congestion_avoidance_rate": 0.35
}

03 MCP (Model Context Protocol) サーバー仕様

Primitive 01

Tools (実行関数)

predict_crowd_risk(location, time)

死角・滞留リスクを埼大数理モデルでリアルタイム計算。

generate_nudge_route(origin, dest, time)

動的ウォーカビリティに基づく混雑回避・安全迂回ナッジルートを算出。

Primitive 02

Resources (データ参照)

saidai://evidence/walkability-model

埼玉大学の学術論文・実験データへAIが直接アクセス。「なぜその結果が出たか」を自律的に説明できるホワイトボックス化参照層。

Primitive 03

Prompts (定型プロンプト)

b2g-safety-report-template

自治体向け「地域安全・混雑平準化報告書」自動生成テンプレート。データ取得からレポート作成までを自然言語指示1文で完了。

04 サーバーレスアーキテクチャ (Serverless Architecture)

アクセスゼロ時は費用0円、1年目月額インフラ費約1.2万円（年間15万円）を実現する疎結合構成。

[クライアント / AIエージェント]
        │
        ▼
[AWS API Gateway] ── (APIキー認証・流量制限・DDoS防衛)
        │
        ▼
[ElastiCache (Redis) / CloudFront] ── (リクエストの95%をミリ秒高速返却)
        │ (Cache Miss時のみ)
        ▼
[AWS Lambda (FastAPI)] ── (サーバーレスロジック処理)
        │
        ├──► [Amazon SageMaker Serverless Inference] (埼大数理モデルAI推論)
        └─► [Amazon SQS] (POSTリクエストの負荷分散キュー)