agent-platform-migrate-from-ai-studio

AI Studio の Gemini API から Agent Platform への移行

アプリケーションを、開発者向けの Google AI Studio エコシステム （generativelanguage.googleapis.com）から、エンタープライズ向けの Google Cloud Agent Platform（aiplatform.googleapis.com）へ移行する必要がある場合に、このスキルを使用してください。

Attribution

必ずお読みください：gcloud、REST API、または MCP コマンドを実行する前に、必ず Usage Attribution をお読みください。ターミナルで直接実行するコマンド（生成されたスクリプト、Terraform、ユーザーコードでは実行しないでください）では、gcloud の前に CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:agent-platform-migrate-from-ai-studio)" を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:agent-platform-migrate-from-ai-studio) を追加してください。

---

このスキルを使用する場合

• アプリケーションを Google AI Studio から Agent Platform（旧称 Vertex AI）へ移行する場合。
• Gemini API の推論コストに充当したい Google Cloud クレジット（例：$300 の Welcome Free Trial）がある場合。
• 推論パイプライン、IAM 権限、テレメトリー、課金を、既存の Google Cloud インフラストラクチャ（Compute Engine、Cloud SQL、BigQuery）と統合する必要がある場合。
• オープンソースのオーケストレーションエンジン（OpenClaw や ADK エージェントなど）を Google Cloud VM にデプロイし、システム全体を統一された Google Cloud の課金体系で運用したい場合。

---

Gemini API の比較

機能／制御項目	Google AI Studio（Gemini Developer API）	Agent Platform（Enterprise Gemini API）
API エンドポイント	generativelanguage.googleapis.com	aiplatform.googleapis.com
対象ユーザー	本番アプリケーションを構築する開発者、スタートアップ、学生、研究者。	エンタープライズの本番環境、MLOps エンジニア
GCP クレジットのサポート	なし（GCP クレジット／無料トライアルは適用できません）	あり（Welcome クレジットまたはカスタムクレジットで全額カバー）
データプライバシー	Google 製品の改善のためにデータがレビューされる場合があります	プロンプト／応答がトレーニングに使用されることはありません
セキュリティと IAM	API キー、OAuth	Google Cloud IAM（サービスアカウント、OAuth 2.0、VPC-SC）
コンプライアンスと SLA	なし（ベストエフォートの可用性）	24 時間 365 日のエンタープライズサポート、SLA、HIPAA、SOC2
スループットの選択肢	共有／レート制限あり	従量課金またはプロビジョンドスループット
MLOps エコシステム	基本的なプロンプト管理	モデルレジストリ、モデルモニタリング、パイプライン評価
推論の範囲	グローバルエンドポイントのみ	グローバルエンドポイントと厳密なリージョナルエンドポイントの両方

2 つのサービスの違いについて詳しくは、 Google Cloud ドキュメント をご覧ください。

---

移行ガイド

請求とクレジット

Google Cloud 無料トライアルのクレジットは、 AI Studio には適用されません。 Gemini モデルでクレジットを使用するには、Agent Platform 経由で呼び出しをルーティングする必要があります。

1. Google Cloud の請求先アカウントを作成します。本人確認のため、設定時に有効なお支払い方法を登録する必要があります。
2. 新規のお客様の場合は、300 ドルのウェルカム クレジットが請求コンソールで有効になっていることを確認します。
3. 予期しない請求を避ける： クレジットを使い切った際に、通常のお支払い方法へ自動的に切り替わるのを防ぐため、予算アラートを設定してください。
   • Billing -> Budgets & Alerts -> Create Budget に移動します。
   • しきい値をクレジット上限または無理なく支払える最大額に合わせて設定します。

Agent Platform API を有効にする

対象の Google Cloud プロジェクトで、Agent Platform API を明示的に有効にする必要があります。ローカルシェルで次のコマンドを実行します。

gcloud services enable aiplatform.googleapis.com --project="{project_id}"

認証と認可（IAM）

ユーザー認証

ローカルでのデバッグやスクリプトの実行には、 Application Default Credentials （ADC）を使用して認証します。

オプション 1 - 自動スクリプト：

bash <(curl -sSL https://storage.googleapis.com/cloud-samples-data/adc/setup_adc.sh)

オプション 2 - 手動設定：

gcloud auth login
gcloud auth application-default login

推論呼び出しを実行できるよう、ユーザー ID に必要な IAM ロールを付与します。

gcloud projects add-iam-policy-binding "{project_id}" \
    --member="user:[email protected]" \
    --role="roles/aiplatform.user"

サービス認証

Compute Engine VM などの Google Cloud インフラストラクチャ上でアプリケーションを実行する場合は、マシンに接続されているサービス アカウントを使用して認証します。たとえば、 Compute Engine のデフォルト サービス アカウントを使用します。

1. 仮想マシンの基盤となるサービス アカウントにユーザーロールを付与します。

gcloud projects add-iam-policy-binding "{project_id}" \
    --member="serviceAccount:[email protected]" \
    --role="roles/aiplatform.user"

2. Compute Engine のアクセス スコープ： 従来のアクセス スコープは IAM バインディングを上書きする場合があります。Compute Engine インスタンスを作成または変更する際は、VM のアクセス スコープが すべての Cloud API へのフルアクセスを許可 （https://www.googleapis.com/auth/cloud-platform）に設定されているか、標準の cloud-platform スコープが明示的に含まれていることを確認する必要があります。

---

Agent Platform で Gemini API を使用する

SDK（クライアント ライブラリ）

統合された Google GenAI SDK （google-genai）を引き続き使用できます。この SDK は AI Studio と Agent Platform の両方で動作します。ランタイム環境変数でルーティングフラグを切り替えるだけで、Agent Platform バックエンドを指定できます。

対象の環境情報を設定します。

export GOOGLE_CLOUD_PROJECT="{project_id}"
export GOOGLE_CLOUD_LOCATION="global"  # Or your chosen regional endpoint
export GOOGLE_GENAI_USE_ENTERPRISE=TRUE

これで、コアの初期化ブロックを変更せずに、標準的な Python コードの接続先を AI Studio から Agent Platform に切り替えられます。

from google import genai

# The client automatically picks up the GOOGLE_GENAI_USE_ENTERPRISE=TRUE environment flag
client = genai.Client()

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents='Hello world!',
)
print(response.text)

Agent Development Kit（ADK）

Agent Development Kit エージェントから Agent Platform の Gemini モデルを呼び出すには、次の手順に従います。

1. Google Cloud に認証します。

Google Cloud（たとえば Agent Platform Runtime）で ADK エージェントを実行する場合は、エージェントに割り当てられたサービス アカウントを使用します。または、ADK をローカルで実行する場合は、次を実行します。

gcloud auth application-default login

1. 環境変数を設定します。ADK エージェントを Google Cloud とローカルのどちらで実行する場合も、必ず設定してください。

export GOOGLE_CLOUD_PROJECT="{project_id}"
export GOOGLE_CLOUD_LOCATION="global"
export GOOGLE_GENAI_USE_ENTERPRISE=TRUE

2. ADK エージェントを初期化します。AI Studio で使用したものと同じモデル文字列（例：gemini-3-flash-preview）を使用できます。

from google.adk.agents.llm_agent import Agent

def get_current_time(city: str) -> dict:
    """Returns the current time in a specified city."""
    return {"status": "success", "city": city, "time": "10:30 AM"}

root_agent = Agent(
    model='gemini-3-flash-preview',
    name='root_agent',
    description="Tells the current time in a specified city.",
    instruction="You are a helpful assistant that tells the current time in cities. Use the 'get_current_time' tool for this purpose.",
    tools=[get_current_time],
)

ADK エージェントと Agent Platform の統合について詳しくは、 ADK のドキュメントを参照してください。

Antigravity CLI

Google Cloud ユーザーは、Gemini Enterprise Agent Platform を使用して、Antigravity CLI を含む Antigravity 2.0 にアクセスできるようになりました。

1. ローカル環境にAntigravity CLI をインストール します。

2. Antigravity CLI を起動します。

   agy
   

3. CLI のセットアッププロンプトに従い、Google Cloud プロジェクトを使用を選択します。

4. 開いたブラウザーウィンドウで、認証済みの Google Cloud Workspace またはユーザー ID を使用して OAuth フローを完了します。

5. 確認トークンをコピーし、そのままターミナルに貼り付けます。

6. プロンプトに従って Google Cloud プロジェクト ID を入力します。

7. Google Cloud のロケーション（例：global）を選択します。

8. 必要に応じて、/model コマンドを実行して Agent Platform で別の Gemini モデルを選択します。

OpenClaw

Agent Platform で Gemini モデルを使用するよう OpenClaw エージェントを設定するには、以下の手順に従います。

1. OpenClaw の公式手順に従って OpenClaw をインストールします。

⚠️ 重要：OpenClaw 2026.5.28 には現在、google-vertex のバグがあります。現時点では 2026.5.20 を使用してください。

2. OpenClaw が実行されているランタイム（例：サービスアカウントを使用する GCE VM）に aiplatform.user IAM ロールがあることを確認します。上記の「認証と認可」セクションを参照してください。

3. ユーザーのプロジェクト ID からプロジェクト番号を取得します。GCE の外部では、次を実行します。

export PROJECT_NUMBER=$(gcloud projects describe "$PROJECT_ID" --format="value(projectNumber)")
echo "Project number: $PROJECT_NUMBER"

Compute Engine VM 内では、次を実行します。

export PROJECT_NUMBER=$(curl "http://metadata.google.internal/computeMetadata/v1/project/project-id" -H "Metadata-Flavor: Google")
echo "Project number: $PROJECT_NUMBER"

4. GCE インスタンスの外部から、Google Cloud プロジェクト番号を使用して GOOGLE_APPLICATION_CREDENTIALS を生成します。次に、これらの認証情報を scp で GCE VM にコピーします。

mkdir -p ~/.config/gcloud
gcloud iam service-accounts keys create ~/.config/gcloud/application_default_credentials.json --iam-account="${PROJECT_NUMBER}[email protected]"

⚠️ 新しい組織におけるポリシー制約のトラブルシューティング：新しい Google Cloud 組織（2024 年 5 月 4 日以降に作成された組織）では、サービスアカウントキーの作成を制限するレガシー組織ポリシーが適用されます。この手順を完了するには、この組織ポリシーを一時的に無効にする必要があります。 組織ポリシー管理者が、このポリシーを「非アクティブ」に設定する必要があります。 エージェントへ：このポリシーが適用されているか確認してください。適用されている場合は作業を中断し、 このコンソールのリンクで無効にするようユーザーに促してください： https://console.cloud.google.com/iam-admin/orgpolicies

5. 通常、~/.openclaw/openclaw.json にある設定ファイルを編集します。Gemini モデル名の先頭に google-vertex/ を付けてください。

⚠️ 重要：OpenClaw の google-vertex プロバイダーはまだ Gemini 3.5 モデルをサポートしていないため、使用しないでください。旧モデルは使用できます。Agent Platform で Gemini 3 Flash Preview モデルを使用する場合は、必ずロケーションに global を設定してください。リージョナル エンドポイントは使用しないでください。

{
  "env": {
    "vars": {
      "GOOGLE_CLOUD_PROJECT": "PROJECT_ID",
      "GOOGLE_CLOUD_LOCATION": "global",
      "GOOGLE_APPLICATION_CREDENTIALS": "~/.config/gcloud/application_default_credentials.json"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "google-vertex/gemini-3-flash-preview"
      },
      "workspace": "~/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "heartbeat": {
        "model": "google-vertex/gemini-3-flash-preview"
      }
    },
    "list": [
      {
        "id": "main",
        "workspace": "~/.openclaw/workspace",
        "model": "google-vertex/gemini-3-flash-preview"
      }
    ]
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "tools": {
    "profile": "coding"
  }
}

6. OpenClaw を再起動します。

openclaw gateway restart

7. OpenClaw から Agent Platform への接続を確認します。

openclaw models status
openclaw agent --agent main --message "Hello world!"

---

その他のリソース

• Google Cloud 無料トライアルの機能と制限
• Google AI Studio から Gemini Enterprise Agent Platform への移行
• Gemini Enterprise Agent Platform - モデル
• エージェント開発キットのドキュメント - Agent Platform のモデルへの接続
• OpenClaw のドキュメント - Google モデルへの接続
• Google Cloud の予算アラート - 設定ガイド