Erweiterte Workflows für Vorlagen


Für Firebase AI Logic bietet die Firebase Konsole eine geführte Benutzeroberfläche, auf der Sie die Inhalte einer Vorlage angeben können. Es gibt jedoch mehrere Anwendungsfälle, in denen Sie möglicherweise erweiterte Möglichkeiten zum Einrichten einer Vorlage benötigen, darunter:

Die auf dieser Seite beschriebenen erweiterten Workflows verwenden die Firebase AI Logic REST API.

Wichtige Informationen zur Verwendung der REST API

  • Wenn eine Vorlage entsperrt ist, können Sie sie überschreiben, indem Sie in Ihrem REST API-Aufruf dieselbe Vorlagen-ID verwenden. Eine gesperrte Vorlage kann nicht überschrieben werden.

  • Wenn Sie eine Server-Prompt-Vorlage über die REST API erstellen und ihren Standort auf global festlegen, wird die Server-Prompt-Vorlage automatisch an allen Standorten (einschließlich global) bereitgestellt und kann mit beiden Gemini API Anbietern verwendet werden. Wenn Sie beim Erstellen der Vorlage über die REST API jedoch einen anderen Standort festlegen, ist die Vorlage nur für die Vertex AI Gemini API verfügbar. Weitere Informationen zum Festlegen eines bestimmten Standorts für eine Vorlage finden Sie weiter unten auf dieser Seite.

    Wenn Sie die geführte Benutzeroberfläche in der Firebase Konsole verwenden, wird die Vorlage ebenfalls automatisch an allen Standorten (einschließlich global) bereitgestellt, und kann mit beiden Gemini API Anbietern verwendet werden.

  • Um über die REST API auf eine Server-Prompt-Vorlage in einer templateGenerateContent oder templateStreamGenerateContent Anfrage zuzugreifen, müssen Sie den Endpunkt verwenden, der für Ihren Gemini API Anbieter (Gemini Developer API | Vertex AI Gemini API) spezifisch ist.

(Vertex AI Gemini API nur) Bestimmten Standort für eine Vorlage festlegen

Dieser Abschnitt gilt für folgende Situationen:

Wie bereits auf dieser Seite beschrieben, wird eine Server-Prompt-Vorlage automatisch in allen verfügbaren Regionen für Firebase AI Logic (einschließlich global) bereitgestellt, wenn Sie eine der folgenden Aktionen ausführen:

  • Erstellen Sie die Vorlage über die geführte Benutzeroberfläche in der Firebase Konsole.
  • Erstellen Sie die Vorlage über die REST API und legen Sie ihren Standort auf global fest.

Das bedeutet, dass Sie den Standort in der Anfrage Ihrer App auf eine der verfügbaren Regionen für Firebase AI Logic, festlegen können und die Vorlage verfügbar ist. Sie müssen den Standort in der Anfrage Ihrer App nicht auf global festlegen.

Wenn Ihre Vorlage jedoch nur an einem bestimmten Standort verfügbar sein soll, müssen Sie die Vorlage über die REST API erstellen und diesen bestimmten Standort explizit festlegen. Legen Sie den Standort nicht als global fest.

  1. Erstellen Sie die Vorlage, indem Sie den projects.locations.templates.create Endpunkt aufrufen. Geben Sie den location der Vorlage an (z. B. europe-west4) wenn Sie eine PromptTemplate erstellen.

  2. Achten Sie in der Anfrage Ihrer App darauf, dass der Standort, an dem Sie auf das Modell zugreifen mit dem Standort der Vorlage (europe-west4) übereinstimmt.

Beachten Sie Folgendes:

  • In der Liste der Vorlagen in der Firebase Konsole werden nur Vorlagen angezeigt, die (mindestens) am Standort global bereitgestellt werden.

  • Wenn Sie die REST API verwenden, um eine Vorlage an einem bestimmten Standort bereitzustellen (der nicht global ist), muss der Standort, an dem Sie in der Anfrage Ihrer App auf das Modell zugreifen, mit dem für die Vorlage festgelegten Standort übereinstimmen. Wenn die Standorte nicht übereinstimmen, schlägt die Anfrage aufgrund von Richtlinien zur regionalen Isolation fehl.

Vorlage als Datei bereitstellen

Sie können die Inhalte einer Server-Prompt-Vorlagendatei bereitstellen, indem Sie den projects.locations.templates.create Endpunkt aufrufen.