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


Ta strona zawiera sprawdzone metody i uwagi dotyczące szablonów podpowiedzi serwera, w tym funkcji, które nie są jeszcze obsługiwane. Pamiętaj, że wiele z tych funkcji będzie dostępnych w miarę rozwoju 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 też opisanych w artykule Zarządzanie szablonami.

Wersjonowanie szablonów

Ochrona szablonu

  • Unikaj edytowania szablonów używanych w środowisku produkcyjnym, chyba że zmiany zostały dokładnie przetestowane.

  • Zablokuj szablon przed przejściem do środowiska produkcyjnego.

    • Zablokowanie szablonu chroni przed przypadkową edycją, ale zablokowanie nie blokuje edycji całkowicie. 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.

Ochrona korzystania z Gemini API

  • Napisz silną walidację danych wejściowych dla zmiennych wejściowych, co może pomóc w:

    • ochronie przed wstrzykiwaniem promptów.
    • zapewnieniu, że żądania się powiodą, a odpowiedzi będą zgodne z oczekiwaniami.

  • Wymuś tryb tylko szablonu w projekcie w Firebase, aby wszystkie Gemini API żądania wysyłane przez Firebase AI Logic musiały używać szablonu podpowiedzi serwera.

Funkcje, które nie są jeszcze obsługiwane przez szablony podpowiedzi serwera

Wiele z tych funkcji będzie dostępnych w miarę rozwoju szablonów podpowiedzi serwera, więc sprawdzaj informacje o wersji, aby być na bieżąco.

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

Te standardowe funkcje z Firebase AI Logic nie są jeszcze obsługiwane przez szablony podpowiedzi serwera:

  • Strumieniowanie dwukierunkowe (Gemini Live API)
  • Wnioskowanie hybrydowe lub na urządzeniu
  • Ograniczanie danych wyjściowych do listy wyliczeń

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

Typowe elementy Dotprompt, które nie są jeszcze obsługiwane przez szablony

Szablony podpowiedzi serwera prawdopodobnie wkrótce będą obsługiwać te typowe elementy Dotprompt:

  • Używanie 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 żądaniach 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ólnie iterowanie po polach wejściowego obiektu (w którym to przypadku @key jest istotne).

  • Używanie @root, które pozwala odwoływać się do kontekstu zmiennej głównej niezależnie od bieżącego this.

Szablony podpowiedzi 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 uwzględnić w innych szablonach.

Inne uwagi

  • Domyślnie, gdy używasz interfejsu z przewodnikiem w konsoli Firebase, udostępniamy szablon we wszystkich dostępnych regionach dla 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 podpowiedzi serwera jako plik (zamiast używać interfejsu z przewodnikiem w konsoli Firebase), możesz użyć interfejsu REST API. Pamiętaj, że szablony podpowiedzi serwera nie obsługują schematu zdefiniowanego w kodzie aplikacji i przekazanego do szablonu.

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