在 Gemini Enterprise 的 AI 開發人員工具設定頁面，您可以設定開發人員工具、強制執行安全性和法規遵循控管機制、啟用或停用 Google Antigravity 功能，以及管理貴組織可用的模型。
事前準備
請確認您已具備以下條件：
Cloud Billing 帳戶：如要使用 AI 開發人員工具，專案必須連結至符合資格的 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 (如果尚未啟用)。
- Discovery Engine API (
啟用 AI 開發人員工具
能否使用 AI 開發人員工具，取決於 Gemini Enterprise 訂閱類型：
新訂閱 Standard、Plus 或即付即用方案：如果購買訂閱方案的地點或區域支援 AI 開發人員工具，系統預設會啟用該工具。
現有訂閱方案：管理員必須在 Google Cloud 控制台中，手動為每個位置啟用 AI 開發人員工具，才能為授權使用者啟用工具。
如要為現有的 Gemini Enterprise 訂閱方案手動啟用 AI 開發人員工具，請按照下列步驟操作：
前往 Google Cloud 控制台的「Gemini Enterprise」。
按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。
開啟「AI 開發人員工具」切換鈕。
調整安全性設定
管理員可以防止資料未經授權即在開發人員介面公開。使用本節的設定，限制外部來源的存取權，並管理自動化執行權限。舉例來說，您可以強制執行安全性政策，防止使用者覆寫安全規則，並要求 AI 代理在執行終端機指令或選取連結前，必須先取得核准。
管理安全性政策
您可以設定安全性政策，控管 AI 代理如何存取工作資料夾以外的本機檔案，以及在開發人員工作區中執行終端機指令。
| 設定 | 說明 | 預設狀態 |
|---|---|---|
| 外部檔案存取政策 |
指定代理存取指定工作資料夾以外檔案的權限等級。可用的選項如下：
|
拒絕 |
| 終端機自動執行模式 |
啟用這項設定後，代理就能自動執行終端機指令，簡化多步驟工作流程。可用的選項如下：
|
一律繼續執行 |
| 沙箱模式 | 啟用這項設定，即可限制代理工具只能在安全且隔離的本機沙箱執行。 | 已停用 |
管理外部網路存取權
如果安全政策要求控管代理程式對外部網站的存取權，以防資料竊取，您可以使用這些設定限制瀏覽器存取權，或僅限存取允許的網址清單。
| 設定 | 說明 | 預設狀態 |
|---|---|---|
| 瀏覽器存取權 | 啟用這項設定，即可控管外部網路存取權。這麼做可防範資料遭到竊取，並定義組織邊界。 | 已停用 |
| 允許的網址 |
指定代理可在瀏覽器中存取的許可網址清單。
設定完成後，系統會封鎖所有其他網址。
這項設定僅適用於 Antigravity 瀏覽器代理。只要在對話欄位中輸入 |
無，根據預設，系統不會封鎖任何網址。 |
| 瀏覽器 JavaScript 自動執行模式 |
啟用這項設定，即可允許代理執行 JavaScript，處理進階網頁式程式設計和測試工作。可用的選項如下：
|
已停用 |
管理 Model Context Protocol (MCP)
您可以設定 Model Context Protocol (MCP) 伺服器的存取權，讓 AI 代理安全存取其他資料來源和工具。
| 設定 | 說明 | 預設狀態 |
|---|---|---|
| MCP 伺服器 |
啟用這項設定，即可管理 Model Context Protocol (MCP) 伺服器的存取權，安全擴充 AI 的資料脈絡。 如要使用支援代理用戶端通訊協定 (ACP) 的 IDE (例如 Android Studio 和 JetBrains IDE)，就必須啟用 MCP。在這些環境中，管理員控制項會盡可能運作，因為 IDE 可以插入不受強制執行的 MCP 工具。 |
已停用 |
| 獲准伺服器設定 |
管理員可以透過這項設定，定義 MCP 伺服器存取權的特定伺服器設定。管理員會將許可清單定義為 JSON 物件，其中包含本機和遠端 MCP 伺服器的設定。使用者介面會即時驗證下列欄位：
範例設定{ "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 絕對不會用於模型訓練，Google 人員也不會查看。 | 已停用 |
調整功能設定
部分 Antigravity 功能提供進階的多代理能力，可協助開發人員處理複雜工作。這些功能可能會增加詞元用量和費用，因此請使用本節的設定，控管貴機構使用者的存取權。如要存取已啟用的功能，使用者必須使用 Antigravity 應用程式 2.18.0 以上版本，或 Antigravity CLI 1.2.10 以上版本。
如要啟用或停用功能，請按照下列步驟操作：
前往 Google Cloud 控制台的「Gemini Enterprise」。
按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。
在「功能」部分，按一下「編輯」。
開啟或關閉各項功能的切換鈕。
設定 說明 預設狀態 /boost指令啟用這項設定後，使用者就能執行分層的多代理階層，解決複雜的演算法難題和深度偵錯工作。詳情請參閱「強化深度推論」。 已啟用 /teamwork-preview指令啟用這項設定後，使用者就能部署自主子代理的協調架構，執行大規模、長程專案 (預先發布版)。詳情請參閱「Teamwork 代理團隊」。 已啟用 按一下「儲存」。
設定模型供應情形
您可以使用本節的設定，授權特定 AI 模型及管理存取層級。確保開發人員只使用符合組織安全性和使用政策的 AI 模型。例如，您可以讓開發人員存取預先發布版模型進行實驗，或限制工具只能使用授權模型。
設定模型前的重要考量
設定模型前，請先考量以下事項：
政策一致性：在 Gemini Enterprise 啟用模型，不會覆寫 Gemini Enterprise Agent Platform 組織政策。為避免超過標準配額的即付即用要求失敗，請確保兩個平台允許的模型一致。
資料落地：預先發布版模型和 Gemini 3 Pro 圖像模型僅適用於
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模型會自動開放給授權使用者。
- 自訂模型清單：如果選取一或多個特定模型，則只能使用所選模型。未選取的模型和新推出的模型，必須由管理員手動選取，開發人員才能使用。
如要設定授權模型，請按照下列步驟操作：
前往 Google Cloud 控制台的「Gemini Enterprise」。
按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。
在「模型可用性」部分，按一下「編輯」。
在「Antigravity authorized models」(Antigravity 授權模型) 欄位中，選取要允許的模型。如要允許所有支援的模型，請將欄位留空。
按一下「儲存」。
| 設定 | 說明 | 預設狀態 |
|---|---|---|
| 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 IDEs) 支援下列 Gemini 模型和合作夥伴模型。授權使用者是指獲派有效 Gemini Enterprise 帳戶名額授權 (Standard、Plus 或即付即用) 的開發人員。詳情請參閱「管理授權」。
| 模型顯示名稱 | 提供者 | Gemini Enterprise 適用情形 |
|---|---|---|
| Gemini 4 Hydrogen | 如果啟用預設模型選取功能 (空白清單)，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 4 Carbon | 如果啟用預設模型選取功能 (空白清單)，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 4 Argon | 如果啟用預設模型選取功能 (空白清單)，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 3.8 Flash | 如果啟用預設模型選取功能，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 3.7 Flash | 如果啟用預設模型選取功能，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 3.6 Flash | 如果啟用預設模型選取功能，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| Gemini 3.1 Pro (預先發布版) | 如果啟用預設模型選取功能，系統預設會為授權使用者啟用這項功能。如果已設定自訂模型清單，則必須手動選取模型。 | |
| 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 (高)。預設為中。啟用第三方模型後，開發人員就能使用該模型的所有思考等級。無法限制個別思考等級。
啟用或停用第三方模型
第三方模型會依即付即用模式計費。如果您使用授權版，請先啟用超額用量即付即用功能，再啟用第三方模型。如果之後關閉「用量超過配額時採用即付即用模式」，開發人員就無法使用第三方模型，直到您重新啟用為止。如要控管成本，可以為專案設定每月支出上限。這項限制適用於所有模型，包括第三方模型。
如要在 Google Cloud 控制台啟用或管理第三方模型 (例如 Anthropic Claude Opus 5.5 和 Anthropic Claude Sonnet 5.5)，請按照下列步驟操作：
前往 Google Cloud 控制台的「Gemini Enterprise」。
按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。
在「Antigravity authorized models」(Antigravity 授權模型) 設定中，開啟要啟用的第三方模型切換鈕。
在顯示的嵌入式《服務條款》對話方塊中，詳閱並接受第三方條款。
如果停用第三方模型，開發人員很快就會失去存取權。
如果模型供應商限制貴組織存取第三方模型，開發人員就無法使用該模型。如要解決問題，請與 Google Cloud Support聯絡。
如需開發人員操作說明，瞭解如何登入 Antigravity 並選取模型，請參閱 Antigravity Enterprise 說明文件。
第三方模型的安全性考量
AI 模型 (包括第三方模型) 可能會遵循隱藏在處理內容中的指令，例如檔案、網頁或工具輸出內容。這稱為提示詞注入。開發人員使用第三方模型時，Antigravity 會提供下列保護措施：
- 管理員選擇加入：第三方模型預設為關閉。管理員啟用第三方模型後，開發人員才能使用。
- 供應商安全防護措施：第三方模型內建供應商的安全防護措施。詳情請參閱「Claude 安全性」。
- 安全性政策：無論開發人員選取何種模型，您設定的安全性政策和外部網路存取權設定都會套用至代理。
最佳做法
- 僅啟用開發人員需要的第三方模型。
- 將「終端機自動執行模式」設為「需要審查」或「在沙箱中繼續」，讓開發人員在指令執行前先核准。
- 將「外部檔案存取政策」設為「拒絕」。
- 開啟「瀏覽器存取權」，並將代理程式限制在「允許的網址」清單中。
- 如果專案會處理不受信任的程式碼、依附元件或網路內容，請開啟「沙箱模式」。
- 建議開發人員先審查代理提出的指令和程式碼變更，再核准。
- 設定專案的每月支出上限。
疑難排解
本節說明如何解決設定或存取 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 Billing 帳戶，或可開立月結單帳單帳戶的帳單子帳戶。免費試用方案包含 AI 開發人員工具，但配額有限，且專案必須連結至可開立月結單的帳單帳戶。如果帳單帳戶仍處於 Google Cloud 免費試用期，請升級為付費帳單帳戶，才能使用 AI 開發人員工具。經銷商代管的子帳戶不支援預付抵免額。如要排解帳單錯誤，請參閱「排解帳單問題」。 |
| 指派座位和選取專案 | 請確認開發人員在登入時選取了分配授權的 Google Cloud 專案，且所選位置的訂閱方案有未指派的名額。如果所有授權都已指派，請在訂閱方案中新增授權，或在「管理使用者」頁面中將授權指派給使用者。 |
| AI 開發人員工具切換鈕 |
如果是現有訂閱方案，管理員必須在每個多區域位置 (global、us 或 eu) 手動開啟「AI 開發人員工具」切換鈕，方法是依序前往「Gemini Enterprise」>「設定」>「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 developer tools」(AI 開發人員工具) 切換鈕或購買 Gemini Enterprise 訂閱方案時，系統會自動建立服務代理。
如果專案中沒有服務代理，AI 開發人員工具的要求會失敗，並顯示類似下列的錯誤：
Service agent SERVICE_AGENT_EMAIL not found.
如要修正這項錯誤，請使用下列任一方法重新建立服務代理。
使用 Google Cloud 控制台
前往 Google Cloud 控制台的「Gemini Enterprise」。
按一下「設定」，然後選取「AI 開發人員工具」分頁標籤。
關閉「AI 開發人員工具」切換鈕。
再次開啟「AI 開發人員工具」切換鈕。
開啟切換鈕後，系統會在專案中建立服務代理。關閉切換鈕再重新開啟，不會重設已設定的 AI 開發人員工具。
使用 gcloud CLI
建立服務代理：
gcloud beta services identity create \ --service=businessaicode.googleapis.com \ --project=PROJECT_ID將
PROJECT_ID替換為專案 ID。指令輸出內容會包含服務代理的電子郵件地址。
將 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。