AI ペルソナシステム

概要

このプロジェクトは Amazon Bedrock を活用し、AIペルソナの構築と、そのAIペルソナをもとにペルソナ同士の議論、インタビューそしてアンケート調査などを通じて商品企画やマーケティング戦略立案のためのインサイトを生成するためのサンプル実装です。

セットアップ

AWS 上へのデプロイ

• AWS CDK を利用したデプロイ手順
• AWS Generative AI Solution Box からのワンクリックデプロイ

ローカル環境でのアプリケーション起動

前提条件

• Python 3.13+、uv
• バックエンドリソース（DynamoDB、S3、AgentCore Memory）がAWS CDKで構築済み
• AWS認証情報（Bedrock、DynamoDB、S3へのアクセス）

ローカルでの起動手順

# 1. 依存関係のインストール
uv sync

# 2. 環境変数を設定（.env.exampleを参考に実際の値を記入）
cp .env.example .env
# .env を編集してAWSリソース名等を設定

# 3. Tailwind CSSビルド
./scripts/build-css.sh --minify

# 4. アプリケーション起動
uv run python run_htmx.py

ブラウザで http://localhost:8000 にアクセス

主要機能

🎙️ インタビュー

AIペルソナとの議論・対話を通じてインサイトを発見します。

議論モード:

📊 アンケート調査

数百〜数千のAIペルソナに大規模アンケートを実施します。

詳細な使用方法は ユーザーガイド を参照してください。

技術スタック

テスト

uv sync --extra dev
uv run pytest                          # 全テスト
uv run pytest -m unit                  # 単体テスト（マーカー指定）
uv run pytest -m integration           # 統合テスト（マーカー指定）
uv run pytest -m api                   # APIテスト（マーカー指定）
uv run pytest --cov=src --cov-report=html  # カバレッジ付き

開発

uv sync --extra dev
uv run ruff check .          # リント
uv run ruff check --fix .    # 自動修正
uv run mypy src/ web/             # 型チェック

ai-persona-system/
├── run_htmx.py             # 起動スクリプト
├── web/                    # フロントエンド
│   ├── main.py            # FastAPIアプリケーション
│   ├── routers/           # APIルーター（persona, discussion, interview, survey, settings, api）
│   ├── templates/         # Jinja2テンプレート
│   └── static/            # 静的ファイル（CSS/JS）
├── src/
│   ├── managers/          # ビジネスロジック層
│   ├── services/          # 外部サービス連携層（AI, DB, S3, Memory, Survey）
│   ├── models/            # データモデル
│   ├── database/          # データベース管理
│   └── config.py          # 設定管理
├── cdk/                   # AWS CDKインフラストラクチャコード
├── tests/                 # テストコード（unit, integration, api）
├── docs/                  # ドキュメント
├── scripts/               # ユーティリティスクリプト
└── sample_data/             # サンプルデータセット

tests/
├── conftest.py        # 共通フィクスチャ（DB、モデル、モック）
├── unit/              # 単体テスト（外部依存をモック）
├── integration/       # 統合テスト（モックDB、AIモック）
└── api/               # APIエンドポイントテスト

他ソリューションとの連携オプション

AI ペルソナシステムは、他の AWS ソリューションと連携することで機能を拡張できます。

ドキュメント

トラブルシューティング

詳細は トラブルシューティングガイド を参照してください。

Citation

This project uses nvidia/Nemotron-Personas-Japan, licensed under CC BY 4.0. https://creativecommons.org/licenses/by/4.0/

@software{nvidia/Nemotron-Personas-Japan,
  author = {Fujita, Atsunori and Gong, Vincent and Ogushi, Masaya and Yamamoto, Kotaro and Suhara, Yoshi and Corneil, Dane and Meyer, Yev},
  title = {{Nemotron-Personas-Japan}: Synthetic Personas Aligned to Real-World Distributions},
  month = {September},
  year = {2025},
  url = {https://huggingface.co/datasets/nvidia/Nemotron-Personas-Japan}
}

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT-0 License. See the LICENSE file.