Configurar as ferramentas de IA para desenvolvedores

Use a página de configurações das ferramentas para desenvolvedores de IA no Gemini Enterprise para configurar ferramentas para desenvolvedores, aplicar controles de segurança e conformidade, ativar ou desativar recursos do Google Antigravity e gerenciar a disponibilidade de modelos para sua organização.

Antes de começar

Verifique se você tem o seguinte:

  • Conta do Cloud Billing faturada: para usar as ferramentas de desenvolvedor de IA, seu projeto precisa ter o Cloud Billing ativado. As ferramentas de IA para desenvolvedores estão disponíveis apenas para contas faturadas. Para mais informações, consulte os Tipos de conta do Cloud Billing.

  • Edições compatíveis: para acessar as ferramentas de IA para desenvolvedores, os usuários precisam ter uma assinatura da edição Gemini Enterprise Standard, Plus, Standard para mercados emergentes ou de pagamento por uso.

  • Regiões com disponibilidade: para mais informações sobre a disponibilidade regional e as limitações de recursos, consulte Residência de dados para as edições Gemini Enterprise Standard e Plus e o Gemini Notebook.

  • Papéis necessários: você precisa ter o papel de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) para definir as configurações das ferramentas para desenvolvedores de IA.

  • APIs necessárias: seu projeto precisa ter as seguintes APIs ativadas:

    • API Discovery Engine (discoveryengine.googleapis.com): oferece serviços essenciais de plataforma, controles de segurança e compliance e gerenciamento de configurações para o Gemini Enterprise.
    • A API Business AI Code (businessaicode.googleapis.com) oferece geração de código com tecnologia de IA para o Antigravity no Gemini Enterprise. Você precisa ativar essa API no projeto para permitir que principais autorizados alcancem o serviço do projeto.

    Quando você ativa a opção ferramentas para desenvolvedores de IA no console do Google Cloud , o sistema verifica a configuração do projeto e ativa automaticamente as APIs necessárias, caso ainda não tenham sido ativadas.

Ativar as ferramentas de IA para desenvolvedores

A disponibilidade das ferramentas para desenvolvedores de IA depende do tipo de assinatura do Gemini Enterprise:

  • Novas assinaturas Standard, Plus ou de pagamento por uso: as ferramentas para desenvolvedores de IA são ativadas por padrão no local em que você comprou a assinatura, se ela for compatível com esse local ou região.

  • Assinaturas atuais: um administrador precisa ativar manualmente as ferramentas para desenvolvedores de IA no console do Google Cloud em cada local para que os usuários licenciados possam usá-las.

Para ativar manualmente as ferramentas para desenvolvedores de IA em uma assinatura do Gemini Enterprise, siga estas etapas:

  1. No console do Google Cloud , acesse Gemini Enterprise.

    Acessar o Gemini Enterprise

  2. Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.

  3. Ative a opção Ferramentas de IA para desenvolvedores.

  4. Defina as configurações nas seções Segurança, Compliance, Recursos e Disponibilidade do modelo.

Definir configurações de segurança

Como administrador, você pode impedir a exposição não autorizada de dados em interfaces de desenvolvedor. Use as configurações desta seção para restringir o acesso a fontes externas e gerenciar permissões de execução automatizadas. Por exemplo, é possível aplicar políticas de segurança obrigatórias para impedir que os usuários substituam as regras de segurança e exigir aprovação antes que os agentes de IA executem comandos de terminal ou selecionem links.

Gerenciar políticas de segurança

É possível configurar políticas de segurança para controlar como os agentes de IA acessam arquivos locais fora das pastas de trabalho e executam comandos de terminal em espaços de trabalho de desenvolvedor.

Configuração Descrição Status padrão
Fora da política de acesso ao arquivo Especifique o nível de permissão do agente para acessar arquivos fora das pastas de trabalho designadas. As seguintes opções estão disponíveis:
  • Negar: impede que o agente acesse arquivos fora das pastas de trabalho.
  • Sempre perguntar: solicita permissão ao usuário antes que o agente acesse arquivos fora das pastas de trabalho.
  • Permitir: permite que o agente acesse arquivos fora das pastas de trabalho sem solicitar.
Negar
Modo de execução automática do terminal Ative essa configuração para permitir que os agentes executem comandos de terminal automaticamente para simplificar fluxos de trabalho com várias etapas. As seguintes opções estão disponíveis:
  • Exigir revisão: pede a aprovação do usuário antes de executar qualquer comando do terminal.
  • Continuar no sandbox: executa comandos automaticamente em um ambiente seguro e isolado.
  • Sempre continuar: executa comandos automaticamente no ambiente atual sem solicitar.
Sempre continuar
Modo sandbox Ative essa configuração para restringir as ferramentas do agente a um sandbox local seguro e isolado. Desativado

Gerenciar o acesso externo à Web

Se os requisitos da política de segurança exigirem o controle do acesso do agente a sites externos para evitar a exfiltração de dados, essas configurações vão permitir que você limite o acesso do navegador ou o restrinja a uma lista de URLs permitidos.

Configuração Descrição Status padrão
Acesso ao navegador Ative essa configuração para controlar o acesso externo à Web. Isso evita a exfiltração de dados e define limites organizacionais. Desativado
URLs permitidos Especifique uma lista de URLs permitidos que o agente pode acessar no navegador. Quando configurado, o sistema bloqueia todos os outros URLs.

Essa configuração se aplica apenas ao agente do navegador Antigravity. Para executar o agente do navegador no Antigravity, digite o comando /browser no campo de chat.

Nenhuma. Por padrão, nenhum URL é bloqueado.
Modo de execução automática de JavaScript do navegador Ative essa configuração para permitir que os agentes executem JavaScript e ofereçam suporte a tarefas avançadas de programação e teste baseadas na Web. As seguintes opções estão disponíveis:
  • Desativado: impede que o agente execute JavaScript.
  • Solicitar revisão: pede aprovação do usuário antes que o agente execute JavaScript.
  • Permitido: permite que o agente execute JavaScript automaticamente.
Desativado

Gerenciar o Protocolo de Contexto de Modelo (MCP)

É possível configurar o acesso aos servidores do Protocolo de Contexto de Modelo (MCP), o que permite que os agentes de IA acessem com segurança mais fontes de dados e ferramentas.

Configuração Descrição Status padrão
Servidores MCP Ative essa configuração para gerenciar o acesso aos servidores do Protocolo de Contexto de Modelo (MCP) e estender com segurança o contexto de dados da IA.

O MCP é necessário para usar ambientes de desenvolvimento integrado que oferecem suporte ao Agent Client Protocol (ACP), como o Android Studio e os ambientes de desenvolvimento integrado do JetBrains. Nesses ambientes, os controles de administrador operam com base no melhor resultado, porque os ambientes de desenvolvimento integrado podem injetar as próprias ferramentas de MCP que não estão sujeitas à aplicação.

Desativado
Configuração de servidor permitida Essa configuração permite que os administradores definam configurações de servidor específicas para o acesso ao servidor MCP. Os administradores definem a lista de permissões como um objeto JSON com configurações para servidores MCP locais e remotos. A interface oferece validação em tempo real para os seguintes campos:
  • Servidores MCP locais (local_servers):
    • id (string): o identificador exclusivo do servidor MCP.
    • command (string, opcional): o comando para executar o servidor MCP local. Se especificado, isso vai substituir a configuração local do usuário.
    • args (matriz de strings, opcional): os argumentos transmitidos ao comando. Se especificados, eles substituem a configuração local do usuário.
  • Servidores MCP remotos (remote_servers):
    • id (string): o identificador exclusivo do servidor MCP.
    • url (string, opcional): o URL do endpoint do servidor MCP remoto. Obrigatório para servidores remotos personalizados e opcional para servidores remotos pré-configurados.

Exemplo de configuração

{
  "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"
      }
    ]
  }
}
Não configurado

Definir as configurações de compliance

Se a sua organização opera em um setor regulamentado ou tem políticas internas específicas, talvez seja necessário manter registros de auditoria das interações de IA para fins de conformidade. As configurações desta seção permitem definir políticas de geração de registros e retenção de dados para atender aos requisitos legais e regulatórios.

Configuração Descrição Status padrão
Geração de registros de comandos e respostas Ative essa configuração para registrar as interações entre os desenvolvedores e a IA para calcular métricas de uso e manter uma trilha de auditoria para revisões de segurança. O sistema armazena os registros com segurança no projeto da sua organização, e o Google nunca acessa os registros para treinamento de modelo ou revisão humana. Desativado
Registro de metadados Ative essa configuração para registrar metadados do produto e acompanhar o uso e as análises em toda a organização, incluindo o consumo de tokens de modelos de terceiros. O sistema armazena os registros com segurança no projeto da sua organização e Google nunca os acessa para treinamento de modelo ou revisão humana. Desativado

Definir as configurações de recursos

Alguns recursos do Antigravity oferecem recursos agênticos multiagente avançados para ajudar os desenvolvedores a lidar com tarefas complexas. Como esses recursos podem aumentar o uso de tokens e os custos, use as configurações desta seção para controlar o acesso dos usuários na sua organização. Para acessar os recursos ativados, os usuários precisam usar a versão 2.18.0 ou mais recente do app Antigravity ou a versão 1.2.10 ou mais recente da CLI do Antigravity.

Para ativar ou desativar um recurso, siga estas etapas:

  1. No console do Google Cloud , acesse Gemini Enterprise.

    Gemini Enterprise

  2. Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.

  3. Na seção Recursos, clique em Editar.

  4. Ative ou desative cada recurso.

    Configuração Descrição Status padrão
    Comando /boost Ative essa configuração para permitir que os usuários executem uma hierarquia de multiagentes em níveis para resolver desafios algorítmicos complexos e tarefas de depuração profunda. Para mais informações, consulte Otimizar o raciocínio profundo. Ativado
    Comando /teamwork-preview Ative essa configuração para permitir que os usuários implantem uma estrutura coordenada de subagentes autônomos para executar projetos de grande escala e longo prazo (prévia). Para mais informações, consulte Equipes de agentes do Teamwork. Ativado
  5. Clique em Salvar.

Configurar a disponibilidade do modelo

Use as configurações nesta seção para autorizar modelos de IA específicos e gerenciar níveis de acesso. Isso garante que os desenvolvedores usem apenas modelos de IA que estejam em conformidade com as políticas de segurança e uso da sua organização. Por exemplo, é possível dar aos desenvolvedores acesso a modelos de pré-lançamento para experimentos ou restringir as ferramentas para usar apenas modelos autorizados.

Principais considerações antes de configurar modelos

Antes de configurar os modelos, considere o seguinte:

  • Alinhamento de políticas:ativar um modelo no Gemini Enterprise não substitui as políticas da organização da Gemini Enterprise Agent Platform. Para evitar que as solicitações de pagamento por uso que excedem sua cota padrão falhem, verifique se os modelos permitidos são os mesmos nas duas plataformas.

  • Residência de dados:os modelos de prévia e o modelo Gemini 3 Pro Image estão disponíveis apenas na região global. Portanto, eles não oferecem suporte a compromissos de residência de dados (DRZ) ou de processamento regional de machine learning (ML) nas multirregiões dos EUA ou da UE.

  • Inferência de modelos e tratamento de dados de terceiros:os modelos de terceiros só ficam disponíveis depois que um administrador os ativa e aceita os termos do provedor. Quando um desenvolvedor seleciona um modelo de terceiros ativado, o Gemini Enterprise envia o comando e o contexto de código necessários para essa solicitação ao modelo, com o mesmo processamento e as mesmas proteções dos modelos do Gemini. Os comandos e as respostas não são usados para treinar modelos. A inferência de modelos de terceiros está disponível nos locais global, us e eu. As regiões no país não são aceitas. Para ver a lista de países e regiões que podem acessar o modelo, consulte os países e regiões com suporte da Anthropic. Para mais informações sobre residência de dados, consulte Residência de dados para as edições Standard e Plus do Gemini Enterprise e o Gemini Notebook.

  • Execução híbrida e declarações de faturamento:os modelos do Gemini usam os créditos de licença da edição em pool da sua organização, enquanto os modelos de terceiros ativados pelo administrador são faturados como uso de pagamento por uso na sua conta do Cloud Billing. Quando um desenvolvedor seleciona um modelo de terceiros ativado (como o Anthropic Claude Opus 5.5 ou o Anthropic Claude Sonnet 5.5) para tarefas principais de raciocínio, planejamento, orquestração de ferramentas e geração de código, o Antigravity continua usando modelos leves do Gemini em segundo plano para coordenação do lado do cliente, como gerenciamento de contexto e resumos, e o Gemini 3 Pro Image para geração de imagens. O uso desses modelos pode gerar cobranças. Para mais informações, consulte Cotas e excedentes e Rastrear o uso de tokens de modelos de terceiros.

Configurar modelos autorizados

É possível configurar modelos autorizados para controlar quais modelos de IA estão disponíveis para suas ferramentas para desenvolvedores de IA.

A configuração Modelos autorizados do Antigravity funciona como uma lista de permissões:

  • Seleção padrão (vazia): quando o campo está vazio, todos os modelos do Gemini compatíveis são permitidos. Os modelos Googlelançados recentemente ficam disponíveis automaticamente para usuários licenciados.
  • Lista de modelos personalizados: quando você seleciona um ou mais modelos específicos, apenas os modelos selecionados são permitidos. Os modelos não selecionados e os recém-lançados não ficam disponíveis para os desenvolvedores até que um administrador os selecione manualmente.

Para configurar modelos autorizados:

  1. No console Google Cloud , acesse Gemini Enterprise.

    Acessar o Gemini Enterprise

  2. Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.

  3. Na seção Disponibilidade do modelo, clique em Editar.

  4. No campo Modelos autorizados do Antigravity, selecione os modelos que você quer permitir. Para permitir todos os modelos compatíveis, deixe o campo vazio.

  5. Clique em Salvar.

Configuração Descrição Status padrão
Modelos Antigravity autorizados Especifique quais modelos de IA a ferramenta Antigravity está autorizada a usar no projeto. Deixe o campo em branco para permitir todos os modelos do Gemini compatíveis. Se você especificar uma lista personalizada de modelos, a configuração vai funcionar como uma lista de permissões, e os modelos lançados recentemente ou não selecionados precisarão ser adicionados manualmente para ficarem disponíveis. Além dos modelos do Gemini criados pelo Google, os administradores podem ativar modelos de terceiros, incluindo o Anthropic Claude Opus 5.5 e o Anthropic Claude Sonnet 5.5. Para informações sobre as capacidades, limitações e avaliações de segurança de cada modelo, consulte os cards dos modelos Anthropic Claude Opus 5.5 e Anthropic Claude Sonnet 5.5. Vazio (todos os modelos do Gemini são permitidos). Os modelos de terceiros ficam desativados por padrão e exigem o consentimento do administrador.

Modelos compatíveis

As ferramentas de IA para desenvolvedores (app Antigravity, CLI do Antigravity e Antigravity para IDEs) são compatíveis com os seguintes modelos do Gemini e de parceiros. Um usuário licenciado é um desenvolvedor que recebeu uma licença ativa do Gemini Enterprise (Standard, Plus ou pagamento por uso). Para mais informações, consulte Gerenciar licenças.

Nome de exibição do modelo Provedor Disponibilidade no Gemini Enterprise
Gemini 4 Argon Google Ativado por padrão para usuários licenciados quando a seleção de modelo padrão está ativa (lista vazia). Se uma lista de modelos personalizados estiver configurada, o modelo precisará ser selecionado manualmente.
Gemini 3.8 Flash Google Ativado por padrão para usuários licenciados quando a seleção de modelo padrão está ativa. Se uma lista de modelos personalizados estiver configurada, o modelo precisará ser selecionado manualmente.
Gemini 3.7 Flash Google Ativado por padrão para usuários licenciados quando a seleção de modelo padrão está ativa. Se uma lista de modelos personalizados estiver configurada, o modelo precisará ser selecionado manualmente.
Gemini 3.6 Flash Google Ativado por padrão para usuários licenciados quando a seleção de modelo padrão está ativa. Se uma lista de modelos personalizados estiver configurada, o modelo precisará ser selecionado manualmente.
Gemini 3.1 Pro (pré-lançamento) Google Ativado por padrão para usuários licenciados quando a seleção de modelo padrão está ativa. Se uma lista de modelos personalizados estiver configurada, o modelo precisará ser selecionado manualmente.
Anthropic Claude Opus 5.5 Anthropic Essa opção fica desativada por padrão. Exige a ativação do administrador (consulte Ativar ou desativar modelos de terceiros).
Anthropic Claude Sonnet 5.5 Anthropic Desativado por padrão. Requer a ativação do administrador (consulte Ativar ou desativar modelos de terceiros).

Para informações sobre cotas e créditos de edição agrupados, consulte Cotas e excedentes e Configurar excedentes. Para preços de modelos de terceiros, consulte as SKUs do Cloud Billing para Anthropic Claude Opus 5.5 e Anthropic Claude Sonnet 5.5.

Nível de raciocínio para modelos de terceiros

Os desenvolvedores podem usar o Anthropic Claude Opus 5.5 e o Anthropic Claude Sonnet 5.5 em um nível de raciocínio baixo, médio, alto ou máximo. Cada nível aparece como uma entrada separada no seletor de modelos, por exemplo, Anthropic Claude Opus 5.5 (High). A frequência média é o padrão. Quando você ativa um modelo de terceiros, todos os níveis de raciocínio dele ficam disponíveis para os desenvolvedores. Não é possível restringir níveis de raciocínio individuais.

Ativar ou desativar modelos de terceiros

Os modelos de terceiros são faturados como uso de pagamento por uso e exigem excedentes. Antes de ativar um modelo de terceiros, ative os excedentes. Se as excedentes forem desativadas mais tarde, os desenvolvedores não poderão usar modelos de terceiros até que as excedentes sejam reativadas. Para controlar os custos, você pode definir um limite mensal de gastos para seu projeto. O limite se aplica a todos os modelos, incluindo os de terceiros.

Para ativar ou gerenciar modelos de terceiros (como o Anthropic Claude Opus 5.5 e o Anthropic Claude Sonnet 5.5) no console do Google Cloud :

  1. No console do Google Cloud , acesse Gemini Enterprise.

    Acessar o Gemini Enterprise

  2. Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.

  3. Na configuração Modelos Antigravity autorizados, ative o botão para o modelo de terceiros que você quer ativar.

  4. Na caixa de diálogo "Termos de Serviço" incorporada que aparece, leia e aceite os termos de terceiros.

Se você desativar um modelo de terceiros, os desenvolvedores vão perder o acesso a ele logo em seguida.

Se o provedor do modelo restringir o acesso a um modelo de terceiros para sua organização, os desenvolvedores não poderão usar esse modelo. Para resolver o problema, entre em contato com o Suporte do Google Cloud.

Para instruções de desenvolvedores sobre como fazer login no Antigravity e selecionar modelos, consulte a documentação empresarial do Antigravity.

Considerações de segurança para modelos de terceiros

Os modelos de IA, incluindo os de terceiros, podem seguir instruções ocultas no conteúdo que processam, como arquivos, páginas da Web ou saídas de ferramentas. Isso é conhecido como injeção de comando. O Antigravity oferece as seguintes proteções quando os desenvolvedores usam modelos de terceiros:

  • Ativação pelo administrador:os modelos de terceiros ficam desativados por padrão. Os desenvolvedores podem usar um modelo de terceiros somente depois que um administrador o ativar.
  • Proteções de segurança do provedor:os modelos de terceiros incluem as proteções de segurança integradas do provedor. Para mais informações, consulte Segurança do Claude.
  • Suas políticas de segurança:as políticas de segurança e as configurações de acesso externo à Web que você configura são aplicadas aos agentes, independente do modelo selecionado por um desenvolvedor.

Práticas recomendadas

  • Ative apenas os modelos de terceiros de que seus desenvolvedores precisam.
  • Defina o Modo de execução automática do terminal como Exigir revisão ou Continuar no sandbox para que os desenvolvedores aprovem os comandos antes de serem executados.
  • Mantenha a opção Fora da política de acesso ao arquivo definida como Negar.
  • Ative o Acesso ao navegador e limite os agentes a uma lista de URLs permitidos.
  • Ative o modo sandbox para projetos que funcionam com código, dependências ou conteúdo da Web não confiáveis.
  • Incentive os desenvolvedores a revisar os comandos e as mudanças de código propostas pelos agentes antes de aprová-los.
  • Defina um limite mensal de gastos para seu projeto.

A seguir