Erweiterte Workflows für Vorlagen


Für Firebase AI Logic bietet die Firebase-Konsole eine geführte Benutzeroberfläche, in der Sie den Inhalt einer Vorlage angeben können. Es gibt jedoch mehrere Anwendungsfälle, in denen Sie möglicherweise erweiterte Methoden zum Einrichten einer Vorlage benötigen, z. B.:

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 mit derselben Vorlagen-ID in Ihrem REST API-Aufruf überschreiben. Eine gesperrte Vorlage kann nicht überschrieben werden.

  • Wenn Sie eine Server-Prompt-Vorlage über die REST API erstellen und den 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 Agent Platform Gemini API (formerly Vertex AI) verfügbar. Weitere Informationen zum Festlegen eines bestimmten Speicherorts 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 automatisch an allen Standorten (einschließlich global) bereitgestellt und kann mit beiden Gemini API-Anbietern verwendet werden.

  • Wenn Sie über die REST API in einer templateGenerateContent- oder templateStreamGenerateContent-Anfrage auf eine Server-Prompt-Vorlage zugreifen möchten, müssen Sie den Endpunkt verwenden, der für Ihren Gemini API-Bereitsteller spezifisch ist (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

(Nur Agent Platform Gemini API (formerly Vertex AI)) Einen bestimmten Ort für eine Vorlage festlegen

Dieser Abschnitt gilt für folgende Situationen:

  • Der Anwendungsfall Ihrer App hat standortbezogene Anforderungen.

  • Die Anfragen Ihrer App verwenden Agent Platform Gemini API (formerly Vertex AI) und Sie geben einen Standort für den Zugriff auf ein Modell an.

Wie bereits auf dieser Seite beschrieben, wird automatisch eine Server-Prompt-Vorlage für alle unterstützten 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 Console.
  • Erstellen Sie die Vorlage über die REST API und legen Sie den Speicherort 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 nicht in der Anfrage Ihrer App an global festlegen.

Wenn Sie jedoch möchten, dass Ihre Vorlage nur an einem bestimmten Ort verfügbar ist, müssen Sie die Vorlage über die REST API erstellen und diesen bestimmten Ort explizit festlegen. Legen Sie den Standort nicht auf global fest.

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

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

Beachten Sie Folgendes:

  • In der Liste der Vorlagen in der Firebase-Konsole werden nur Vorlagen angezeigt, die (mindestens) am global-Standort 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 den Inhalt einer Server-Prompt-Vorlagendatei bereitstellen, indem Sie den Endpunkt projects.locations.templates.create aufrufen.