Aplicar o modo somente de modelo


É possível ativar o modo somente modelo para seu projeto do Firebase. Assim, todas as solicitações Gemini API via Firebase AI Logic precisam usar modelos de comandos do servidor.

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

Considerações importantes

Confira as seguintes considerações importantes sobre o modo somente modelo.

Quando o modo somente de modelo é aplicado

Quando o modo somente de modelo é aplicado, lembre-se 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 só se aplica ao projeto em que é aplicada.

  • Essa configuração se aplica a todas as solicitações via Firebase AI Logic para Gemini Developer API e Vertex AI Gemini API.

  • Essa configuração bloqueia todas as solicitações via Firebase AI Logic que não usam modelos de comandos 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 solicitações Gemini API no seu projeto que não são feitas via 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 solicitação do servidor (como templateGenerateContent ou templateStreamGenerateContent).
    • Essa configuração não bloqueia solicitações do plano de controle (como as de gerenciamento de modelos e configurações).

  • Essa configuração não bloqueia solicitações para countTokens (a API Count Tokens).

Antes de aplicar o modo somente de modelo

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

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

    • Essa configuração vai bloquear solicitações via Firebase AI Logic dessas versões de apps.
    • Verifique se todos os clientes ativos foram atualizados para usar modelos de solicitação do servidor antes de aplicar o modo somente modelo.

  • Se o app usar recursos ainda não compatíveis com modelos de solicitação do servidor:

    • Essa configuração bloqueia 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 comandos do servidor.
    • Verifique se o app (incluindo qualquer versão anterior) não usa ativamente nenhuma dessas funcionalidades 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 obrigatórios

Para gerenciar a configuração do modo somente modelo, é necessário ter 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

Saiba como aplicar o modo somente de modelo no seu projeto do Firebase:

  1. Se ainda não fez isso, revise as considerações importantes para o modo somente modelo no início deste guia.

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

  3. Em Modo de modelo, deslize a chave de 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 comandos do servidor serão permitidas.
  • Essa é uma configuração para todo o projeto do Firebase AI Logic.

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

  1. No console do Firebase, acesse a guia Serviços de IA > Lógica de IA > 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.