AI のセットアップ

インストールとセットアップ

手順の前に、始める前に と ターミナルの基本 をお読みください。これらの手順では、VS Code で完全な supastack モノリポジトリを開いたことが前提となっています。そのルート package.json はリポジトリのルートをマークします。 pnpm コマンドでは、ワークスペース パッケージはアプリまたは共有コード フォルダーです。この製品では、ワークスペースはチームのデータ コンテナであり、セキュリティ境界です。 corepack pnpm --filter ... コマンドがルートから実行されている間にモノリポジトリから 1 つのパッケージを選択します。同期されたモバイル フォルダーまたはデスクトップ フォルダーのみを開いた場合、そのフォルダーには Web バックエンド、Docker セットアップ、またはルート スクリプトが含まれていません。このモノリポジトリまたはアクセス可能なホスト サーバーからバックエンドを実行し、プラットフォーム フォルダー独自のスクリプトを使用します。環境変数は、ローカルの .env ファイルまたはホスティング ダッシュボードに保存される名前付き設定です。変更後に関連するアプリを再起動し、NEXT_PUBLIC_ および EXPO_PUBLIC_ 値にサーバー シークレットが含まれないようにします。

1. ローカル Web サーバーの場合は apps/web/.env.local を開き、プロバイダーの選択には apps/web/src/agent-runtime.ts を開きます。 .env.example は、サポートされている設定名のリストです。

2. 独自のプロバイダー アカウントを持っていて実際の生成をテストする場合を除き、ローカル インターフェイスの作業用に AI_PROVIDER=fake を保持します。プロバイダー キーを NEXT_PUBLIC_ または EXPO_PUBLIC_ 設定に入れないでください。

3. corepack pnpm --filter @supastack/web dev を使用して、リポジトリ ルートから Web アプリを起動します。期待: 有料プロバイダーを構成しなくても、ローカル画面を探索できます。実際の生成には、有効なサーバー プロバイダーと、データベース カタログで有効なモデルの選択が必要です。

デフォルトの AI_PROVIDER=fake は決定的なローカル作業をサポートします。実プロバイダー設定はサーバー環境に属します。.env.example に列挙されたプロバイダーキーには OpenAI、Anthropic、OpenAI 互換エンドポイントが含まれます。

AI_MODEL_POLICY には cheap・fast・smart エイリアス向けの順序付きモデル ID が含まれます。空のエイリアスリストはその選択肢を無効化します。モデル ID は有効な不変価格を持つ有効化されたカタログ行と一致しなければなりません。

AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'
AGENT_FRAMEWORK=ai-sdk    # ai-sdk | mastra | langgraph | openai-agents

コピーするコマンド

コメントに従って、コマンドがどのフォルダーで実行されるかを確認します。 2 つのターミナルにラベルが付いている場合は、2 つのターミナル ウィンドウを開き、2 番目のコマンドを使用している間、最初のコマンドを実行し続けます。

corepack pnpm --filter @supastack/web dev

実装ワークフロー

本番タスクを受け入れる前にカタログとワークスペースポリシーを設定します。ブラウザは有効なエイリアスを受け取り、能力マッチング、モデル選択、権限チェック、予算適用はサーバーに留まります。

認証情報を NEXT_PUBLIC_ と EXPO_PUBLIC_ 変数から外してください。自前キーモードには既存の暗号化エンベロープとサーバー復号境界を使います。保存されたプロバイダーキーをインターフェースに返さないでください。

検証とトラブルシューティング

利用可能な AI モデルがないとアプリが報告した場合は、サーバーの AI_PROVIDER、管理カタログ内の有効なモデルと価格、および安価/高速/スマート エイリアス ポリシーを確認してください。実際のプロバイダーが認証エラーを返した場合は、apps/web/.env.local でそのキーを確認し、サーバーを再起動します。 NEXT_PUBLIC_ というプレフィックスが付いたキーはブラウザに表示されるため、削除する必要があります。

無効化されたエイリアス、欠けた能力、非アクティブな権限、枯渇した予算を検証します。実際の生成には別途承認されたプロバイダースモーク実行を使います。利用可能なエイリアスがない場合、生のモデルセレクターを晒すのではなくサーバーポリシーとカタログ設定を検査してください。