Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Vorlagenmodus erzwingen

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

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

Wichtige Aspekte

Beachten Sie die folgenden wichtigen Überlegungen zum Modus „Nur Vorlage“.

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 sowohl an Gemini Developer API als auch an Agent Platform Gemini API (formerly Vertex AI).
Mit dieser Einstellung werden alle Anfragen über Firebase AI Logic blockiert, die keine Server-Prompt-Vorlagen verwenden. Dazu gehört auch das Blockieren von Anfragen aus Ihrer App, die noch nicht unterstützte Funktionen für Server-Prompt-Vorlagen verwenden.
Mit dieser Einstellung werden Gemini API-Anfragen in Ihrem Projekt, die nicht über Firebase AI Logic erfolgen, nicht blockiert.
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 Anfragen an die Steuerungsebene (z. B. zum Verwalten von Vorlagen und Konfigurationen).
Mit dieser Einstellung werden Anfragen an countTokens (die Count Tokens API) nicht blockiert.

Vor dem Erzwingen des Vorlagenmodus

Beachten Sie Folgendes, bevor Sie den Vorlagenmodus erzwingen:

Wenn Sie bereits Versionen Ihrer App haben, die keine Server-Prompt-Vorlagen verwenden:
- Mit dieser Einstellung werden Anfragen über Firebase AI Logic von diesen vorhandenen App-Versionen blockiert.
- Achten Sie darauf, dass alle aktiven Clients so aktualisiert sind, dass sie Server-Prompt-Vorlagen verwenden, bevor Sie den Vorlagenmodus erzwingen.
Wenn Ihre App noch nicht unterstützte Funktionen für Server-Prompt-Vorlagen verwendet:
- Mit dieser Einstellung werden Anfragen über Firebase AI Logic für diese noch nicht unterstützten Funktionen blockiert, da sie keine Server-Prompt-Vorlagen verwenden (und auch nicht verwenden können).
- Achten Sie darauf, dass Ihre App (einschließlich früherer 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-Konsole.

Erforderliche IAM-Berechtigungen und -Rollen

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