Written with AI assistance from the source video. The video is the authority.
9:25Vercel
Log in to leave a comment
No posts yet
自律型AIエージェントをVercel CLIと連携させる際、サンドボックス環境別のAPI呼び出し制限を設定しないと、予算超過によるクラウドコストが瞬く間に膨れ上がります。エージェントが無限リトライループに陥ったり、個人アカウントトークンをそのまま使用したりするままに放置すると、プロダクション環境で即座にセキュリティ事故が発生します。この記事では、API呼び出しコストを少なくとも40%以上削減し、最小権限の原則を適用する実務的な方法について解説します。
AIエージェントがコードの修正とビルドテストを繰り返す過程でエラーが発生すると、内部リカバリモジュールが数百回以上の vercel deploy コマンドをわずか数分で呼び出します。Vercel Proプランの1日のデプロイ作成上限は最大6,000回ですが、ビルドCPU MinuteリソースとActive CPUリソースはこれよりもはるかに速く消費されます。
不要な過剰呼び出しを防ぐには、Vercel WAF Rate Limitingとエージェント内部のサーキットブレーカーを併用する必要があります。Vercel WAFの設定で60秒あたり100回にリクエスト数を制限し、Action ModeをDenyにしておくと、条件を満たした際にエージェントのリクエストに対して即座にHTTP 429レスポンスが返されます。同一タスク内で連続失敗が3回発生した場合にはエージェントプロセスを強制終了するロジックを追加し、無限ループを根本から遮断します。
Vercel Proプランの従量制リソースは、Active CPUが1時間あたり0.128ドル、サーバーレス関数の呼び出しが100万回あたり0.60ドル、Build CPU Minuteが1分あたり0.0035ドル課金されます。Vercelの支出チェックシステムはリアルタイムの連続チェックではなく数分間隔で使用量をモニタリングするため、実際の月間許容予算上限よりも15%から20%低く設定しておく必要があります。100ドルを上限としている場合は、Spend Managementの設定を80ドルに指定します。遅延時間中に発生する追加のリソース消費をこのマージンが吸収し、不要な課金を少なくとも40%以上削減します。
設定金額に100%到達した際に受信サーバーへウェブフックを送信し、エージェントの実行権限を剥奪するパイプラインを構築します。Vercel DashboardのBillingメニューからウェブフックのエンドポイントURLを登録し、ヘッダーの x-vercel-signature の値をSHAエンコーディングで検証して不正なリクエストをフィルタリングします。100%到達イベントを検知すると、エージェントが使用するVercel API Access TokenをAPI経由で即座に無効化するか、プロジェクトの自動デプロイ機能を無効化します。
初級開発者が最も頻繁に犯すミスは、個人アカウントのFull AccountまたはTeamスコープのトークンをエージェントの環境変数にそのまま記述することです。このトークンが露出すると、チーム内のすべてのプロジェクトが削除されたり、環境変数が丸ごと流出したりします。エージェントには、特定のプロジェクトにのみ限定されたProject-Scoped Tokenを発行する必要があります。このトークンは vcp_ で始まり、指定されたプロジェクト以外の他のリソースやユーザー設定に対するすべてのリクエストを拒否します。
プログラム方式でプロジェクト制限トークンを発行するには、REST APIエンドポイントを呼び出す際に projectId パラメータを必須で明記する必要があります。ターミナルを開き、管理者マスタトークンを認証ヘッダーに指定した上で、以下のcURLコマンドを実行します。
`bash
curl -X POST "https://api.vercel.com/v3/user/tokens"
-H "Authorization: Bearer vcp_admin_master_token"
-H "Content-Type: application/json"
-d '{
"name": "agent-ci-limited-token",
"projectId": "prj_exact_project_id_here",
"expiresAt": 1719792000000
}'
`
エージェントが作成したコードは、メインブランチに直接プッシュされず、隔離されたテスト用ブランチでのみ動作させる必要があります。Vercel Deployment Protectionが有効な状態で外部の自動化ツールがプレビュー環境にアクセスできるようにするには、Protection Bypass for Automation機能を有効にして専用トークンを使用する必要があります。エージェントはリクエスト時にHTTPヘッダー x-vercel-protection-bypass やクエリパラメータとしてトークンを渡し、ゲートウェイを通過します。ブラウザベースのエージェントやE2Eテストツールがカスタムヘッダーを渡す際、CORSのプリフライトリクエストにヘッダーが含まれずにHTTP 401エラーが発生することがあるため、API単独呼び出し時にはQuery Parameter方式を併用します。
エージェントが作成したコードが検証なしにプロダクションに導入されると、構文エラーやセキュリティ上の脆弱性がそのままサービス障害につながります。エージェントが指定された機能用ブランチにのみコミットをプッシュするように制限し、Vercel CLIがそれを検知してプレビューURLを生成するようにします。自動化CI検証を経た後、リードエンジニアがプレビューURLをレビューして承認ボタンを押して初めてメインブランチにマージされ、プロダクションにデプロイされます。
CI段階でソースファイルのアップロードサイズがProプラン基準で最大1GB、Hobbyプラン基準で最大100MBを超えるとCLIデプロイが失敗するため、不要なバンドルファイルは .vercelignore に必ず追加する必要があります。最大15,000個のファイル制限を守るために node_modules の流入を整理し、Pro基準でデフォルト15秒であるサーバーレス関数の実行制限に合わせて maxDuration の設定値を確認します。
障害が発生した場合にはプロジェクトのGit自動デプロイトリガーを即座に一時停止し、エージェントによる追加の自動デプロイの試行を阻止します。以前の正常なデプロイのビルドログとエラー率を対照分析した後、Vercel CLIコマンドを使用して以前の安定バージョンにおけるデプロイIDをプロダクションドメインにターゲット切り替えします。ターミナルで以下のコマンドを実行し、即座にロールバックを完了させます。
`bash
vercel alias set dpl_previous_stable_id my-app-production.vercel.app --token=vcp_project_scoped_token
`