Aplicar o modo somente de modelo


Você pode aplicar o modo somente de modelo no seu projeto do Firebase para que todas as Gemini API solicitações via Firebase AI Logic usem modelos de comandos do servidor.

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

Considerações importantes

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

Quando o modo somente de modelo é aplicado

Quando o modo somente de modelo é aplicado, observe o seguinte:

  • Essa 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 a Gemini Developer API e a 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 comandos do servidor.

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

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

    • Essa configuração não bloqueia solicitações de inferência que usam modelos de comandos do servidor (como templateGenerateContent ou templateStreamGenerateContent).
    • Essa configuração não bloqueia solicitações do plano de controle (como aquelas para gerenciar 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

Observe o seguinte antes de aplicar o modo somente de modelo:

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

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

  • Se o app usa recursos ainda não compatíveis com modelos de comandos 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 nenhum desses recursos ainda não compatíveis antes de aplicar o modo somente de modelo.

Gerenciar a configuração do modo somente de modelo

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

Permissões e papéis do IAM obrigatórios

Para gerenciar a configuração do modo somente de 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 sobre o modo somente de modelo na seção anterior 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 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 para Firebase AI Logic.

Saiba como interromper a aplicação do modo somente de 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.