Wymuszanie trybu tylko szablon


W projekcie w Firebase możesz wymusić tryb tylko szablonu, aby wszystkie żądania Gemini API wysyłane przez Firebase AI Logic musiały używać szablonów promptów serwera.

Gdy żądanie zostanie zablokowane, odpowiedzią będzie błąd 403: unauthorized.

Istotne kwestie

Pamiętaj o tych ważnych kwestiach dotyczących trybu „Tylko szablony”.

Gdy wymuszany jest tryb tylko szablonu

Gdy wymuszony jest tryb tylko szablonów, pamiętaj o tych kwestiach:

  • To ustawienie jest ustawieniem dla całego projektu w przypadku Firebase AI Logic.

    • Dotyczy wszystkich aplikacji zarejestrowanych w projekcie.
    • Dotyczy tylko projektu, w którym jest egzekwowana.

  • To ustawienie dotyczy wszystkich żądań wysyłanych przez Firebase AI Logic zarówno do Gemini Developer API, jak i do Agent Platform Gemini API (formerly Vertex AI).

  • To ustawienie blokuje wszystkie żądania wysyłane przez Firebase AI Logic, które nie używają szablonów promptów serwera. Obejmuje to blokowanie żądań z aplikacji, które używają nieobsługiwanych jeszcze funkcji szablonów promptów serwera.

  • To ustawienie nie blokuje żądań Gemini API w Twoim projekcie, które nie są wysyłane przez Firebase AI Logic.

  • Jeśli używasz interfejsu Firebase AI Logic REST API:

    • To ustawienie nie blokuje żądań wnioskowania, które używają szablonów promptów serwera (np. templateGenerateContent lub templateStreamGenerateContent).
    • To ustawienie nie blokuje żądań płaszczyzny sterowania (takich jak żądania zarządzania szablonami i konfiguracjami).

  • To ustawienie nie blokuje żądań wysyłanych do countTokens (interfejs Count Tokens API).

Przed wymuszeniem trybu tylko szablonów

Zanim wymusisz tryb „Tylko szablony”, pamiętaj o tych kwestiach:

  • Jeśli masz już wersje aplikacji, które nie używają szablonów promptów serwera:

    • To ustawienie będzie blokować żądania wysyłane przez Firebase AI Logic z tych istniejących wersji aplikacji.
    • Zanim wymusisz tryb tylko szablonów, upewnij się, że wszystkie aktywne klienty zostały zaktualizowane, aby używały szablonów promptów serwera.

  • Jeśli Twoja aplikacja korzysta z nieobsługiwanych jeszcze funkcji szablonów promptów serwera:

    • To ustawienie będzie blokować żądania wysyłane przez Firebase AI Logic w przypadku tych nieobsługiwanych jeszcze funkcji, ponieważ nie używają one (i nie mogą używać) szablonów promptów serwera.
    • Zanim wymusisz tryb tylko szablonu, upewnij się, że Twoja aplikacja (w tym jej poprzednie wersje) nie korzysta aktywnie z żadnej z tych nieobsługiwanych jeszcze funkcji.

Zarządzanie ustawieniem trybu „Tylko szablony”

Ustawieniem trybu tylko szablonu zarządzasz w konsoli Firebase.

Wymagane uprawnienia i role uprawnień

Zarządzanie ustawieniem trybu tylko szablonu wymaga uprawnienia firebasevertexai.configs.update, które jest domyślnie uwzględnione w tych rolach uprawnień: Właściciel, Edytujący, Administrator Firebase i Administrator Firebase AI Logic.

Wymuś tryb tylko szablonów

Aby wymusić tryb „Tylko szablon” w projekcie w Firebase:

  1. Jeśli jeszcze nie znasz ważnych kwestii dotyczących trybu tylko szablonu, zapoznaj się z nimi we wcześniejszej części tego przewodnika.

  2. W konsoli Firebase otwórz Usługi AI > Logika AI > karta Ustawienia.

  3. W sekcji Tryb szablonu ustaw przełącznik Wymuś tryb tylko szablonu na Wymuszony.

  4. Przeczytaj informacje w oknie z potwierdzeniem i kliknij Potwierdź.

Zatrzymywanie egzekwowania trybu tylko szablonów

Jeśli wyłączysz wymuszanie trybu tylko szablonów, pamiętaj o tych kwestiach:

  • Żądania wysyłane przez Firebase AI Logic, które nie używają szablonów promptów serwera, będą dozwolone.
  • To jest ustawienie dla całego projektu Firebase AI Logic.

Aby zatrzymać egzekwowanie trybu „tylko szablon” w projekcie w Firebase:

  1. W konsoli Firebase otwórz Usługi AI > Logika AI > karta Ustawienia.

  2. W sekcji Tryb szablonu wyłącz opcję Wymuś tryb tylko szablonu.

  3. Przeczytaj informacje w oknie z potwierdzeniem i kliknij Potwierdź.