Aplicar o modo somente de modelo


É possível aplicar o modo somente modelo ao seu projeto do Firebase para que todas as solicitações de Gemini API via Firebase AI Logic usem modelos de comando do servidor.

Quando uma solicitação é bloqueada, a resposta é um erro 403: unauthorized.

Considerações importantes

Esteja ciente das seguintes considerações importantes sobre o modo somente modelo.

Quando o modo somente de modelo é aplicado

Quando o modo somente de modelo é aplicado, esteja ciente do seguinte:

  • Essa é uma configuração para todo o projeto do Firebase AI Logic.

    • Ela se aplica a todos os apps registrados no projeto.
    • Ela se aplica apenas ao projeto em que é aplicada.
  • Essa configuração se aplica a todas as solicitações via Firebase AI Logic para Gemini Developer API e Agent Platform Gemini API (formerly Vertex AI).

  • Essa configuração bloqueia todas as solicitações via Firebase AI Logic que não usam modelos de comando do servidor. Isso inclui o bloqueio de solicitações do seu app que usam recursos ainda não compatíveis com modelos de comando do servidor.

  • Essa configuração não bloqueia as solicitações do Gemini API no seu projeto que não são feitas pelo Firebase AI Logic.

  • Se você estiver usando a API REST Firebase AI Logic:

    • Essa configuração não bloqueia solicitações de inferência que usam modelos de comando do servidor (como templateGenerateContent ou templateStreamGenerateContent).
    • Essa configuração não bloqueia as solicitações do plano de controle (como as de gerenciamento de modelos e configurações).
  • Essa configuração não bloqueia as solicitações para countTokens (a API Count Tokens).

Antes de aplicar o modo somente de modelo

Antes de aplicar o modo somente de modelo, observe o seguinte:

  • Se você tiver versões do app que não usam modelos de comando do servidor:

    • Essa configuração vai bloquear as solicitações via Firebase AI Logic dessas versões de app.
    • Verifique se todos os clientes ativos foram atualizados para usar modelos de comando do servidor antes de aplicar o modo somente modelo.
  • Se o app usa recursos ainda não compatíveis com modelos de comando do servidor:

    • Essa configuração vai bloquear as solicitações via Firebase AI Logic para esses recursos ainda não compatíveis, porque eles não usam (e não podem usar) modelos de comando do servidor.
    • Verifique se o app (incluindo qualquer versão anterior) não usa ativamente nenhum desses recursos ainda não compatíveis antes de aplicar o modo somente modelo.

Gerenciar a configuração do modo somente de modelo

Você gerencia a configuração do modo somente de modelo no console do Firebase.

Permissões e papéis do IAM necessários

Para gerenciar a configuração do modo somente modelo, é necessária a permissão firebasevertexai.configs.update, que está incluída por padrão nestes papéis do IAM: Proprietário, Editor, Administrador do Firebase e Administrador do Firebase AI Logic.

Aplicar o modo somente de modelo

Veja como aplicar o modo somente de modelo ao seu projeto do Firebase:

  1. Se ainda não tiver feito isso, consulte as considerações importantes sobre o modo somente modelo no início deste guia.

  2. No console do Firebase, acesse Serviços de IA > Lógica de IA > guia Configurações.

  3. Em Modo de modelo, deslize o botão de alternância para Aplicar o modo somente de modelo para Aplicado.

  4. Leia a caixa de diálogo de confirmação e clique em Confirmar.

Interromper a aplicação do modo somente de modelo

Se você interromper a aplicação do modo somente de modelo, observe o seguinte:

  • As solicitações via Firebase AI Logic que não usam modelos de comando do servidor serão permitidas.
  • Essa é uma configuração para todo o projeto do Firebase AI Logic.

Veja como interromper a aplicação do modo somente modelo no seu projeto do Firebase:

  1. No console do Firebase, acesse Serviços de IA > Lógica de IA > guia Configurações.

  2. Em Modo de modelo, desative a opção Aplicar o modo somente de modelo.

  3. Leia a caixa de diálogo de confirmação e clique em Confirmar.