Sprawdzone metody i wskazówki dotyczące szablonów


Na tej stronie znajdziesz sprawdzone metody i wskazówki dotyczące szablonów promptów serwera, w tym funkcje, które nie są jeszcze obsługiwane. Pamiętaj, że wiele z tych funkcji nie jest dostępnych w pierwszej wersji szablonów promptów serwera, więc sprawdzaj informacje o wersji, aby być na bieżąco.

Sprawdzone metody

Wiele z tych sprawdzonych metod zostało również opisanych w artykule Zarządzanie szablonami.

Wersjonowanie szablonów

Chroń swój szablon

  • Zablokuj szablon przed przejściem do środowiska produkcyjnego. Unikaj też edytowania szablonów używanych w środowisku produkcyjnym.

    • Zablokowanie szablonu chroni przed przypadkową edycją, ale nie całkowicie blokuje edytowanie. Członek projektu z odpowiednimi uprawnieniami może zawsze odblokować szablon, aby go edytować.

    • Zalecamy blokowanie szablonów, które są aktywnie używane przez kod, zwłaszcza kod produkcyjny.

  • Napisz solidną weryfikację danych wejściowych dla zmiennych wejściowych, która może pomóc w tych kwestiach:

    • Może pomóc w ochronie przed wstrzykiwaniem promptów.
    • Może pomóc w zapewnieniu, że żądania zostaną zrealizowane, a odpowiedzi będą zgodne z oczekiwaniami.

Funkcje, które nie są jeszcze obsługiwane

Wiele z tych funkcji, które nie są jeszcze obsługiwane, nie będzie dostępnych tylko w początkowej wersji. Aktualne informacje znajdziesz w informacjach o wersji.

Funkcje Firebase AI Logic, które nie są jeszcze obsługiwane

Szablony promptów serwera nie obsługują jeszcze tych funkcji usługi Firebase AI Logic. Niektóre z tych funkcji będą dostępne już wkrótce.

  • Czat
  • Korzystanie z narzędzi (w tym wywoływanie funkcji i grounding w wyszukiwarce Google)
  • Iteracyjne edytowanie obrazów (czat) za pomocą modeli Gemini (wymaga czatu)
  • Edytowanie obrazów za pomocą modeli Imagen
  • Strumieniowanie dwukierunkowe (Gemini Live API)
  • Hybrydowe na urządzeniu
  • Ograniczanie danych wyjściowych do listy wyliczeń
  • Konfigurowanie ustawień związanych z myśleniem
  • Konfigurowanie ustawień bezpieczeństwa

Pamiętaj też, że jeśli korzystasz z monitorowania AI w konsoli Firebase, identyfikator szablonu nie jest jeszcze wypełniany w żadnym rekordzie.

Jeszcze nieobsługiwane typowe elementy Dotprompt

Szablony promptów serwera wkrótce będą prawdopodobnie obsługiwać te popularne elementy Dotprompt:

  • Użyj specyfikacji schematu JSON dla schematów wejściowych i wyjściowych w nagłówku.

    • Pamiętaj, że ta specyfikacja nie jest też obsługiwana w przypadku żądań szablonów innych niż serwerowe. Obecnie obsługujemy tylko specyfikację schematu OpenAPI.

  • Deklarowanie definicji pola z symbolem wieloznacznym za pomocą znaku *.

  • Używanie @key lub ogólne iterowanie po polach danych wejściowych obiektu (w przypadku gdy @key jest odpowiednie).

  • Użyj @root, aby odwołać się do kontekstu zmiennej głównej niezależnie od bieżącego this.

Szablony promptów serwera prawdopodobnie nie będą obsługiwać tych typowych elementów Dotprompt:

  • Używanie częściowych szablonów, czyli fragmentów szablonów wielokrotnego użytku, które można umieszczać w innych szablonach.

Inne uwagi

  • Domyślnie, gdy korzystasz z interfejsu z instrukcjami w Firebase konsoli, udostępniamy szablon we wszystkich dostępnych regionach Firebase AI Logic. Jeśli używasz Vertex AI Gemini API i Twój przypadek użycia wymaga ograniczeń opartych na lokalizacji, możesz określić lokalizację szablonu za pomocą interfejsu REST API.

  • Jeśli chcesz udostępnić szablon promptu serwera jako plik (zamiast korzystać z interfejsu Firebase konsoli), możesz użyć interfejsu REST API. Pamiętaj, że szablony promptów serwera nie obsługują schematu zdefiniowanego w kodzie aplikacji i przekazywanego do szablonu.

  • Chociaż szablon znajduje się na serwerze, nie może bezpośrednio wchodzić w interakcje z innymi zasobami po stronie serwera w projekcie Firebase (np. z bazą danych)z wyjątkiem Cloud Storage for Firebase adresów URL (które mogą być podawane jako zmienne wejściowe).