現代のWeb開発は、手動コーディングから、AIエージェントに複雑なパイプラインの実装詳細を任せるアーキテクトの役割へと移行しています。このガイドでは、インタラクティブなキャラクタービューワー、最適化されたアセット、ゲーム風のデザインを特徴とする3Dポートフォリオサイトを構築するための完全なワークフローを解説します。
エージェントワークフローを活用することで、空のプロジェクトから本番対応のインタラクティブサイトまで、従来の手法に比べてわずかな時間で到達できます。
1. 環境とツールのセットアップ
まず、高レベルの計画と並列タスク実行が可能なAIコーディングエージェントを中心とした開発環境を構築する必要があります。
エージェントプラットフォームの選択
このパイプラインでは、Verdentエージェントプラットフォームを使用します。VS CodeやJetBrains向けに利用可能ですが、デスクトップアプリケーションが推奨されます。洗練されたインターフェースにより、低レベルの構文よりも全体的なアーキテクチャに集中する方にとって使いやすくなっています。
Verdentを試すモデルの選択と連携
このワークフローのコアエンジンはClaude 4.5 Opusです。高い推論能力と複雑なコード構造の効率的な生成により、3D Webアプリケーションに特に効果的です。
- GitHub連携: GitHubアカウントをVerdentにリンクすると、エージェントがバージョン管理やブランチ作成を自動的に管理できます。
- ワークスペース管理: このセットアップの最も強力な機能の一つは、複数のワークスペースを並列で実行できることです。メインのポートフォリオを構築しながら、別のブランチで補助ツール(アセットオプティマイザーなど)を開発でき、標準的なAIコードエディタでよくあるコードの競合を回避できます。

2. カスタム3Dアセットオプティマイザーの開発
高品質な3Dポートフォリオにはパフォーマンスが不可欠です。3Dモデル(GLBファイル)は50MBを超えることも多く、Webのロード時間としては許容できません。サイトを構築する前に、専用の最適化ツールを作成しましょう。
ツールアーキテクチャのプロンプティング
新しいワークスペースを開き、glTF-transformライブラリを活用するローカルNext.js Webアプリケーションの作成をエージェントに指示します。目標は、以下を自動化するシンプルな「ドラッグ&ドロップ」インターフェースです:
- テクスチャのWebPフォーマットへの変換。
- 頂点数を削減するメッシュ最適化。
- テクスチャの最大1kまたは2k解像度へのリサイズ。
実行とテスト
エージェントを実行してファイル構造を構築させます。完了したら、ローカルサーバーを起動して、重いGLBモデルをインターフェースにドロップできます。
なぜこれが重要か
効果的な最適化により、モデルのサイズを49MBから約500KBに、視覚的な劣化をほとんど伴わずに削減できます。
ベストプラクティス: 高忠実度が必要な場合は2kまたは4kテクスチャを使用しますが、最終的なWebビルドではオプティマイザーで圧縮し、モバイルデバイスでもサイトのレスポンシブ性を確保しましょう。

3. ポートフォリオアーキテクチャの設計
最適化ツールの準備ができたら、新しいワークスペースに移動してメインのポートフォリオプロジェクトを開始します。
エージェントの計画モードの活用
すぐにコードに取りかかるのではなく、エージェントを計画モードに切り替えます。これにより、エージェントは要件を分析し、自身のロジックを再確認し、ロードマップを提示するよう促されます。
- ダイアグラムの確認: エージェントはサイトアーキテクチャの技術ダイアグラムを生成します。
- 複雑さの低減: AIエージェントはデフォルトで複数ページのレイアウトを提案しがちです。モダンな「ゲーム風」の雰囲気を維持するために、エージェントに単一のインパクトのあるエントリースクリーンとメインビューワーに統合するよう指示します。
UIとUXの制約の定義
テキストとリファレンス画像を組み合わせてビジョンを伝えます。このポートフォリオに効果的なプロンプト構造は以下の通りです:
- エントリースクリーン: サムネイルと「ポートフォリオに入る」ボタンを備えたランディングページ。
- キャラクタービューワーレイアウト: 左側60%を3Dキャラクターが占め、右側に情報カードを配置する分割画面アプローチ。
- ナビゲーション: キャラクターを切り替える左右ボタンと、キャラクターを画面の高さに自動フィットするシステム。
- ビジュアルスタイル: 純粋な黒背景、遠くへフェードする無限グリッドフロア、奥行き感を出す浮遊する「スパークル」や「スタードット」パーティクル。

4. 3D環境の洗練
エージェントが構築を開始すると、確認の質問で一時停止します。このインタラクティブなループは、特定の「ゲーム風」デザインを実現するために重要です。
環境設定
エージェントに質問された際、以下の設定を指定します:
- グリッドスタイル: 黒にフェードアウトする無限グリッドを選択。ブランドの一貫性のために、後でグリッドの色を変更(例:オレンジに)リクエストできます。
- パーティクルスタイル: 背景に微妙な動きの感覚を作り出す「浮遊スパークル」を選択。
- ユーザーインタラクション: 自動回転を無効にする。キャラクターはユーザーの操作に基づいてのみ回転するようにし、より触覚的な「ゲームメニュー」の感覚を提供。
アニメーションの処理
キャラクターモデル(GLB)にランニングやアイドルのアニメーションが含まれていることを確認してください。エージェントには、キャラクターのロード時にこれらのアニメーションを自動的にトリガーするよう指示する必要があります。
5. アセット統合と自動パス修正
このエージェントワークフローの大きな利点は、エージェントがローカルフォルダをスキャンし、見つけた内容に基づいてコードを調整できることです。
ローカルファイルの整理
ファイルエクスプローラーでプロジェクトフォルダに移動し、以下のようにアセットを配置します:
- モデル: 最適化済みの.glbファイルを
public/modelsディレクトリに配置。 - UI画像: サムネイルやプロフィール画像を
public/imagesフォルダに配置。
動的データの注入
エージェントに、キャラクターの名前と説明、作成に使用したツール、ソースファイルや外部動画コンテンツへのリンクなどのデータリストを提供します。エージェントはデータ構造を埋めるだけでなく、ファイルパスも自動的に修正します。例えば、.jpgを提供したがコードが.pngを期待していた場合、エージェントはフォルダ内のファイルを検出し、手動介入なしでコードを更新します。

6. 反復的な改善とビジュアルフィードバック
パイプラインの最終段階は、スクリーンショットを使ってエージェントにビジュアルの不整合を「指摘する」フィードバックループです。
プロポーションとレイアウトの修正
ブラウザでプロジェクトを読み込みます。3Dモデルが小さすぎたり、情報カードの位置がずれている場合は、ブラウザウィンドウのスクリーンショットを撮ります。
スクリーンショットプロンプト: スクリーンショットをエージェントにアップロードして、具体的な批評を提供します。例えば:「右のカードが現在黒背景にあるので、3Dビューワーに重なるように移動してください。また、モデルを画面の全高にフィットさせ、通常のズームにしてください。」
高度なスタイリング
一般的な見た目から脱却するために、カスタムブランディングを適用します:
- ブランディング: 特定のブランドカラーに合わせた「オレンジスタイリング」テーマをリクエスト。
- コンポーネントのアップグレード: 外部動画へのシンプルなテキストリンクの代わりに、コンテンツのビジュアルプレビューを提供する「YouTubeサムネイルカード」の作成をエージェントに依頼。

最終成果
このパイプラインに従うことで、「コーダー」からアーキテクトへと移行できます。結果は、以下を含む高性能でインタラクティブな3Dポートフォリオです:
カスタム3Dオプティマイザー
Web対応アセットを準備するための専用ツール。
インタラクティブキャラクターカルーセル
アクティブなアニメーション付きで3Dモデル間をスムーズに遷移。
ゲーム風UI
浮遊パーティクル、無限グリッド、ブランド入りインタラクティブカードを備えた洗練されたダークインターフェース。
自動データ管理
3Dアセットを説明メタデータや外部リンクに自動的にリンクするシステム。
ツール作成から最終的な改善まで、このプロセス全体は、AIエージェントの計画・実行フェーズを効果的に管理することで、約20分で完了できます。
このガイドで説明したデモはTOP 3D AIで公開中です。ゲーム風3Dポートフォリオの実際の動作をご確認ください。
3Dポートフォリオデモを起動