Configurar as ferramentas de IA para desenvolvedores

Use a página de configurações das ferramentas de IA para desenvolvedores no Gemini Enterprise para configurar ferramentas de desenvolvedores, aplicar controles de segurança e conformidade 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 IA para desenvolvedores, 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 Tipos de contas do Cloud Billing.

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

  • Regiões compatíveis: 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.

  • Funções necessárias: é necessário ter o papel de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) para configurar as ferramentas de IA para desenvolvedores.

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

    • API Gemini Enterprise (discoveryengine.googleapis.com): oferece serviços de plataforma principal, controles de segurança e conformidade e gerenciamento de configurações para o Gemini Enterprise.

    • API Business AI Code (businessaicode.googleapis.com): oferece geração de código com tecnologia de IA para o Antigravity no Gemini Enterprise. É necessário ativar essa API no projeto para permitir que os principais autorizados alcancem o serviço do seu projeto.

    Quando você ativa a opção Ferramentas de IA para desenvolvedores no Google Cloud console, o sistema verifica a configuração do projeto e ativa automaticamente essas APIs necessárias, se você ainda não as tiver ativado.

Ativar as ferramentas de IA para desenvolvedores

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

  • Novas assinaturas Standard, Plus ou pagamento por uso: as ferramentas de IA para desenvolvedores 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 de IA para desenvolvedores no Google Cloud console para cada local, para ativar as ferramentas para usuários licenciados.

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

  1. No Google Cloud console, acesse Gemini Enterprise.

    Gemini Enterprise

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

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

  4. Configure as definições nas seções Segurança, Conformidade e Disponibilidade do modelo.

Definir configurações de segurança

Como administrador, você pode evitar a exposição não autorizada de dados em interfaces de desenvolvedores. Use as configurações nesta 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 regras de segurança e exijam 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 desenvolvedores.

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 de suas 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 suas 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: solicita aprovação do usuário antes de executar qualquer comando de 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 sandbox. Desativado

Gerenciar o acesso externo à Web

Se a política de segurança exigir o controle do acesso do agente a sites externos para evitar a exfiltração de dados, essas configurações permitirão limitar o acesso do navegador ou restringi-lo 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. É possível executar o agente do navegador no Antigravity digitando o /browser comando na caixa 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 para oferecer 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: solicita 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), que permite que os agentes de IA acessem com segurança outras 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) para estender com segurança o contexto de dados da IA. Desativado
Configuração de servidor permitida Essa configuração permite que os administradores definam configurações específicas do servidor para 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 fornece 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 substitui 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. Necessá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 configurações de conformidade

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 de interações de IA para conformidade. As configurações desta seção permitem configurar 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 interações entre 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 registros com segurança no projeto da sua organização e 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 para ajudar você a acompanhar o uso e a análise de dados em toda a organização. O sistema armazena registros com segurança no projeto da sua organização e Google nunca acessa os registros para treinamento de modelo ou revisão humana. Desativado

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 conceder aos desenvolvedores acesso a modelos de visualização para experimentos ou restringir ferramentas para usar apenas modelos autorizados.

Considerações importantes antes de configurar modelos

Antes de configurar 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 falhas nas solicitações de pagamento por uso que excedam sua cota padrão, verifique se os modelos permitidos correspondem nas duas plataformas.

  • Residência de dados:os modelos de visualização 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 aprendizado de máquina (ML) nas multirregiões dos EUA ou da UE. Para mais informações, consulte Residência de dados para as edições Gemini Enterprise Standard e Plus e o Gemini Notebook.

  • Declarações de faturamento:o Antigravity usa o Gemini Flash Lite para tarefas em segundo plano e o Gemini 3 Pro Image para geração de imagens. O uso desses modelos pode gerar cobranças de faturamento. Para mais informações, consulte Visualizar custos.

Configurar modelos autorizados

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

Configuração Descrição Status padrão
Modelos Antigravity autorizados Ative essa configuração para especificar quais modelos de IA a ferramenta Antigravity está autorizada a usar no projeto. Somente modelos Made by Google estão disponíveis nas ferramentas de IA para desenvolvedores do Gemini Enterprise. Para mais informações sobre os modelos compatíveis, consulte a Enterprise coluna na lista de modelos compatíveis.