Applica la modalità solo template


Puoi applicare la modalità solo template per il tuo progetto Firebase in modo che tutte le richieste Gemini API tramite Firebase AI Logic debbano utilizzare i template di prompt del server.

Quando una richiesta viene bloccata, la risposta sarà un errore 403: unauthorized.

Considerazioni importanti

Tieni presente le seguenti considerazioni importanti per la modalità Solo modello.

Quando viene applicata la modalità solo template

Quando viene applicata la modalità solo template, tieni presente quanto segue:

  • Questa è un'impostazione a livello di progetto per Firebase AI Logic.

    • Si applica a tutte le app registrate nel progetto.
    • Si applica solo al progetto in cui viene applicato.
  • Questa impostazione si applica a tutte le richieste tramite Firebase AI Logic sia a Gemini Developer API sia a Agent Platform Gemini API (formerly Vertex AI).

  • Questa impostazione blocca tutte le richieste tramite Firebase AI Logic che non utilizzano i template di prompt del server. Ciò include il blocco delle richieste della tua app che utilizzano funzionalità non ancora supportate per i template di prompt del server.

  • Questa impostazione non blocca le richieste Gemini API nel tuo progetto che non vengono effettuate tramite Firebase AI Logic.

  • Se utilizzi l'API REST Firebase AI Logic:

    • Questa impostazione non blocca le richieste di inferenza che utilizzano template di prompt del server (ad esempio utilizzando templateGenerateContent o templateStreamGenerateContent).
    • Questa impostazione non blocca le richieste del control plane (come quelle per la gestione di modelli e configurazioni).
  • Questa impostazione non blocca le richieste a countTokens (l'API Count Tokens).

Prima di applicare la modalità solo template

Tieni presente quanto segue prima di applicare la modalità solo template:

  • Se hai versioni esistenti della tua app che non utilizzano i template di prompt del server:

    • Questa impostazione bloccherà le richieste tramite Firebase AI Logic da queste versioni dell'app esistenti.
    • Assicurati che tutti i client attivi siano aggiornati per utilizzare i template di prompt del server prima di applicare la modalità solo template.
  • Se la tua app utilizza funzionalità non ancora supportate per i template di prompt del server:

    • Questa impostazione bloccherà le richieste tramite Firebase AI Logic per queste funzionalità non ancora supportate perché non utilizzano (e non possono utilizzare) i template di prompt del server.
    • Assicurati che la tua app (incluse eventuali versioni precedenti) non utilizzi attivamente nessuna di queste funzionalità non ancora supportate prima di applicare la modalità solo template.

Gestisci l'impostazione della modalità solo template

Puoi gestire l'impostazione per la modalità solo template nella console Firebase.

Autorizzazioni e ruoli IAM richiesti

La gestione dell'impostazione della modalità solo modello richiede l'autorizzazione firebasevertexai.configs.update, inclusa per impostazione predefinita in questi ruoli IAM: Proprietario, Editor, Amministratore Firebase e Amministratore Firebase AI Logic.

Applica la modalità solo template

Ecco come applicare la modalità solo template per il tuo progetto Firebase:

  1. Se non l'hai già fatto, consulta le considerazioni importanti per la modalità Solo modello riportate in precedenza in questa guida.

  2. Nella console Firebase, vai a Servizi AI > AI Logic > scheda Impostazioni.

  3. In Modalità template, imposta l'opzione Applica la modalità solo template su Applicata.

  4. Esamina la finestra di dialogo di conferma, quindi fai clic su Conferma.

Interrompi l'applicazione della modalità solo template

Se interrompi l'applicazione della modalità solo template, tieni presente quanto segue:

  • Le richieste tramite Firebase AI Logic che non utilizzano template di prompt del server verranno consentite.
  • Questa è un'impostazione a livello di progetto per Firebase AI Logic.

Ecco come interrompere l'applicazione della modalità Solo modelli per il tuo progetto Firebase:

  1. Nella console Firebase, vai a Servizi AI > AI Logic > scheda Impostazioni.

  2. In Modalità template, disattiva Applica la modalità solo template.

  3. Esamina la finestra di dialogo di conferma, quindi fai clic su Conferma.