設定 AI 開發人員工具

在 Gemini Enterprise 的 AI 開發人員工具設定頁面，您可以設定開發人員工具、強制執行安全性和法規遵循控管機制、啟用或停用 Google Antigravity 功能，以及管理貴組織可用的模型。

事前準備

請確認下列各項均已達成或備妥：

• Cloud Billing 帳戶：如要使用 AI 開發人員工具，專案必須啟用 Cloud Billing。如果使用自助式 (線上) 帳單帳戶，您可以使用預付抵免額，支付即付即用版本用量和超額用量。詳情請參閱「Cloud Billing 帳戶類型」。

• 支援的版本：使用者必須訂閱 Gemini Enterprise Standard、Plus、Standard Emerging Market 或即付即用版本，才能存取 AI 開發人員工具。

• 支援的區域：如要進一步瞭解區域可用性和功能限制，請參閱「Gemini Enterprise Standard 和 Plus 版以及 Gemini Notebook 的資料落地」。

• 必要角色：您必須具備 Gemini Enterprise 管理員 (roles/discoveryengine.agentspaceAdmin) 角色，才能調整 AI 開發人員工具設定。

• 必要 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 代理如何存取工作資料夾以外的本機檔案，以及在開發人員工作區中執行終端機指令。

管理外部網路存取權

如果安全政策要求控管代理程式對外部網站的存取權，以防資料竊取，您可以使用這些設定限制瀏覽器存取權，或僅允許存取特定網址。

管理 Model Context Protocol (MCP)

您可以設定 Model Context Protocol (MCP) 伺服器的存取權，讓 AI 代理安全存取其他資料來源和工具。

{
  "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 互動的稽核記錄，以符合法規。您可以在這個部分設定記錄和資料保留政策，以符合法律和法規要求。

調整功能設定

部分 Antigravity 功能提供進階的多代理能力，可協助開發人員處理複雜工作。這些功能可能會增加詞元用量和費用，因此請使用本節中的設定，控管貴機構使用者的存取權。如要存取已啟用的功能，使用者必須使用 Antigravity 應用程式 2.18.0 以上版本，或 Antigravity CLI 1.2.10 以上版本。

如要啟用或停用功能，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」。

   Gemini Enterprise

2. 按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。

3. 在「功能」部分，按一下「編輯」。

4. 開啟或關閉各項功能的切換鈕。

   設定	說明	預設狀態
   /boost 指令	啟用這項設定後，使用者就能執行多層級的多代理階層，解決複雜的演算法難題和深度偵錯工作。詳情請參閱「強化深度推論」。	已啟用
   /teamwork-preview 指令	啟用這項設定後，使用者就能部署協調的自主子代理架構，執行大規模、長程專案 (預先發布版)。詳情請參閱「Teamwork 代理團隊」。	已啟用

5. 按一下「儲存」。

設定模型供應情形

您可以使用本節的設定，授權特定 AI 模型及管理存取層級，確保開發人員只使用符合組織安全性和使用政策的 AI 模型。舉例來說，您可以授予開發人員預先發布版模型的存取權，以便進行實驗，或限制工具只能使用授權模型。

設定模型前的考量重點

設定模型前，請考量下列事項：

• 政策一致性：在 Gemini Enterprise 啟用模型，不會覆寫 Gemini Enterprise Agent Platform 組織政策。為避免超過標準配額的即付即用要求失敗，請確保兩個平台允許的模型一致。

• 資料落地：預先發布版模型和 Gemini 3 Pro Image 模型僅適用於 global 區域。因此，在美國或歐盟多區域中，不支援資料落地 (DRZ) 或機器學習 (ML) 區域處理承諾。

• 第三方模型推論和資料處理：管理員必須啟用第三方模型並接受供應商條款，才能使用這些模型。開發人員選取已啟用的第三方模型時，Gemini Enterprise 會將提示和該要求所需的程式碼脈絡傳送至模型，並採用與 Gemini 模型相同的處理和保護措施。提示和回覆不會用於訓練模型。 第三方模型推論功能適用於 global、us 和 eu 位置。不支援國內區域。如要查看可存取模型的國家/地區清單，請參閱 Anthropic 的支援國家/地區。如要進一步瞭解資料落地，請參閱「Gemini Enterprise Standard 和 Plus 版以及 Gemini Notebook 的資料落地」。

• 混合執行和計費揭露事項：Gemini 模型會從貴組織共用的版本授權抵免額扣除，而管理員啟用的第三方模型則會依 Cloud Billing 帳戶的即付即用用量計費。開發人員選取已啟用的第三方模型 (例如 Anthropic Claude Opus 5.5 或 Anthropic Claude Sonnet 5.5)，用於主要推論、規劃、工具自動化調度管理和程式碼生成工作時，Antigravity 會繼續在背景使用輕量 Gemini 模型進行用戶端協調 (例如內容管理和摘要)，並使用 Gemini 3 Pro Image 圖像生成器生成圖片。使用這些模型可能會產生費用。詳情請參閱「配額和即付即用用量」和「追蹤第三方模型權杖用量」。

設定授權模型

您可以設定授權模型，控管 AI 開發人員工具可使用的 AI 模型。

「Antigravity authorized models」(Antigravity 授權模型) 設定會做為許可清單：

• 預設選項 (空白)：如果欄位留空，則允許所有支援的 Gemini 模型。新推出的 Google模型會自動開放給授權使用者。
• 自訂模型清單：如果選取一或多個特定模型，則只能使用所選模型。未選取的模型和新推出的模型，必須由管理員手動選取，開發人員才能使用。

如要設定授權模型，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」。

   前往 Gemini Enterprise

2. 按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。

3. 在「模型可用性」部分，按一下「編輯」。

4. 在「Antigravity authorized models」(Antigravity 授權模型) 欄位中，選取要允許的模型。如要允許所有支援的模型，請將欄位留空。

5. 按一下「儲存」。

支援的模型

AI 開發人員工具 (Antigravity 應用程式、Antigravity CLI 和 Antigravity for IDEs) 支援下列 Gemini 模型和合作夥伴模型。授權使用者是指獲派有效 Gemini Enterprise 席位授權 (Standard、Plus 或即付即用) 的開發人員。詳情請參閱「管理授權」。

如要瞭解配額和集區版抵免額，請參閱「配額和即付即用用量」和「設定超額用量 (即付即用)」。如要瞭解第三方模型定價，請參閱 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 (高)。預設為中。啟用第三方模型後，開發人員就能使用該模型的所有思考等級。無法限制個別思考等級。

啟用或停用第三方模型

第三方模型會依即付即用模式計費。如果您使用授權版，請先啟用「超額用量 (即付即用)」，再啟用第三方模型。如果之後關閉「用量超過配額時採用即付即用模式」，開發人員就無法使用第三方模型，直到您重新啟用為止。如要控管成本，可以為專案設定每月支出上限。這項限制適用於所有模型，包括第三方模型。

如要在 Google Cloud 控制台啟用或管理第三方模型 (例如 Anthropic Claude Opus 5.5 和 Anthropic Claude Sonnet 5.5)，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Gemini Enterprise」。

   前往 Gemini Enterprise

2. 按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。

3. 在「Antigravity authorized models」(Antigravity 授權模型) 設定中，開啟要啟用的第三方模型切換鈕。

4. 在顯示的嵌入式《服務條款》對話方塊中，詳閱並接受第三方條款。

如果停用第三方模型，開發人員很快就會失去存取權。

如果模型供應商限制貴組織存取第三方模型，開發人員就無法使用該模型。如要解決問題，請與 Google Cloud Support聯絡。

如需開發人員操作說明，瞭解如何登入 Antigravity 和選取模型，請參閱 Antigravity Enterprise 說明文件。

第三方模型的安全性考量

AI 模型 (包括第三方模型) 可能會遵循處理內容 (例如檔案、網頁或工具輸出內容) 中隱藏的指令。這稱為提示詞注入。開發人員使用第三方模型時，Antigravity 會提供下列保護措施：

• 管理員選擇加入：第三方模型預設為關閉。管理員啟用第三方模型後，開發人員才能使用。
• 供應商安全防護措施：第三方模型內建供應商的安全防護措施。詳情請參閱「Claude 安全性」。
• 安全性政策：無論開發人員選取何種模型，您設定的安全性政策和外部網路存取權設定都會套用至代理。

最佳做法

• 僅啟用開發人員需要的第三方模型。
• 將「Terminal auto-execution mode」(終端機自動執行模式) 設為「Require review」(需要審查) 或「Proceed in sandbox」(在沙箱中繼續)，讓開發人員在指令執行前先核准。
• 將「外部檔案存取政策」設為「拒絕」。
• 開啟「瀏覽器存取權」，並將代理程式限制在「允許的網址」清單中。
• 如果專案會處理不受信任的程式碼、依附元件或網路內容，請開啟「沙箱模式」。
• 建議開發人員先審查代理提出的指令和程式碼變更，再核准。
• 設定專案的每月支出上限。

修正缺少服務代理的問題

AI 開發人員工具會使用專案中由 Google管理的服務代理，處理超額用量 (即付即用) 和管理員控制項等要求。開啟「AI developer tools」(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。

後續步驟

• 追蹤第三方模型詞元用量
• 查看 AI 開發人員工具指標
• 建立 AI 開發人員工具的自訂角色
• 停用 AI 開發人員工具