使用 Gemini Enterprise 中的 AI 开发者工具设置页面,为您的组织配置开发者工具、实施安全和合规控制、启用或停用 Google Antigravity 功能,以及管理模型可用性。
准备工作
请确保您已备好:
采用账单结算方式的 Cloud Billing 账号:如需使用 AI 开发者工具,您的项目必须启用 Cloud Billing。AI 开发者工具仅适用于账单结算账号。如需了解详情,请参阅 Cloud Billing 账号类型。
支持的版本:如需使用 AI 开发者工具,用户必须订阅 Gemini Enterprise Standard 版、Plus 版、Standard 新兴市场版或随用随付版。
支持的区域:如需详细了解区域可用性和功能限制,请参阅 Gemini Enterprise Standard 版和 Plus 版以及 Gemini Notebook 的数据驻留。
所需角色:您必须拥有 Gemini Enterprise Admin (
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 订阅类型:
新的标准版、Plus 版或随用随付订阅:如果您购买订阅的国家/地区支持 AI 开发者工具,则该工具在相应国家/地区默认处于启用状态。
现有订阅:管理员必须在 Google Cloud 控制台中为每个位置手动启用 AI 开发者工具,才能为获得许可的用户激活这些工具。
如需为现有 Gemini Enterprise 订阅手动启用 AI 开发者工具,请按以下步骤操作:
在 Google Cloud 控制台中,前往 Gemini Enterprise。
点击设置,然后选择 AI 开发者工具标签页。
开启 AI 开发者工具切换开关。
配置安全设置
作为管理员,您可以防止数据未经授权即在开发者界面中公开。使用本部分中的设置可限制对外部来源的访问并管理自动执行权限。例如,您可以强制执行强制性安全政策,以防止用户覆盖安全规则,并要求在 AI 智能体运行终端命令或选择链接之前获得批准。
管理安全政策
您可以配置安全政策,以控制 AI 智能体如何访问其工作文件夹之外的本地文件,以及如何在开发者工作区中执行终端命令。
| 设置 | 说明 | 默认状态 |
|---|---|---|
| 超出文件访问权限政策范围 |
指定智能体访问其指定工作文件夹之外的文件的权限级别。可用的选项如下:
|
拒绝 |
| 终端自动执行模式 |
启用此设置后,智能体可以自动运行终端命令,从而简化多步骤工作流。
可用的选项如下:
|
始终继续 |
| 沙盒模式 | 启用此设置可将智能体工具限制在安全、隔离的本地沙盒中。 | 已停用 |
管理外部网络访问权限
如果您的安全政策要求控制客服人员对外部网站的访问,以防止数据渗漏,您可以使用这些设置来限制浏览器访问,或将其限制为允许的网址列表。
| 设置 | 说明 | 默认状态 |
|---|---|---|
| 浏览器访问 | 启用此设置可控制外部网络访问。这可以防止数据渗漏并定义组织边界。 | 已停用 |
| 允许的网址 |
指定智能体可在浏览器中访问的允许网址列表。
配置后,系统会屏蔽所有其他网址。
此设置仅适用于 Antigravity 浏览器代理。您可以在聊天字段中输入 |
无。默认情况下,系统不会屏蔽任何网址。 |
| 浏览器 JavaScript 自动执行模式 |
启用此设置后,代理即可运行 JavaScript,以支持基于 Web 的高级编码和测试任务。
可用的选项如下:
|
已停用 |
管理 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 绝不会出于模型训练或人工审核目的访问这些日志。 | 已停用 |
| 元数据日志记录 | 启用此设置可记录产品元数据,帮助您跟踪整个组织的使用情况和分析数据,包括第三方模型 token 消耗量。 系统会将日志安全地存储在您组织的项目内, Google 绝不会出于模型训练或人工审核目的访问这些日志。 | 已停用 |
配置功能设置
部分 Antigravity 功能提供高级多智能体功能,可帮助开发者处理复杂任务。由于这些功能可能会增加 token 用量和费用,因此请使用本部分中的设置来控制组织中用户的访问权限。如需使用已启用的功能,用户必须使用 Antigravity 应用 2.18.0 或更高版本,或者 Antigravity CLI 1.2.10 或更高版本。
如需开启或关闭某项功能,请按以下步骤操作:
在 Google Cloud 控制台中,前往 Gemini Enterprise。
点击设置,然后选择 AI 开发者工具标签页。
在功能部分中,点击修改。
针对每项功能,开启或关闭切换开关。
设置 说明 默认状态 /boost命令启用此设置后,用户可以运行分层多智能体层次结构,以解决复杂的算法挑战和深度调试任务。如需了解详情,请参阅提升深度推理能力。 已启用 /teamwork-preview命令启用此设置后,用户可以部署由自主子智能体组成的协调框架,以执行大规模、长跨度的项目(预览版)。如需了解详情,请参阅团队协作智能体团队。 已启用 点击保存。
配置模型可用性
使用此部分中的设置可授权特定 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 生成图片。使用这些模型可能会产生费用。如需了解详情,请参阅配额和超额用量以及跟踪第三方模型 token 用量。
配置授权模型
您可以配置授权模型,以控制 AI 开发者工具可以使用哪些 AI 模型。
Antigravity 授权模型设置的作用类似于许可清单:
- 默认选择(空):如果该字段为空,则允许使用所有受支持的 Gemini 模型。新发布的 Google模型会自动提供给获得许可的用户。
- 自定义模型列表:如果您选择一个或多个特定模型,则只有所选模型才会被允许使用。在管理员手动选择未选中的模型和新发布的模型之前,开发者无法使用这些模型。
如需配置授权模型,请执行以下操作:
在 Google Cloud 控制台中,前往 Gemini Enterprise。
点击设置,然后选择 AI 开发者工具标签页。
在模型可用性部分中,点击修改。
在 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 IDE)支持以下 Gemini 模型和合作伙伴模型。许可用户是指获配有效 Gemini Enterprise 席位许可(Standard、Plus 或随用随付)的开发者。如需了解详情,请参阅管理许可。
| 模型显示名称 | 提供方 | Gemini Enterprise 中的可用性 |
|---|---|---|
| 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 授权模型设置中,开启要启用的第三方模型对应的切换开关。
在随即显示的嵌入式《服务条款》对话框中,查看并接受第三方条款。
如果您停用某个第三方模型,开发者很快就会失去对该模型的访问权限。
如果模型提供商限制贵组织访问第三方模型,则开发者无法使用该模型。如需解决此问题,请与 Google Cloud 支持团队联系。
如需了解有关登录 Antigravity 和选择模型的开发者说明,请参阅 Antigravity 企业文档。
第三方模型的安全注意事项
AI 模型(包括第三方模型)可以遵循其处理的内容(例如文件、网页或工具输出)中隐藏的指令。这称为提示词注入。当开发者使用第三方模型时,Antigravity 会提供以下保护:
- 管理员选择启用:第三方模型默认处于关闭状态。只有在管理员启用第三方模型后,开发者才能使用该模型。
- 提供商安全保护措施:第三方模型包含提供商的内置安全保护措施。如需了解详情,请参阅 Claude 安全性。
- 您的安全政策:您配置的安全政策和外部 Web 访问设置适用于智能体,无论开发者选择哪种模型。
最佳实践
- 仅启用开发者需要的第三方模型。
- 将终端自动执行模式设置为需要审核或在沙盒中继续,以便开发者在命令运行前批准命令。
- 将超出文件访问权限政策范围设置为拒绝。
- 开启浏览器访问权限,并将代理限制为只能访问允许的网址列表。
- 为处理不受信任的代码、依赖项或 Web 内容的项目开启沙盒模式。
- 鼓励开发者在批准代理提出的命令和代码更改之前,先对其进行审核。
- 为您的项目设置每月支出限额。
修复缺失的服务代理
AI 开发者工具会使用您项目中由 Google代管式服务代理来处理超额和管理员控制等请求。当您开启 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 Service Agent (
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。