配置 AI 开发者工具设置

使用 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(如果您尚未启用)。

启用 AI 开发者工具

AI 开发者工具的可用性取决于您的 Gemini Enterprise 订阅类型:

  • 新的标准版、Plus 版或随用随付订阅:如果您购买订阅的国家/地区支持 AI 开发者工具,则该工具在相应国家/地区默认处于启用状态。

  • 现有订阅:管理员必须在 Google Cloud 控制台中为每个位置手动启用 AI 开发者工具,才能为获得许可的用户激活这些工具。

如需为现有 Gemini Enterprise 订阅手动启用 AI 开发者工具,请按以下步骤操作:

  1. 在 Google Cloud 控制台中,前往 Gemini Enterprise。

    前往 Gemini Enterprise

  2. 点击设置,然后选择 AI 开发者工具标签页。

  3. 开启 AI 开发者工具切换开关。

  4. 在安全、合规性、功能和模型可用性部分中配置设置。

配置安全设置

作为管理员,您可以防止数据未经授权即在开发者界面中公开。使用本部分中的设置可限制对外部来源的访问并管理自动执行权限。例如,您可以强制执行强制性安全政策,以防止用户覆盖安全规则,并要求在 AI 智能体运行终端命令或选择链接之前获得批准。

管理安全政策

您可以配置安全政策,以控制 AI 智能体如何访问其工作文件夹之外的本地文件,以及如何在开发者工作区中执行终端命令。

设置 说明 默认状态
超出文件访问权限政策范围 指定智能体访问其指定工作文件夹之外的文件的权限级别。可用的选项如下:
  • Deny:禁止智能体访问其工作文件夹之外的文件。
  • 始终询问:在智能体访问其工作文件夹之外的文件之前,提示用户授予权限。
  • 允许:允许智能体在不提示的情况下访问其工作文件夹之外的文件。
拒绝
终端自动执行模式 启用此设置后,智能体可以自动运行终端命令,从而简化多步骤工作流。 可用的选项如下:
  • 需要审核:在运行任何终端命令之前,提示用户进行审批。
  • 在沙盒中继续:在安全的隔离环境中自动运行命令。
  • 始终继续:自动在当前环境中运行命令,而不会提示。
始终继续
沙盒模式 启用此设置可将智能体工具限制在安全、隔离的本地沙盒中。 已停用

管理外部网络访问权限

如果您的安全政策要求控制客服人员对外部网站的访问,以防止数据渗漏,您可以使用这些设置来限制浏览器访问,或将其限制为允许的网址列表。

设置 说明 默认状态
浏览器访问 启用此设置可控制外部网络访问。这可以防止数据渗漏并定义组织边界。 已停用
允许的网址 指定智能体可在浏览器中访问的允许网址列表。 配置后,系统会屏蔽所有其他网址。

此设置仅适用于 Antigravity 浏览器代理。您可以在聊天字段中输入 /browser 命令,在 Antigravity 中运行浏览器代理。

无。默认情况下,系统不会屏蔽任何网址。
浏览器 JavaScript 自动执行模式 启用此设置后,代理即可运行 JavaScript,以支持基于 Web 的高级编码和测试任务。 可用的选项如下:
  • 已停用:阻止代理运行 JavaScript。
  • 请求审核:在代理运行 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 服务器的配置。界面会针对以下字段提供实时验证:
  • 本地 MCP 服务器 (local_servers):
    • id(字符串):MCP 服务器的唯一标识符。
    • command(字符串,可选):用于运行本地 MCP 服务器的命令。如果指定,则此配置会替换用户的本地配置。
    • args(字符串数组,可选):传递给命令的参数。如果指定,这些设置会覆盖用户的本地配置。
  • 远程 MCP 服务器 (remote_servers):
    • id(字符串):MCP 服务器的唯一标识符。
    • url(字符串,可选):远程 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 或更高版本。

如需开启或关闭某项功能,请按以下步骤操作:

  1. 在 Google Cloud 控制台中,前往 Gemini Enterprise。

    Gemini Enterprise

  2. 点击设置,然后选择 AI 开发者工具标签页。

  3. 在功能部分中,点击修改。

  4. 针对每项功能,开启或关闭切换开关。

    设置 说明 默认状态
    /boost 命令 启用此设置后,用户可以运行分层多智能体层次结构,以解决复杂的算法挑战和深度调试任务。如需了解详情,请参阅提升深度推理能力。 已启用
    /teamwork-preview 命令 启用此设置后,用户可以部署由自主子智能体组成的协调框架,以执行大规模、长跨度的项目(预览版)。如需了解详情,请参阅团队协作智能体团队。 已启用
  5. 点击保存。

配置模型可用性

使用此部分中的设置可授权特定 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模型会自动提供给获得许可的用户。
  • 自定义模型列表:如果您选择一个或多个特定模型,则只有所选模型才会被允许使用。在管理员手动选择未选中的模型和新发布的模型之前,开发者无法使用这些模型。

如需配置授权模型,请执行以下操作:

  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 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(高)。默认值为“中”。启用第三方模型后,开发者可以使用其所有思考级别。您无法限制单个思考级别。

启用或停用第三方模型

第三方模型按随用随付用量计费,并需要支付超额费用。在启用第三方模型之前,请先启用超额用量。如果之后关闭了超额用量,开发者将无法使用第三方模型,直到重新开启超额用量。为了控制费用,您可以为项目设置每月支出限额。此限制适用于所有模型,包括第三方模型。

如需在 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 安全性。
  • 您的安全政策:您配置的安全政策和外部 Web 访问设置适用于智能体,无论开发者选择哪种模型。

最佳实践

  • 仅启用开发者需要的第三方模型。
  • 将终端自动执行模式设置为需要审核或在沙盒中继续,以便开发者在命令运行前批准命令。
  • 将超出文件访问权限政策范围设置为拒绝。
  • 开启浏览器访问权限,并将代理限制为只能访问允许的网址列表。
  • 为处理不受信任的代码、依赖项或 Web 内容的项目开启沙盒模式。
  • 鼓励开发者在批准代理提出的命令和代码更改之前,先对其进行审核。
  • 为您的项目设置每月支出限额。

修复缺失的服务代理

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 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。

后续步骤