AI デベロッパー ツールの設定を構成する

Gemini Enterprise の AI デベロッパー ツールの設定ページを使用して、デベロッパー ツールの構成、セキュリティとコンプライアンスの管理、Google Antigravity 機能のオン / オフ、組織のモデルの可用性の管理を行います。

始める前に

以下のものが揃っていることを確認してください。

  • Cloud 請求先アカウント: AI デベロッパー ツールを使用するには、プロジェクトが、アップグレードされたセルフサービス(オンライン)請求先アカウント、請求書発行アカウント、請求書発行アカウントの請求先サブアカウントなど、対象となる Cloud 請求先アカウントにリンクされている必要があります。セルフサービス(オンライン)の請求先アカウントでは、従量課金制エディションの使用量と割り当てを超える使用量に対して、プリペイド クレジットで支払います。請求書発行アカウントまたは請求書発行アカウントの請求先サブアカウントでは、この使用量は毎月の請求書で請求されます。

  • サポートされているエディション: AI デベロッパー ツールにアクセスするには、Gemini Enterprise Standard、Plus、Standard 新興市場、従量課金制エディションのサブスクリプションが必要です。

  • サポート対象の地域: 地域別の提供状況と機能制限の詳細については、Gemini Enterprise Standard エディションと Plus エディション、Gemini Notebook のデータ所在地をご覧ください。

  • 必要なロール: AI デベロッパー ツールの設定を構成するには、Gemini Enterprise 管理者(roles/discoveryengine.agentspaceAdmin)ロールが必要です。

  • 必要な API: プロジェクトで次の API を有効にする必要があります。

    • Discovery Engine API(discoveryengine.googleapis.com): Gemini Enterprise のコア プラットフォーム サービス、セキュリティとコンプライアンスの管理、設定管理を提供します。
    • Business AI Code API(businessaicode.googleapis.com): Gemini Enterprise の Antigravity に AI を活用したコード生成を提供します。承認されたプリンシパルがプロジェクトからサービスにアクセスできるようにするには、プロジェクトでこの API を有効にする必要があります。

    Google Cloud コンソールで [AI デベロッパー ツール] の切り替えをオンにすると、システムはプロジェクト構成を確認し、必要な API がまだ有効になっていない場合は自動的に有効にします。

AI デベロッパー ツールを有効にする

AI デベロッパー ツールの提供状況は、Gemini Enterprise のサブスクリプション タイプによって異なります。

  • 新しい Standard、Plus、従量課金制のサブスクリプション: AI デベロッパー ツールは、サブスクリプションを購入したロケーションまたはリージョンでサポートされている場合、デフォルトで有効になります。

  • 既存のサブスクリプション: 管理者は、ライセンス ユーザーに対してツールを有効にするために、 Google Cloud コンソールで各ロケーションの AI デベロッパー ツールを手動で有効にする必要があります。

既存の Gemini Enterprise サブスクリプションで AI デベロッパー ツールを手動で有効にするには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] に移動します。

    Gemini Enterprise に移動

  2. [設定] をクリックし、[AI デベロッパー ツール] タブを選択します。

  3. [AI デベロッパー ツール] をオンにします。

  4. [セキュリティ]、[コンプライアンス]、[機能]、[モデルの可用性] の各セクションで設定を構成します。

セキュリティ設定を作成します

管理者は、デベロッパー インターフェース全体で未承認のデータが漏洩しないようにすることができます。このセクションの設定を使用して、外部ソースへのアクセスを制限し、自動実行権限を管理します。たとえば、ユーザーが安全ルールをオーバーライドできないように必須のセキュリティ ポリシーを適用したり、AI エージェントがターミナル コマンドを実行したりリンクを選択したりする前に承認を要求したりできます。

セキュリティ ポリシーを管理する

セキュリティ ポリシーを構成して、AI エージェントが作業フォルダ外のローカル ファイルにアクセスする方法と、デベロッパー ワークスペースでターミナル コマンドを実行する方法を制御できます。

設定 説明 デフォルトのステータス
ファイル アクセス ポリシーの外部 指定された作業フォルダ外のファイルにアクセスするためのエージェントの権限レベルを指定します。次のオプションを使用できます。
  • 拒否: エージェントが作業フォルダ外のファイルにアクセスできないようにします。
  • 常に確認する: エージェントが作業フォルダ外のファイルにアクセスする前に、ユーザーに権限を求めます。
  • 許可: エージェントが作業フォルダ外のファイルにアクセスすることを、プロンプトを表示せずに許可します。
拒否
ターミナル自動実行モード この設定を有効にすると、エージェントがターミナル コマンドを自動的に実行して、複数ステップのワークフローを効率化できます。次のオプションを使用できます。
  • レビューを必須にする: ターミナル コマンドを実行する前に、ユーザーに承認を求めます。
  • サンドボックスで続行: 安全な隔離された環境でコマンドを自動的に実行します。
  • 常に続行: プロンプトを表示せずに、現在の環境でコマンドを自動的に実行します。
常に続行
サンドボックス モード この設定を有効にすると、エージェント ツールを安全で隔離されたローカル サンドボックスに制限できます。 無効

外部ウェブアクセスを管理する

セキュリティ ポリシーで、データ漏洩を防ぐためにエージェントによる外部ウェブサイトへのアクセスを制御する必要がある場合は、これらの設定を使用して、ブラウザ アクセスを制限するか、許可された URL のリストに制限できます。

設定 説明 デフォルトのステータス
ブラウザ アクセス この設定を有効にすると、外部ウェブアクセスを制御できます。これにより、データの引き出しを防ぎ、組織の境界を定義できます。 無効
許可されている URL エージェントがブラウザでアクセスできる許可された URL のリストを指定します。 設定すると、他のすべての URL がブロックされます。

この設定は、Antigravity ブラウザ エージェントにのみ適用されます。Antigravity でブラウザ エージェントを実行するには、チャット フィールドに /browser コマンドを入力します。

なし。デフォルトでは、URL はブロックされません。
ブラウザ JavaScript 自動実行モード この設定を有効にすると、エージェントが JavaScript を実行して、高度なウェブベースのコーディングとテストのタスクをサポートできるようになります。次のオプションを使用できます。
  • 無効: エージェントが JavaScript を実行できないようにします。
  • 審査をリクエスト: エージェントが JavaScript を実行する前に、ユーザーに承認を求めます。
  • 許可: エージェントが JavaScript を自動的に実行できるようにします。
無効

Model Context Protocol(MCP)を管理する

Model Context Protocol(MCP)サーバーへのアクセスを構成できます。これにより、AI エージェントは追加のデータソースとツールに安全にアクセスできます。

設定 説明 デフォルトのステータス
MCP サーバー この設定を有効にすると、Model Context Protocol(MCP)サーバーへのアクセスを管理して、AI のデータ コンテキストを安全に拡張できます。

MCP は、Android Studio や JetBrains IDE など、Agent Client Protocol(ACP)をサポートする IDE を使用するために必要です。これらの環境では、IDE が強制適用の対象外の独自の MCP ツールを挿入できるため、管理者コントロールはベスト エフォート ベースで動作します。

無効
許可されるサーバー構成 この設定により、管理者は MCP サーバー アクセス用の特定のサーバー構成を定義できます。管理者は、ローカルおよびリモートの MCP サーバーの構成を含む JSON オブジェクトとして許可リストを定義します。UI では、次のフィールドのリアルタイム検証が行われます。
  • ローカル MCP サーバー(local_servers):
    • id(文字列): MCP サーバーの固有識別子。
    • command(文字列、省略可): ローカル MCP サーバーを実行するコマンド。指定すると、ユーザーのローカル構成がオーバーライドされます。
    • args(文字列の配列、省略可): コマンドに渡される引数。指定すると、ユーザーのローカル構成がオーバーライドされます。
  • リモート MCP サーバー(remote_servers):
    • id(文字列): MCP サーバーの固有識別子。
    • url(文字列、省略可): リモート MCP サーバーのエンドポイント URL。カスタム リモート サーバーの場合は必須、事前構成済みのリモート サーバーの場合は省略可能です。

構成の例

{
  "mcpServers": {
    "local_servers": [
      {
        "id": "gopls-mcp-server",
        "command": "go",
        "args": [
          "run",
          "golang.org/x/tools/gopls@latest",
          "mcp"
        ]
      }
    ],
    "remote_servers": [
      {
        "id": "bigquery"
      },
      {
        "id": "custom-remote-server",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  }
}
未構成

コンプライアンス設定を構成する

組織が規制された業界で活動している場合や、特定の内部ポリシーがある場合は、コンプライアンスのために AI の操作の監査ログを保持する必要があります。このセクションの設定では、法的要件と規制要件を満たすようにロギングとデータ保持ポリシーを構成できます。

設定 説明 デフォルトのステータス
プロンプトと回答のロギング この設定を有効にすると、デベロッパーと AI の間のインタラクションが記録され、使用状況の指標が計算されます。また、セキュリティ レビューのための監査証跡が保持されます。システムは、組織のプロジェクト内にログを安全に保存します。 Google がモデルのトレーニングや人間によるレビューのためにログにアクセスすることはありません。 無効
メタデータ ロギング この設定を有効にすると、サードパーティ モデルのトークン消費量など、組織全体での使用状況と分析情報を追跡するのに役立つプロダクト メタデータが記録されます。システムは、組織のプロジェクト内にログを安全に保存します。 Google がモデルのトレーニングや人間によるレビューのためにログにアクセスすることはありません。 無効

機能の設定を構成する

Antigravity の一部の機能には、デベロッパーが複雑なタスクに取り組むのに役立つ高度なマルチエージェント機能が用意されています。これらの機能により、トークンの使用量と費用が増加する可能性があるため、このセクションの設定を使用して、組織内のユーザーのアクセスを制御します。有効な機能にアクセスするには、ユーザーは Antigravity アプリ バージョン 2.18.0 以降、または Antigravity CLI バージョン 1.2.10 以降を使用する必要があります。/swarm コマンドには、Antigravity アプリ バージョン 2.32.0 以降、または Antigravity CLI バージョン 1.5.7 以降が必要です。

機能をオンまたはオフにする手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] に移動します。

    Gemini Enterprise

  2. [設定] をクリックし、[AI デベロッパー ツール] タブを選択します。

  3. [機能] セクションで、[編集] をクリックします。

  4. 機能ごとに、切り替えボタンをオンまたはオフにします。

    設定 説明 デフォルトのステータス
    /boost コマンド この設定を有効にすると、ユーザーは階層型のマルチエージェント階層を実行して、複雑なアルゴリズムの課題や詳細なデバッグタスクを解決できます。詳細については、ディープ推論を強化するをご覧ください。 有効
    /teamwork コマンド この設定を有効にすると、ユーザーは自律型サブエージェントの連携フレームワークをデプロイして、大規模で長期的なプロジェクトを実行できます(プレビュー)。詳細については、チームワーク エージェント チームをご覧ください。以前のバージョンの Antigravity では、このコマンドの名前は /teamwork-preview です。

    この設定は、/swarm コマンドも制御します。このコマンドを使用すると、ユーザーは共有メッセージ ボードを介して連携するエージェントのチームを実行できます。この設定がオフの場合、ユーザーはどちらのコマンドも使用できません。

    有効
  5. [保存] をクリックします。

モデルの可用性を構成する

このセクションの設定を使用して、特定の AI モデルを承認し、アクセスレベルを管理します。これにより、デベロッパーは組織の安全性と利用ポリシーに準拠した AI モデルのみを使用できます。たとえば、デベロッパーにテスト用のプレビュー モデルへのアクセス権を付与したり、承認済みのモデルのみを使用するようにツールを制限したりできます。

モデルを構成する前に考慮すべきポイント

モデルを構成する前に、次の点を考慮してください。

  • ポリシーの整合性: Gemini Enterprise でモデルを有効にしても、Gemini Enterprise Agent Platform の組織ポリシーはオーバーライドされません。標準割り当てを超える従量課金制リクエストが失敗しないようにするには、許可されたモデルが両方のプラットフォームで一致していることを確認してください。

  • データ所在地: プレビュー モデルと Gemini 3 Pro 画像モデルは、global リージョンでのみ使用できます。そのため、米国または EU のマルチリージョンにおけるデータ所在地(DRZ)または機械学習(ML)のリージョン処理のコミットメントはサポートされていません。

  • サードパーティ モデルの推論とデータ処理: サードパーティ モデルは、管理者が有効にしてプロバイダの規約に同意した場合にのみ使用できます。デベロッパーが有効なサードパーティ モデルを選択すると、Gemini Enterprise は、そのリクエストに必要なプロンプトとコード コンテキストを、Gemini モデルと同じ処理と保護を適用してモデルに送信します。プロンプトと回答は、モデルのトレーニングには使用されません。サードパーティ モデルの推論は、global、us、eu のロケーションで使用できます。国内リージョンはサポートされていません。モデルにアクセスできる国とリージョンのリストについては、Anthropic のサポートされている国とリージョンをご覧ください。データ所在地の詳細については、Gemini Enterprise Standard エディションと Plus エディション、Gemini Notebook のデータ所在地をご覧ください。

  • ハイブリッド実行と課金に関する開示: Gemini モデルは、組織のプールされたエディション シート クレジットから引き出されます。一方、管理者が有効にしたサードパーティ モデルは、Cloud 請求先アカウントで従量課金制の使用量として課金されます。デベロッパーが、主要な推論、計画、ツール オーケストレーション、コード生成タスクに有効なサードパーティ モデル(Anthropic Claude Opus 5.5 や Anthropic Claude Sonnet 5.5 など)を選択すると、Antigravity は、クライアントサイドの調整(コンテキスト管理や要約など)に軽量の Gemini モデルを、画像生成に Gemini 3 Pro Image をバックグラウンドで使用し続けます。これらのモデルを使用すると、料金が発生する可能性があります。詳細については、割り当てと従量課金制の使用量とサードパーティ モデルのトークン使用量を追跡するをご覧ください。

承認済みモデルを構成する

承認済みモデルを構成して、AI デベロッパー ツールで使用できる AI モデルを制御できます。

[Antigravity 認定モデル] の設定は、許可リストとして機能します。

  • デフォルトの選択(空): フィールドが空の場合、サポートされているすべての Gemini モデルが許可されます。新しくリリースされた Googleモデルは、ライセンスを付与されたユーザーが自動的に利用できるようになります。
  • カスタムモデル リスト: 1 つ以上の特定のモデルを選択すると、選択したモデルのみが許可されます。選択されていないモデルと新しくリリースされたモデルは、管理者が手動で選択するまでデベロッパーは使用できません。

承認済みモデルを構成するには:

  1. Google Cloud コンソールで、[Gemini Enterprise] に移動します。

    Gemini Enterprise に移動

  2. [設定] をクリックし、[AI デベロッパー ツール] タブを選択します。

  3. [モデルの可用性] セクションで、[編集] をクリックします。

  4. [Antigravity 認定モデル] フィールドで、許可するモデルを選択します。サポートされているすべてのモデルを許可するには、フィールドを空のままにします。

  5. [保存] をクリックします。

設定 説明 デフォルトのステータス
Antigravity 認定モデル プロジェクト内で Antigravity ツールが使用を許可されている AI モデルを指定します。サポートされているすべての Gemini モデルを許可するには、このフィールドを空のままにします。モデルのカスタムリストを指定すると、この設定は許可リストとして機能します。新しくリリースされたモデルや選択されていないモデルを使用できるようにするには、手動で追加する必要があります。 Googleが作成した Gemini モデルに加えて、管理者は Anthropic Claude Opus 5.5 や Anthropic Claude Sonnet 5.5 などのサードパーティ モデルを有効にできます。各モデルの機能、制限事項、安全性評価については、Anthropic Claude Opus 5.5 と Anthropic Claude Sonnet 5.5 のモデルカードをご覧ください。 空(すべての Gemini モデルが許可されます)。サードパーティ モデルはデフォルトでオフになっており、管理者の同意が必要です。

サポートされているモデル

AI デベロッパー ツール(Antigravity アプリ、Antigravity CLI、Antigravity for IDE)は、次の Gemini モデルとパートナー モデルをサポートしています。ライセンス ユーザーとは、有効な Gemini Enterprise シート ライセンス(Standard、Plus、従量課金制)が割り当てられているデベロッパーです。詳細については、ライセンスを管理するをご覧ください。

モデルの表示名 プロバイダ Gemini Enterprise での提供状況
Gemini 4 Hydrogen Google デフォルトのモデル選択が有効な場合(空のリスト)、ライセンス ユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 4 Carbon Google デフォルトのモデル選択が有効な場合(空のリスト)、ライセンス ユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 4 Argon Google デフォルトのモデル選択が有効な場合(空のリスト)、ライセンス ユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 3.8 Flash Google デフォルトのモデル選択が有効になっている場合、ライセンス ユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 3.7 Flash Google デフォルトのモデル選択が有効になっている場合、ライセンスを付与されたユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 3.6 Flash Google デフォルトのモデル選択が有効になっている場合、ライセンス ユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Gemini 3.1 Pro(プレビュー) Google デフォルトのモデル選択が有効になっている場合、ライセンスを付与されたユーザーに対してデフォルトで有効になります。カスタムモデル リストが構成されている場合は、モデルを手動で選択する必要があります。
Anthropic Claude Opus 5.5 Anthropic デフォルトではオフになっています。管理者のオプトインが必要です(サードパーティ モデルを有効または無効にするをご覧ください)。
Anthropic Claude Sonnet 5.5 Anthropic デフォルトではオフになっています。管理者のオプトインが必要です(サードパーティ モデルを有効または無効にするをご覧ください)。

割り当てとプールされたエディション クレジットの詳細については、割り当てと従量課金制の使用量と割り当て超過時の従量課金制の使用量を構成するをご覧ください。サードパーティ モデルの料金については、Anthropic Claude Opus 5.5 と Anthropic Claude Sonnet 5.5 の Cloud Billing SKU をご覧ください。

サードパーティ モデルの思考レベル

開発者は、Anthropic Claude Opus 5.5 と Anthropic Claude Sonnet 5.5 を、思考レベルを低、中、高、最大に設定して使用できます。各レベルは、モデル選択ツールに個別のエントリとして表示されます(例: Anthropic Claude Opus 5.5(高))。デフォルトは [中] です。サードパーティ モデルを有効にすると、そのすべての思考レベルがデベロッパーに提供されます。個々の思考レベルを制限することはできません。

サードパーティ モデルを有効または無効にする

サードパーティ モデルは従量課金制の使用量として請求されます。ライセンスベースのエディションを使用している場合は、サードパーティ モデルを有効にする前に、割り当て超過時の従量課金制利用を有効にする必要があります。後で割り当て超過時の従量課金制利用をオフにすると、デベロッパーは再びオンにするまでサードパーティ モデルを使用できなくなります。費用を管理するには、プロジェクトに1 か月の費用の上限を設定します。この上限は、サードパーティ モデルを含むすべてのモデルに適用されます。

Google Cloud コンソールでサードパーティ モデル(Anthropic Claude Opus 5.5 や Anthropic Claude Sonnet 5.5 など)を有効にする、または管理するには:

  1. Google Cloud コンソールで、[Gemini Enterprise] に移動します。

    Gemini Enterprise に移動

  2. [設定] をクリックし、[AI デベロッパー ツール] タブを選択します。

  3. [Antigravity 認定モデル] 設定で、有効にするサードパーティ モデルの切り替えボタンをオンにします。

  4. 表示された埋め込みの利用規約ダイアログで、サードパーティの利用規約を確認して同意します。

サードパーティ モデルをオフにすると、デベロッパーはすぐにそのモデルにアクセスできなくなります。

モデル プロバイダが組織のサードパーティ モデルへのアクセスを制限している場合、デベロッパーはそのモデルを使用できません。この問題を解決するには、Google Cloud サポートにお問い合わせください。

Antigravity にログインしてモデルを選択するデベロッパー向けの手順については、Antigravity エンタープライズ ドキュメントをご覧ください。

サードパーティ モデルのセキュリティに関する考慮事項

サードパーティ モデルを含む AI モデルは、ファイル、ウェブページ、ツールの出力など、処理するコンテンツに隠された指示に従うことがあります。これはプロンプト インジェクションと呼ばれます。Antigravity は、デベロッパーがサードパーティ モデルを使用する際に、次の保護機能を提供します。

  • 管理者によるオプトイン: サードパーティ モデルはデフォルトでオフになっています。デベロッパーは、管理者が有効にした後にのみ、サードパーティ モデルを使用できます。
  • プロバイダの安全保護対策: サードパーティ モデルには、プロバイダの組み込みの安全保護対策が含まれています。詳細については、Claude の安全性をご覧ください。
  • セキュリティ ポリシー: 構成したセキュリティ ポリシーと外部ウェブアクセスの設定は、デベロッパーが選択したモデルに関係なく、エージェントに適用されます。

おすすめの方法

  • デベロッパーが必要とするサードパーティ モデルのみを有効にします。
  • [ターミナル自動実行モード] を [レビューが必要] または [サンドボックスで続行] に設定して、デベロッパーがコマンドを実行する前に承認するようにします。
  • [ファイル アクセス ポリシーの外部] を [拒否] に設定したままにします。
  • [ブラウザ アクセス] をオンにして、エージェントがアクセスできる URL を [許可された URL] のリストに制限します。
  • 信頼できないコード、依存関係、ウェブ コンテンツを扱うプロジェクトでは、サンドボックス モードを有効にします。
  • エージェントが提案するコマンドとコードの変更を承認する前に、デベロッパーが確認するように促します。
  • プロジェクトの 1 か月の費用の上限を設定します。

トラブルシューティング

このセクションでは、AI デベロッパー ツールの構成またはアクセス時に発生する一般的な問題の解決方法について説明します。

AI デベロッパー ツールの有効化に関するトラブルシューティング

Google Cloud コンソールで AI デベロッパー ツールを有効にできない、または設定を構成できない場合、またはデベロッパーが Google Antigravity にログインするときに No license available for this project and location エラーが発生する場合は、次の要件を確認してください。

チェック 解決策
定期購入と請求の利用資格 選択した Google Cloud プロジェクトとマルチリージョン ロケーション(global、us、eu)に、有効なトライアル以外の Gemini Enterprise サブスクリプション(Standard、Plus、Standard 新興市場、従量課金制)があり、アップグレードされたセルフサービス(オンライン)請求先アカウント、請求書発行 Cloud 請求先アカウント、または請求書発行アカウントの請求先サブアカウントにリンクされていることを確認します。無料トライアル サブスクリプションには、プロジェクトが請求書発行アカウントにリンクされている場合にのみ、割り当てが制限された AI デベロッパー ツールが含まれます。請求先アカウントがまだ Google Cloud 無料トライアル中の場合は、AI デベロッパー ツールを使用するために、有料の請求先アカウントにアップグレードしてください。販売パートナーが管理するサブアカウントは、前払いクレジットの対象外です。請求エラーについては、請求に関する質問のトラブルシューティングをご覧ください。
割り当てられたシートとプロジェクトの選択 デベロッパーがログイン時にライセンスが配布される Google Cloud プロジェクトを選択していること、選択したロケーションのサブスクリプションに未割り当てのシートがあることを確認します。すべてのシートが割り当てられている場合は、サブスクリプションにシートを追加するか、[ユーザーを管理] ページでユーザーにシートを割り当てます。
AI デベロッパー ツールの切り替え 既存のサブスクリプションの場合、管理者は、各マルチリージョン ロケーション(global、us、eu)の [Gemini Enterprise] > [設定] > [AI デベロッパー ツール] で、[AI デベロッパー ツール] の切り替えを手動でオンにする必要があります。詳細については、AI デベロッパー ツールを有効にするをご覧ください。
サポートされている Antigravity クライアント デベロッパーがエンタープライズ サポート対象のクライアント(Antigravity アプリ、Antigravity CLI(agy)、IDE 向け Antigravity(Visual Studio Code、Visual Studio、JetBrains IDE、Zed、Xcode)、Android Studio)を使用していることを確認します。詳細については、AI デベロッパー ツールの概要をご覧ください。
必要な IAM ロール プロジェクトに対する Gemini Enterprise ユーザーロール(roles/discoveryengine.agentspaceUser)または AI デベロッパー ツールの権限を持つカスタムロールをユーザーに付与します。管理者ロール(roles/discoveryengine.agentspaceAdmin)だけでは、エンドユーザー デベロッパーにアクセス権を付与できません。
サービス エージェントがない AI デベロッパー ツールのリクエストが Service agent SERVICE_AGENT_EMAIL not found エラーで失敗した場合は、欠落しているサービス エージェントを修正するの説明に従ってサービス エージェントを再作成します。

サービス エージェントが見つからない問題を修正する

AI デベロッパー ツールは、プロジェクト内の Googleマネージド サービス エージェントを使用して、割り当て超過時の従量課金制の使用や管理者コントロールなどのリクエストを処理します。サービス エージェントは、[AI デベロッパー ツール] の切り替えをオンにするか、Gemini Enterprise サブスクリプションを購入すると自動的に作成されます。

サービス エージェントがプロジェクトに存在しない場合、AI デベロッパー ツールからのリクエストは次のようなエラーで失敗します。

Service agent SERVICE_AGENT_EMAIL not found.

このエラーを修正するには、次のいずれかの方法でサービス エージェントを再作成します。

Google Cloud コンソールを使用する

  1. Google Cloud コンソールで、[Gemini Enterprise] に移動します。

    Gemini Enterprise に移動

  2. [設定] をクリックし、[AI デベロッパー ツール] タブを選択します。

  3. [AI デベロッパー ツール] をオフにします。

  4. [AI デベロッパー ツール] の切り替えを再度オンにします。

    この切り替えをオンにすると、プロジェクトにサービス エージェントが作成されます。切り替えをオフにしてから再度オンにしても、構成済みの AI デベロッパー ツールの設定はリセットされません。

gcloud CLI を使用する

  1. サービス エージェントを作成します。

    gcloud beta services identity create \
        --service=businessaicode.googleapis.com \
        --project=PROJECT_ID
    

    PROJECT_ID は、プロジェクトの ID に置き換えます。

    コマンド出力には、サービス エージェントのメールアドレスが含まれます。

  2. サービス エージェントに Business AI Code サービス エージェント(roles/businessaicode.serviceAgent)ロールを付与します。gcloud beta services identity create コマンドは、このロールを自動的に付与しません。

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:SERVICE_AGENT_EMAIL" \
        --role="roles/businessaicode.serviceAgent"
    

    次のように置き換えます。

    • PROJECT_ID: 実際のプロジェクトの ID。
    • SERVICE_AGENT_EMAIL: 前の手順の出力またはエラー メッセージに表示されたサービス エージェントのメールアドレス。

詳細については、gcloud beta services identity create をご覧ください。

次のステップ