Sie können den Vorlagenmodus für Ihr Firebase-Projekt erzwingen, sodass für alle Gemini API-Anfragen über Firebase AI Logic Server-Promptvorlagen verwendet werden müssen.
Wenn eine Anfrage blockiert wird, ist die Antwort ein 403: unauthorized-Fehler.
Wichtige Aspekte
Beachten Sie die folgenden wichtigen Aspekte 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 durchgesetzt wird.
Diese Einstellung gilt für alle Anfragen über Firebase AI Logic sowohl an die Gemini Developer API als auch an die 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 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 Inferenzanfragen, die Server-Promptvorlagen verwenden (z. B.
templateGenerateContentodertemplateStreamGenerateContent). - Diese Einstellung blockiert Anfragen der Steuerungsebene (z. B. zum Verwalten von Vorlagen und Konfigurationen) nicht.
- Diese Einstellung blockiert Inferenzanfragen, die Server-Promptvorlagen verwenden (z. B.
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 vorhandene Versionen Ihrer App haben, die keine Server-Prompt-Vorlagen verwenden:
- Mit dieser Einstellung werden Anfragen über Firebase AI Logic aus diesen vorhandenen App-Versionen blockiert.
- Achten Sie darauf, dass alle aktiven Clients aktualisiert wurden, sodass sie Server-Prompt-Vorlagen verwenden, bevor Sie den Vorlagenmodus erzwingen.
Wenn Ihre App noch nicht unterstützte Funktionen für Server-Promptvorlagen 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 aller früheren Versionen) keine dieser noch nicht unterstützten Funktionen aktiv nutzt, bevor der Vorlagenmodus erzwungen wird.
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“.
Vorlagenmodus erzwingen
So erzwingen Sie den Vorlagenmodus für Ihr Firebase-Projekt:
Falls Sie es noch nicht getan haben, lesen Sie die wichtigen Überlegungen für den reinen Vorlagenmodus weiter oben in diesem Leitfaden.
Rufen Sie in der Firebase Console den Tab AI Services > AI Logic > Einstellungen auf.
Stellen Sie unter Vorlagenmodus den Ein/Aus-Schalter für Vorlagenmodus erzwingen auf Erzwungen.
Prüfen Sie das Bestätigungsdialogfeld und klicken Sie dann auf Bestätigen.
Erzwingung des Vorlagenmodus beenden
Wenn Sie die Erzwingung 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 die Erzwingung des Nur-Vorlagen-Modus für Ihr Firebase-Projekt:
Rufen Sie in der Firebase Console den Tab AI Services > AI Logic > Einstellungen auf.
Deaktivieren Sie unter Vorlagenmodus die Option Vorlagenmodus erzwingen.
Prüfen Sie das Bestätigungsdialogfeld und klicken Sie dann auf Bestätigen.