Erweiterte Workflows für Vorlagen


Für Firebase AI Logic bietet die Firebase-Konsole eine geführte Benutzeroberfläche, über die Sie den Inhalt 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 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 jedoch beim Erstellen der Vorlage über die REST API 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 Console 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 auf eine Server-Prompt-Vorlage in einer templateGenerateContent- oder templateStreamGenerateContent-Anfrage zugreifen möchten, müssen Sie den Endpunkt verwenden, der für Ihren Gemini API-Anbieter spezifisch ist (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).

(Nur Agent Platform Gemini API (formerly Vertex AI)) Bestimmten Speicherort für eine Vorlage festlegen

Dieser Abschnitt gilt für die folgenden Situationen:

  • Der Anwendungsfall Ihrer App hat standortbezogene Anforderungen.

  • Die Anfragen Ihrer Anwendung verwenden die 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 eine Server-Prompt-Vorlage automatisch für alle unterstützten Regionen für Firebase AI Logic (einschließlich global) bereitgestellt, wenn Sie einen der folgenden Schritte ausführen:

  • Erstellen Sie die Vorlage mithilfe der geführten Benutzeroberfläche in der Firebase Console.
  • Erstellen Sie die Vorlage über die REST API und legen Sie den Standort auf global fest.

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

Wenn Ihre Vorlage nur an einem bestimmten Standort verfügbar sein soll, müssen Sie die Vorlage über die REST API erstellen und diesen Standort 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 (z. B. europe-west4) als Teil der Erstellung einer PromptTemplate an.

  2. Achten Sie darauf, dass der Ort, an dem Sie auf das Modell zugreifen, in der Anfrage Ihrer Anwendung mit dem Ort der Vorlage (eu) ü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 (nicht global), muss der Standort, an dem Sie in der Anfrage Ihrer Anwendung auf das Modell zugreifen, mit dem für die Vorlage festgelegten Standort übereinstimmen. Wenn die Standorte nicht übereinstimmen, schlägt die Anfrage aufgrund regionaler Isolationsrichtlinien fehl.

Vorlage als Datei bereitstellen

Sie können den Inhalt einer Server-Prompt-Vorlagendatei angeben, indem Sie den Endpunkt projects.locations.templates.create aufrufen.