Best Practices und Überlegungen für Vorlagen


Auf dieser Seite werden einige Best Practices und Überlegungen zu Server-Prompt-Vorlagen beschrieben, einschließlich Funktionen, die noch nicht unterstützt werden. Viele dieser Funktionen sind nur bei der ersten Veröffentlichung von Server-Prompt-Vorlagen nicht verfügbar. In den Versionshinweisen finden Sie aktuelle Informationen.

Best Practices

Viele dieser Best Practices werden auch unter Vorlagen verwalten beschrieben.

Vorlagen versionieren

Vorlagen schützen

  • Sperren Sie Ihre Vorlage, bevor Sie sie in der Produktion verwenden. Vermeiden Sie außerdem, Vorlagen zu bearbeiten, die in der Produktion verwendet werden.

    • Das Sperren einer Vorlage schützt vor unbeabsichtigten Änderungen, aber das Sperren verhindert nicht vollständig, dass sie bearbeitet werden kann. Ein Projektmitglied mit den entsprechenden Berechtigungen kann eine Vorlage jederzeit entsperren, um sie zu bearbeiten.

    • Wir empfehlen, Vorlagen zu sperren, die aktiv von Code verwendet werden, insbesondere von Produktionscode.

  • Schreiben Sie eine starke Eingabevalidierung für Ihre Eingabevariablen. Das kann in folgenden Fällen hilfreich sein:

    • Kann vor Prompt-Injection schützen.
    • Kann dazu beitragen, dass Anfragen erfolgreich sind und Antworten wie erwartet ausfallen.

Noch nicht unterstützte Funktionen

Viele dieser noch nicht unterstützten Funktionen sind nur bei der ersten Veröffentlichung nicht verfügbar. In den Versionshinweisen finden Sie aktuelle Informationen.

Noch nicht unterstützte Funktionen von Firebase AI Logic

Server-Prompt-Vorlagen unterstützen die folgenden Funktionen von Firebase AI Logic noch nicht. Einige dieser Funktionen sind bald verfügbar.

  • Chat
  • Funktionsaufrufe
  • Iterative Bildbearbeitung (Chat) mit Gemini Modellen (erfordert Chat)
  • Bidirektionales Streaming (Gemini Live API)
  • Hybrid- oder On-Device-Inferenz
  • Ausgabe auf eine Liste von Enums beschränken

Wenn Sie die KI-Überwachung in der Firebase Konsole verwenden, wird die Vorlagen-ID noch nicht in Datensätzen ausgefüllt.

Noch nicht unterstützte allgemeine Elemente von Dotprompt

Server-Prompt-Vorlagen unterstützen wahrscheinlich bald die folgenden allgemeinen Elemente von Dotprompt:

  • Verwendung der JSON-Schema-Spezifikation für Eingabe- und Ausgabeschemas in der Frontmatter.

    • Diese Spezifikation wird auch in Anfragen für Nicht-Server-Vorlagen nicht unterstützt. Derzeit wird nur die OpenAPI-Schema-Spezifikation unterstützt.

  • Deklarieren einer Platzhalter-Felddefinition mit *.

  • Verwendung von @key oder allgemeines Durchlaufen der Felder einer Objekteingabe (was der Fall ist, wenn @key relevant ist).

  • Verwendung von @root, mit dem Sie unabhängig vom aktuellen this auf den Kontext der Stammvariablen verweisen können.

Server-Prompt-Vorlagen unterstützen die folgenden allgemeinen Elemente von Dotprompt wahrscheinlich nicht:

  • Verwendung von Partials, die wiederverwendbare Vorlagen-Snippets sind, die in andere Vorlagen eingefügt werden können.

Weitere Hinweise

  • Wenn Sie die geführte Benutzeroberfläche in der Firebase Konsole verwenden, stellen wir die Vorlage standardmäßig in allen verfügbaren Regionen für Firebase AI Logic bereit. Wenn Sie die Vertex AI Gemini API verwenden und Ihr Anwendungsfall standortbasierte Einschränkungen erfordert, können Sie den Standort für Ihre Vorlage mit der REST API angeben.

  • Wenn Sie eine Server-Prompt-Vorlage als Datei bereitstellen möchten (anstatt die geführte Benutzeroberfläche der Firebase Konsole zu verwenden), können Sie die REST API verwenden. Server-Prompt-Vorlagen unterstützen kein Schema, das im App-Code definiert und an die Vorlage übergeben wird.

  • Obwohl sich die Vorlage auf dem Server befindet, kann sie nicht direkt mit anderen serverseitigen Ressourcen Ihres Firebase-Projekts interagieren (z. B. einer Datenbank), mit Ausnahme von Cloud Storage for Firebase URLs (die als Eingabevariablen bereitgestellt werden können).