Use a página de configurações das ferramentas para desenvolvedores de IA no Gemini Enterprise para configurar essas ferramentas, aplicar controles de segurança e compliance, ativar ou desativar os recursos do Google Antigravity e gerenciar a disponibilidade de modelos para sua organização.
Antes de começar
Verifique se você tem os seguintes itens:
Conta do Cloud Billing: para usar as ferramentas para desenvolvedores de IA, seu projeto precisa ter o Cloud Billing ativado. Com uma conta de faturamento de autoatendimento (on-line), você paga pelo uso da edição de pagamento por uso e pelo uso acima da cota com créditos pré-pagos. Para mais informações, consulte os Tipos de conta do Cloud Billing.
Edições compatíveis: para acessar as ferramentas para desenvolvedores de IA, os usuários precisam ter uma assinatura da edição Gemini Enterprise Standard, Plus, Standard Emerging Market ou pagamento por uso.
Regiões com disponibilidade: para mais informações sobre disponibilidade regional e limitações de recursos, consulte Residência de dados para as edições Standard e Plus do Gemini Enterprise e o Gemini Notebook.
Papéis necessários: é preciso ter o papel de administrador do Gemini Enterprise (
roles/discoveryengine.agentspaceAdmin) para configurar as ferramentas para desenvolvedores de IA.APIs necessárias: o 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. API Business AI Code (
businessaicode.googleapis.com): oferece geração de código com tecnologia de IA para o Antigravity no Gemini Enterprise. É preciso ativar essa API no projeto para permitir que principais autorizados acessem o serviço pelo projeto.
Quando você ativa as ferramentas para desenvolvedores de IA no console do Google Cloud , o sistema verifica a configuração do projeto e ativa automaticamente essas APIs necessárias, caso ainda não estejam ativadas.
- API Discovery Engine (
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 estiver disponível nesse local ou região.
Assinaturas atuais: um administrador precisa ativar manualmente as ferramentas para desenvolvedores de IA no console do Google Cloud para cada local para ativar as ferramentas para usuários licenciados.
Para ativar manualmente as ferramentas para desenvolvedores de IA em uma assinatura do Gemini Enterprise, siga estas etapas:
No console do Google Cloud , acesse Gemini Enterprise.
Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.
Ative a opção Ferramentas de IA para desenvolvedores.
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 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 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 das
pastas de trabalho designadas. As seguintes opções estão disponíveis:
|
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:
|
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 de navegador Antigravity. Você pode
executar o agente do navegador no Antigravity digitando o comando |
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 dar suporte a
tarefas avançadas de programação e teste baseadas na Web.
As seguintes opções estão disponíveis:
|
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 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)
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 da 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:
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 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, 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 do recurso
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:
No console do Google Cloud , acesse Gemini Enterprise.
Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.
Na seção Recursos, clique em Editar.
Ative ou desative cada recurso.
Configuração Descrição Status padrão Comando /boostAtive essa configuração para permitir que os usuários executem uma hierarquia multiagente 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-previewAtive essa configuração para permitir que os usuários implantem uma estrutura coordenada de subagentes autônomos para executar projetos de grande escala e de longo alcance (pré-lançamento). Para mais informações, consulte Equipes de agentes do Teamwork. Ativado Clique em Salvar.
Configurar a disponibilidade do modelo
Use as configurações desta 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é-lançamento e o modelo Gemini 3 Pro Image estão disponíveis apenas na região
global. Portanto, eles não são compatíveis com os compromissos de residência de dados (DRZ, na sigla em inglês) ou de processamento regional de machine learning (ML) nas multirregiões dos EUA ou da UE.Inferência de modelos de terceiros e processamento de dados: 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,useeu. Não há suporte para regiões no país. 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.Declarações de execução híbrida e 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 cobrados como 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 uso de pagamento por uso 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 de IA para desenvolvedores.
A configuração Modelos autorizados pelo 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 do Googlerecém-lançados 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:
No console do Google Cloud , acesse Gemini Enterprise.
Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.
Na seção Disponibilidade do modelo, clique em Editar.
No campo Modelos autorizados do Antigravity, selecione os modelos que você quer permitir. Para permitir todos os modelos compatíveis, deixe o campo vazio.
Clique em Salvar.
| Configuração | Descrição | Status padrão |
|---|---|---|
| Modelos Antigravity autorizados | Especifique quais modelos de IA a ferramenta Antigravity tem autorização para 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 recém-lançados 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 os recursos, as limitações e as avaliações de segurança de cada modelo, consulte os cards de modelo do Anthropic Claude Opus 5.5 e do 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 | 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 | 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 | 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 | 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) | 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 | Desativado por padrão. Requer ativação pelo 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 em pool, consulte Cotas e uso do pagamento por uso e Configurar o uso do pagamento por uso acima da cota. 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 pensamento 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 pensamento 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 cobrados como pagamento por uso. Se você usa uma edição baseada em licença, ative o pagamento por uso acima da cota antes de ativar um modelo de terceiros. Se você desativar o pagamento por uso acima da cota mais tarde, os desenvolvedores não poderão usar modelos de terceiros até que você o ative novamente. Para controlar os custos, defina 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 :
No console do Google Cloud , acesse Gemini Enterprise.
Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.
Na configuração Modelos Antigravity autorizados, ative o botão para o modelo de terceiros que você quer ativar.
Na caixa de diálogo dos Termos de Serviço incorporados, 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 para 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 configurações de políticas de segurança e acesso externo à Web que você define se aplicam aos agentes, independentemente do modelo selecionado pelo desenvolvedor.
Práticas recomendadas
- Ative apenas os modelos de terceiros 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 que os agentes propõem antes de aprová-los.
- Defina um limite mensal de gastos para seu projeto.
Corrigir um agente de serviço ausente
As ferramentas para desenvolvedores de IA usam um agente de serviço gerenciado pelo Googleno seu projeto para processar solicitações, como uso de pagamento por uso acima da cota e controles de administrador. O agente de serviço é criado automaticamente quando você ativa o botão de alternância Ferramentas para desenvolvedores de IA ou compra uma assinatura do Gemini Enterprise.
Se o agente de serviço não existir no projeto, as solicitações das ferramentas para desenvolvedores de IA vão falhar com um erro semelhante ao seguinte:
Service agent SERVICE_AGENT_EMAIL not found.
Para corrigir esse erro, recrie o agente de serviço usando um dos métodos abaixo.
Usar o console do Google Cloud
No console do Google Cloud , acesse Gemini Enterprise.
Clique em Configurações e selecione a guia Ferramentas para desenvolvedores de IA.
Desative a opção Ferramentas de IA para desenvolvedores.
Ative novamente as ferramentas de IA para desenvolvedores.
Ativar o botão cria o agente de serviço no seu projeto. Desativar e ativar o botão novamente não redefine as configurações das ferramentas para desenvolvedores de IA configuradas.
Usar a CLI gcloud
Crie o agente de serviço:
gcloud beta services identity create \ --service=businessaicode.googleapis.com \ --project=PROJECT_IDSubstitua
PROJECT_IDpelo ID do seu projeto.A resposta ao comando inclui o endereço de e-mail do agente de serviço.
Conceda o papel de Agente de serviço de código da IA comercial (
roles/businessaicode.serviceAgent) ao agente de serviço. O comandogcloud beta services identity createnão concede esse papel automaticamente.gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:SERVICE_AGENT_EMAIL" \ --role="roles/businessaicode.serviceAgent"Substitua:
PROJECT_ID: ID do projeto.SERVICE_AGENT_EMAIL: o endereço de e-mail do agente de serviço da saída da etapa anterior ou da mensagem de erro.
Para obter mais informações, consulte
gcloud beta services identity create.