配置 AI 开发者工具设置

您可以使用 Gemini Enterprise 中的 AI 开发者工具设置页面,为组织配置开发者工具、强制执行安全和合规性控制措施,以及管理模型可用性。

准备工作

请确保您已备好:

  • 按发票结算的 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 订阅类型:

  • 新的 Standard 版、Plus 版或随用随付版订阅:如果您购买订阅的地点或区域支持 AI 开发者工具,则默认情况下会在该地点或区域启用 AI 开发者工具。

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

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

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

    前往 Gemini Enterprise

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

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

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

配置安全设置

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

管理安全政策

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

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

管理外部 Web 访问权限

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

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

此设置仅适用于 Antigravity 浏览器智能体。您可以在 Antigravity 中运行浏览器智能体,方法是在聊天字段中输入/browser 命令。

无。默认情况下,系统不会屏蔽任何网址。
浏览器 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 绝不会出于模型训练或人工 审核目的访问这些日志。 已停用

配置模型可用性

您可以使用本部分中的设置来授权指定的 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 进行图片生成。使用这些模型可能会产生费用。如需了解详情,请参阅 配额和超额用量以及 跟踪第三方模型 token 用量。

配置授权的模型

您可以配置授权的模型,以控制哪些 AI 模型可供 AI 开发者工具使用。

设置 说明 默认状态
Antigravity 授权模型 启用此设置可指定 Antigravity 工具在项目中获授权使用的 AI 模型。除了 Google 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 2.0、Antigravity CLI 和 Antigravity for IDE)支持以下 Gemini 模型和 合作伙伴模型:

模型显示名称 提供方 在 Gemini Enterprise 中的可用性
Gemini 3.8 Flash Google 默认情况下,系统会为获得许可的用户启用此功能;可在 Antigravity 授权模型 中进行配置
Gemini 3.7 Flash Google 默认情况下,系统会为获得许可的用户启用此功能;可在 Antigravity 授权模型 中进行配置
Gemini 3.6 Flash Google 默认情况下,系统会为获得许可的用户启用此功能;可在 Antigravity 授权模型 中进行配置
Gemini 3.1 Pro(预览版) Google 默认情况下,系统会为获得许可的用户启用此功能;可在 Antigravity 授权模型 中进行配置
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 内容的项目,请开启沙盒模式 。
  • 鼓励开发者在批准智能体提出的命令和代码更改之前进行审核。
  • 设置每月支出限额 为项目。

后续步骤