Vorlagenmodus erzwingen


Sie können für Ihr Firebase-Projekt den Vorlagenmodus erzwingen, sodass alle Gemini API Anfragen über Firebase AI Logic Server-Promptvorlagen verwenden müssen.

Wenn eine Anfrage blockiert wird, ist die Antwort ein 403: unauthorized-Fehler.

Wichtige Aspekte

Beachten Sie die folgenden wichtigen Aspekte für den Vorlagenmodus.

Wenn der Vorlagenmodus erzwungen wird

Wenn der Vorlagenmodus erzwungen wird, beachten Sie Folgendes:

  • Diese Einstellung ist eine projektweite Einstellung für Firebase AI Logic.

    • Sie gilt für alle im Projekt registrierten Apps.
    • Sie gilt nur für das Projekt, in dem sie erzwungen wird.

  • Diese Einstellung gilt für alle Anfragen über Firebase AI Logic an die Gemini Developer API und die Vertex AI Gemini API.

  • Diese Einstellung blockiert alle Anfragen über Firebase AI Logic die keine Server-Promptvorlagen verwenden. Dazu gehört auch das Blockieren von Anfragen aus Ihrer App, die noch nicht unterstützte Funktionen für Server-Promptvorlagen verwenden.

  • Diese Einstellung blockiert keine Gemini API Anfragen in Ihrem Projekt die nicht über Firebase AI Logic erfolgen.

  • Wenn Sie die Firebase AI Logic REST-API verwenden:

    • Diese Einstellung blockiert keine Inferenzanfragen , die Server-Promptvorlagen verwenden (z. B. templateGenerateContent oder templateStreamGenerateContent).
    • Diese Einstellung blockiert keine Control-Plane-Anfragen (z. B. Anfragen zum Verwalten von Vorlagen und Konfigurationen).

  • Diese Einstellung blockiert keine Anfragen an countTokens (die Count Tokens API).

Vor dem Erzwingen des Vorlagenmodus

Beachten Sie Folgendes, bevor Sie den Vorlagenmodus erzwingen:

  • Wenn Sie vorhandene Versionen Ihrer App haben, die keine Server-Promptvorlagen verwenden:

    • Diese Einstellung blockiert Anfragen über Firebase AI Logic aus diesen vorhandenen App-Versionen.
    • Achten Sie darauf, dass alle aktiven Clients aktualisiert wurden, um Server-Promptvorlagen zu verwenden, bevor Sie den Vorlagenmodus erzwingen.

  • Wenn Ihre App noch nicht unterstützte Funktionen für Server-Promptvorlagen verwendet:

    • Diese Einstellung blockiert Anfragen über Firebase AI Logic für diese noch nicht unterstützten Funktionen, da sie keine Server-Promptvorlagen verwenden (und nicht verwenden können).
    • Achten Sie darauf, dass Ihre App (einschließlich aller früheren Versionen) keine dieser noch nicht unterstützten Funktionen aktiv verwendet, bevor Sie den Vorlagenmodus erzwingen.

Einstellung für den Vorlagenmodus verwalten

Sie verwalten die Einstellung für den Vorlagenmodus in der Firebase Console.

Erforderliche IAM-Berechtigungen und -Rollen

Zum Verwalten der Einstellung für den Vorlagenmodus ist die Berechtigung firebasevertexai.configs.update erforderlich. Sie ist standardmäßig in den folgenden IAM-Rollen enthalten: „Owner“, „Editor“, „Firebase Admin“ und „Firebase AI Logic Admin“.

Vorlagenmodus erzwingen

So erzwingen Sie den Vorlagenmodus für Ihr Firebase-Projekt:

  1. Wenn Sie es noch nicht getan haben, lesen Sie die wichtigen Aspekte für den Vorlagenmodus weiter oben in diesem Leitfaden.

  2. Rufen Sie in der Firebase Console den Tab AI Services > AI Logic > Settings auf.

  3. Bewegen Sie unter Vorlagenmodus den Schieberegler für Vorlagenmodus erzwingen auf Erzwungen.

  4. Prüfen Sie das Bestätigungsdialogfeld und klicken Sie dann auf Bestätigen.

Erzwingen des Vorlagenmodus beenden

Wenn Sie das Erzwingen des Vorlagenmodus beenden, beachten Sie Folgendes:

  • Anfragen über Firebase AI Logic die keine Server-Promptvorlagen verwenden sind zulässig.
  • Dies ist eine projektweite Einstellung für Firebase AI Logic.

So beenden Sie das Erzwingen des Vorlagenmodus für Ihr Firebase-Projekt:

  1. Rufen Sie in der Firebase Console den Tab AI Services > AI Logic > Settings auf.

  2. Deaktivieren Sie unter Vorlagenmodus die Option Nur Vorlagenmodus erzwingen.

  3. Prüfen Sie das Bestätigungsdialogfeld und klicken Sie dann auf Bestätigen.