Nesta página, você encontra respostas para perguntas comuns sobre como gerenciar e usar as licenças do Gemini Enterprise.
Gerenciar assinaturas
Esta seção aborda perguntas comuns relacionadas ao gerenciamento das suas assinaturas do Gemini Enterprise.
Por que não consigo ver e modificar assinaturas, incluindo a recuperação e a distribuição de licenças?
Você precisa ter o papel de Admin da conta de faturamento para gerenciar assinaturas. Também é possível usar uma função personalizada com permissões específicas. Verifique se você tem esse papel ou as permissões necessárias. Se você não tiver nenhum deles, entre em contato com o administrador da conta de faturamento.
Para mais informações, consulte:
- Encontrar um administrador da conta de faturamento
- Antes de começar em Adquirir assinaturas e atribuir licenças do Gemini Enterprise.
Posso atualizar o nome da assinatura?
Não, não é possível atualizar o nome da assinatura depois que ela é criada.
Se o nome da assinatura for mostrado como n/a, ele é um marcador de posição para uma
assinatura comprada por um canal de vendas ou um formulário de pedido off-line, e isso
não significa que a assinatura é inválida.
Posso reduzir o número de licenças?
Não, não é possível reduzir a contagem de licenças durante um período de assinatura ativo. Só é possível reduzir o número de licenças quando o período da assinatura termina ou está em renovação.
Por que não consigo modificar ou gerenciar a assinatura pelo console do Google Cloud ?
Se você comprou sua assinatura por um formulário de pedido off-line, não é possível modificá-la ou gerenciá-la diretamente no console do Google Cloud . Os formulários de pedido off-line são processados fora da interface de autoatendimento do console. Para fazer mudanças ou atualizações na sua assinatura, como ajustar as contagens de licenças ou renovar, entre em contato com o gerente de contas do Google.
Por que a opção "Editar" está desativada na página "Gerenciar usuários"?
Na seção Licenças do Gemini Enterprise da página Gerenciar usuários, o botão Editar está desativado.
Não é possível modificar as configurações de assinatura diretamente nesta página. Para atualizar configurações como contagens de licenças, consulte Atualizar configurações de assinatura.
O que significa o erro Subscription already exists ao tentar comprar uma nova assinatura?
Esse erro significa que sua conta do Cloud Billing já tem uma assinatura ativa para a mesma edição do Gemini Enterprise, seja o período de assinatura mensal ou anual. Uma única conta do Cloud Billing pode ter apenas uma assinatura ativa por edição por vez.
Para usar sua assinatura atual em um ou mais projetos diferentes:
- Atualize a assinatura para aumentar o número de licenças.
- Distribua as licenças para o novo projeto.
Posso mudar o período da minha assinatura de mensal para anual ou vice-versa?
Não, não é possível mudar diretamente o período de faturamento de uma assinatura ativa do Gemini Enterprise no console do Google Cloud . Também não é possível comprar uma segunda assinatura da mesma edição na mesma conta do Cloud Billing enquanto a assinatura atual estiver ativa.
Para alternar entre um período de faturamento mensal e anual, escolha uma das seguintes opções:
- Mudar no final do período atual. Cancele sua assinatura atual desmarcando a opção Renovação automática. Sua assinatura vai continuar ativa até o fim do período de faturamento atual. Depois que o prazo expirar, compre uma nova assinatura com o período de faturamento de sua preferência e distribua as licenças para seus projetos.
- Mudar antes do fim do período atual: entre em contato com o suporte do Cloud Billing ou com seu representante de vendas ou gerente de contas do Google Cloud para solicitar o cancelamento antecipado da sua assinatura ativa. Depois que o cancelamento for concluído, compre uma nova assinatura com o período de faturamento que preferir.
As licenças de teste sem custo financeiro incluem a cota de ferramentas para desenvolvedores de IA?
Isso depende do tipo de conta do Cloud Billing ao qual seu projeto está vinculado:
- Conta de faturamento de autoatendimento (on-line): não. As assinaturas de teste não incluem acesso às ferramentas para desenvolvedores de IA. Para usar as ferramentas de IA para desenvolvedores, é preciso ter uma assinatura ativa que não seja de teste.
- Conta com fatura: sim. As assinaturas de teste sem custo financeiro incluem acesso a ferramentas de IA para desenvolvedores com uma cota limitada.
As assinaturas de teste sem custo financeiro não estão qualificadas para o pagamento por uso acima da cota, independentemente do tipo de conta de faturamento.
Para outros recursos do Gemini Enterprise, as licenças de teste sem custo financeiro usam a mesma alocação de cota em pool para envolvidos no projeto que as licenças pagas. Para detalhes sobre os cálculos do pool semanal, consulte Cotas para as edições Standard e Plus.
Distribuir e atribuir licenças
Esta seção aborda perguntas comuns relacionadas à distribuição e atribuição de licenças do Gemini Enterprise a projetos e usuários.
Posso usar uma assinatura do Gemini Enterprise em vários projetos?
Sim, a assinatura do Gemini Enterprise é gerenciada no nível da conta de faturamento, e você pode distribuir as licenças para vários projetos conforme necessário, o que permite flexibilidade no gerenciamento do acesso em diferentes ambientes de desenvolvimento ou produção. Com uma assinatura baseada em licença, como o Gemini Enterprise Standard ou Plus, é possível distribuir licenças para projetos vinculados a qualquer conta do Cloud Billing. Com uma assinatura de pagamento por uso, só é possível distribuir licenças para projetos vinculados à conta do Cloud Billing que possui a assinatura.
Posso distribuir licenças para um projeto em uma organização ou conta de faturamento diferente?
Sim. As regras de distribuição de licenças dependem da edição da sua assinatura:
- Assinaturas baseadas em licenças (como o Gemini Enterprise Standard e Plus): é possível distribuir licenças para projetos em diferentes organizações do Google Cloud e projetos vinculados a contas distintas do Cloud Billing.
- Assinaturas de pagamento por uso: é possível distribuir licenças para projetos em diferentes organizações, mas o projeto de destino precisa estar vinculado à mesma conta do Cloud Billing que possui a assinatura de pagamento por uso.
Como faço para mover ou compartilhar licenças para um projeto ou local diferente?
Para mover, compartilhar ou corrigir uma alocação de licença para um projeto ou local diferente na mesma conta do Cloud Billing, siga estas etapas:
- Remova a atribuição das licenças no projeto de origem: se as licenças estiverem
atribuídas a usuários no projeto e no local de origem, remova os
usuários dessas licenças
na página Gerenciar usuários. Só é possível recuperar licenças não atribuídas.
Se você tentar recuperar licenças atribuídas, vai receber um erro
Not enough licenses remaining. - Recupere as licenças não atribuídas para a conta de faturamento: recupere as licenças não atribuídas do projeto e do local de origem para que elas retornem ao pool de assinaturas não alocadas da sua conta do Cloud Billing. Só é possível realizar essa ação uma vez por dia.
- Distribua as licenças para o projeto ou local de destino: distribua as licenças disponíveis do pool de assinaturas para o projeto ou local de destino usando o console doGoogle Cloud ou a API REST.
- Atribua as licenças aos usuários: atribua as licenças distribuídas aos usuários no projeto e no local de destino.
Como faço para verificar a lista de projetos em que as licenças estão alocadas?
Para ver quais projetos têm licenças alocadas da sua assinatura do Gemini Enterprise, use a API REST. O método de detalhes da assinatura fornece as informações necessárias, incluindo como você distribui licenças entre projetos vinculados à sua conta de faturamento.
Posso usar uma licença atribuída a mim em projetos diferentes?
Não, a licença de um usuário para o Gemini Enterprise só é válida no projeto específico em que você a distribuiu. Embora você gerencie as assinaturas no nível da conta de faturamento, as licenças são alocadas por projeto. Portanto, se você precisar usar os recursos do Gemini Enterprise em vários projetos, distribua explicitamente as licenças para cada um deles.
Posso transferir uma assinatura para outra conta do Cloud Billing? O que acontece se eu mudar a conta de faturamento de um projeto?
Não. As assinaturas do Gemini Enterprise estão vinculadas à conta do Cloud Billing em que foram compradas e não podem ser transferidas para outra conta do Cloud Billing.
Se você precisar mover um projeto para uma nova conta do Cloud Billing:
- Assinatura atual na conta de faturamento antiga: a assinatura original permanece na conta do Cloud Billing antiga e continua sendo faturada nela até expirar ou ser cancelada. Se você quiser reutilizar os slots desse projeto em outros projetos que permanecem vinculados à conta antiga do Cloud Billing, remova os usuários das licenças e recupere as licenças não atribuídas de volta para a conta antiga do Cloud Billing antes de mudar a conta de faturamento do projeto.
- Licenciamento do projeto na nova conta de faturamento:
- Assinaturas baseadas em licenças (como o Gemini Enterprise Standard e Plus): como as licenças baseadas em licenças são compatíveis com a distribuição entre contas de faturamento, as licenças distribuídas anteriormente pela conta antiga do Cloud Billing continuam funcionando depois que o projeto é movido para a nova conta de faturamento, mas as cobranças de assinatura permanecem faturadas na conta antiga. Se você quiser que o faturamento da assinatura ocorra na nova conta do Cloud Billing, compre uma assinatura na nova conta do Cloud Billing, distribua licenças para o projeto e transfira ou atribua usuários à nova assinatura.
- Assinaturas de pagamento por uso: só é possível distribuir licenças para projetos vinculados à conta do Cloud Billing que é proprietária da assinatura. Se um projeto que usa o pagamento por uso for movido para uma nova conta do Cloud Billing, você precisará assinar a edição de pagamento por uso na nova conta do Cloud Billing e distribuir licenças dessa conta.
Resolver problemas
Esta seção aborda problemas comuns e as soluções relacionadas às licenças do Gemini Enterprise.
Por que não consigo distribuir licenças?
Verifique os seguintes detalhes:
- Verifique se você ativou a API Discovery Engine no projeto em que está distribuindo as licenças.
-
Verifique se você tem o papel de Admin da conta de faturamento
(
roles/billing.admin) ou uma função personalizada com as permissões necessárias. Para mais informações, consulte Antes de começar em Comprar assinaturas e atribuir licenças do Gemini Enterprise. - O console do Google Cloud não é compatível com a distribuição de licenças para vários projetos. Portanto, use o método da API REST para essa tarefa.
- Verifique o Status do pedido da assinatura na página Detalhes da assinatura. Se a assinatura estiver Expirada, o botão Distribuir licenças não será exibido. Para mais informações, consulte Por que o botão "Distribuir licenças" não aparece ou a opção "Adicionar usuários" está desativada na minha assinatura?
Por que o botão "Distribuir licenças" não aparece ou a opção "Adicionar usuários" está desativada na minha assinatura?
O console do Google Cloud mostra ações de licença apenas para assinaturas cujas licenças ainda podem ser usadas:
Na página Detalhes da assinatura, os botões Distribuir licenças e Atribuir licenças são exibidos apenas quando o Status do pedido é Não iniciado, Ativo, Desativando ou Período de carência. Quando o Status do pedido é Expirado, esses botões não são exibidos, e não é possível distribuir ou atribuir licenças dessa assinatura.
Na página Gerenciar usuários, o botão Adicionar usuários é desativado, com a dica
Please add an active license configuration first to add users, quando o projeto e o local selecionados não têm licenças no estado Ativo, Desativando ou Período de carência. O painel Adicionar usuários lista apenas as assinaturas com licenças nesses estados.
Para verificar o estado da sua assinatura, consulte Sobre os estados da assinatura. Para restaurar o acesso dos usuários de uma assinatura expirada, compre uma nova assinatura, distribua as licenças para o projeto e transfira os usuários para a nova assinatura.
O que significa o erro Not enough licenses remaining?
Esse erro significa que você está tentando recuperar mais licenças do que o disponível e não atribuído. Só é possível recuperar licenças que não estão atribuídas a usuários. Para resolver esse problema, reduza o número de licenças que você está tentando recuperar ou remova as licenças dos usuários.
O que significa o erro The quantity exceeds the maximum limit of seats for this account?
Ao comprar ou modificar licenças diretamente no console do Google Cloud , esse erro ocorre se você tentar comprar mais licenças do que o limite da sua conta do Cloud Billing.
Se você tentar aumentar o número de licenças além desse limite no console doGoogle Cloud ou se tentar adicionar licenças a uma conta que foi provisionada anteriormente acima desse limite usando um formulário de pedido off-line, a operação vai falhar com um erro de limite máximo de licenças.
Para solicitar contagens de licenças acima dos limites on-line, entre em contato com o representante de vendas ou o gerente de contas do Google Cloud para atualizar seu pedido ou aplicar uma exceção de lista de permissões à sua conta de faturamento.
O que significa o erro 404 Error: License config not found?
Esse erro significa que há um problema com o parâmetro de solicitação. Antes de recuperar ou distribuir licenças, verifique as informações da assinatura na página de detalhes da assinatura, a região (local atual) e o ID de configuração da licença (ID da assinatura) na página "Gerenciar usuários".
Por que os usuários não conseguem acessar os recursos do Gemini Enterprise mesmo tendo licenças?
Motivos comuns para os usuários não conseguirem acessar os recursos:
- Tipo de assinatura: verifique se a licença do usuário é de um tipo de assinatura que inclui os recursos específicos que ele está tentando acessar.
-
Papéis do IAM: confirme se o usuário tem o
papel de usuário corporativo do Gemini Enterprise (
roles/discoveryengine.agentspaceUser) no projeto do Gemini Enterprise. Para mais informações, consulte Papéis e permissões do IAM. - Federação de identidade de colaboradores: se você estiver usando a federação de identidade de colaboradores, verifique se ela está configurada corretamente, já que configurações incorretas podem levar a problemas de acesso.
O que significa o erro FAILED_PRECONDITION: Failed to allocate quota for agent creation?
Ao chamar AgentService.CreateAgent (ou criar um agente personalizado no
console doGoogle Cloud ), talvez você encontre o seguinte erro:
400 FAILED_PRECONDITION: Failed to allocate quota for agent creation.
Esse erro significa que o usuário ou a conta de serviço que está fazendo a chamada não tem permissão para criar agentes personalizados no projeto e no local de destino. Verifique as seguintes causas:
- Nenhuma licença ativa atribuída ao usuário ou à conta de serviço que está fazendo a chamada: para criar um agente personalizado, o principal que está fazendo a chamada precisa ter uma licença ativa qualificada no projeto e no local em que o agente é criado. Se você estiver criando agentes usando uma conta de serviço (como em um pipeline de CI/CD ou com o Terraform), atribua uma licença ativa ao endereço de e-mail da conta de serviço nesse projeto e local.
- Licença da edição Frontline: os usuários com uma licença do Gemini Enterprise Frontline podem interagir com agentes predefinidos publicados por administradores, mas não podem criar agentes personalizados. Faça upgrade do usuário para uma licença do Gemini Enterprise Standard ou Plus para permitir a criação de agentes personalizados.
- Atraso na propagação do cache de licenças: se você distribuiu ou atribuiu recentemente uma licença ao usuário ou à conta de serviço, aguarde de 5 a 15 minutos para que os caches de direito de back-end sejam sincronizados antes de chamar a API de criação de agentes.
Por que os usuários recebem um erro No license available for this project and location no Antigravity?
Se os desenvolvedores receberem um erro No license available for this project and
location ao fazer login no Google Antigravity, as causas comuns
incluem:
- A conta de faturamento não está configurada para ferramentas de IA para desenvolvedores: confirme se o projeto está vinculado a uma conta do Cloud Billing qualificada que ofereça suporte a ferramentas de IA para desenvolvedores (uma conta de faturamento on-line de autoatendimento atualizada, uma conta de cobrança por fatura ou uma subconta de faturamento de uma conta de cobrança por fatura). Se a conta de faturamento ainda estiver no teste sem custo financeiro do Google Cloud , faça upgrade para uma conta de faturamento paga para usar as ferramentas para desenvolvedores de IA. As subcontas gerenciadas por revendedores não são compatíveis com créditos pré-pagos.
- Nenhuma assinatura ativa que não seja de teste no local selecionado: verifique se
o projeto tem uma assinatura ativa do Gemini Enterprise que não seja de teste no
local multirregional (
global,usoueu) selecionado pelo desenvolvedor. As assinaturas de teste sem custo financeiro incluem ferramentas para desenvolvedores de IA somente se o projeto estiver vinculado a uma conta de cobrança por fatura. - Todos os assentos já estão atribuídos: verifique se a assinatura no local selecionado tem assentos não atribuídos restantes. Atribua uma licença na página Gerenciar usuários ou adicione licenças à sua assinatura.
- Projeto errado selecionado: confirme se o desenvolvedor selecionou o projeto doGoogle Cloud em que as licenças do Gemini Enterprise são distribuídas.
- A opção "Ferramentas para desenvolvedores de IA" não está ativada: para assinaturas atuais, um administrador precisa ativar manualmente a opção Ferramentas para desenvolvedores de IA para esse local nas configurações das ferramentas para desenvolvedores de IA.
- Papel do IAM ausente: confirme se o desenvolvedor tem o
papel de usuário corporativo do Gemini Enterprise
(
roles/discoveryengine.agentspaceUser) no projeto.
Para resolver esses problemas, consulte Resolver problemas de ativação das ferramentas para desenvolvedores de IA.