Wymuszanie trybu tylko szablon


Możesz wymusić tryb tylko szablonu dla swojego projektu w Firebase, aby wszystkie żądania Gemini API wysyłane za pomocą Firebase AI Logic musiały korzystać z szablonów promptów serwera.

Gdy żądanie zostanie zablokowane, odpowiedź będzie zawierać błąd 403: unauthorized.

Ważne kwestie

Pamiętaj o tych ważnych kwestiach dotyczących trybu tylko szablonu.

Gdy wymuszony jest tryb tylko szablon

Gdy wymuszony jest tryb tylko szablonu, pamiętaj o tych kwestiach:

  • To ustawienie dotyczy całego projektu w przypadku Firebase AI Logic.

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

  • To ustawienie dotyczy wszystkich żądań wysyłanych przez Firebase AI Logic do Gemini Developer API i Vertex AI Gemini API.

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

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

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

    • To ustawienie nie blokuje żądań wnioskowania, które korzystają z szablonów promptów serwera (np. templateGenerateContent lub templateStreamGenerateContent).
    • To ustawienie nie blokuje żądań płaszczyzny sterowania (np. żądań dotyczących zarządzania szablonami i konfiguracjami).

  • To ustawienie nie blokuje żądań do interfejsu countTokens (Count Tokens API).

Przed wymuszeniem trybu tylko szablon

Zanim wymusisz tryb tylko szablonu, zwróć uwagę na te kwestie:

  • Jeśli masz istniejące wersje aplikacji, które nie korzystają z szablonów promptów serwera:

    • To ustawienie blokuje żądania wysyłane przez Firebase AI Logic z tych wersji aplikacji.
    • Upewnij się, że wszyscy aktywni klienci zostali zaktualizowani, aby używać szablonów promptów serwera przed wymuszeniem trybu tylko szablonów.

  • Jeśli Twoja aplikacja używa nieobsługiwanych jeszcze funkcji szablonów promptów serwera:

    • To ustawienie blokuje żądania wysyłane przez Firebase AI Logic w przypadku tych nieobsługiwanych jeszcze funkcji, ponieważ nie korzystają one (i nie mogą korzystać) z szablonów promptów serwera.
    • Zanim włączysz tryb tylko z szablonami, upewnij się, że Twoja aplikacja (w tym każda jej poprzednia wersja) nie korzysta aktywnie z żadnych funkcji, które nie są jeszcze obsługiwane.

Zarządzanie ustawieniem trybu tylko szablonu

Ustawieniem trybu tylko szablonu zarządzasz w konsoli Firebase.

Wymagane uprawnienia i role

Zarządzanie ustawieniem trybu tylko szablonu wymaga uprawnienia firebasevertexai.configs.update, które jest domyślnie przyznawane w ramach tych ról IAM: Właściciel, Edytujący, Administrator Firebase i Administrator Firebase AI Logic.

Wymuszanie trybu tylko szablonu

Aby włączyć w projekcie w Firebase tryb tylko szablonu:

  1. Jeśli jeszcze tego nie zrobiono, zapoznaj się z ważnymi kwestiami dotyczącymi trybu tylko szablonu, które zostały omówione wcześniej w tym przewodniku.

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

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

  4. Sprawdź informacje w oknie potwierdzenia i kliknij Potwierdź.

Zatrzymywanie egzekwowania trybu tylko szablon

Jeśli przestaniesz egzekwować tryb tylko szablonu, pamiętaj o tych kwestiach:

  • Żądania wysyłane za pomocą Firebase AI Logic, które nie korzystają z szablonów promptów serwera, będą dozwolone.
  • Jest to ustawienie dla całego projektu w przypadku Firebase AI Logic.

Aby zatrzymać egzekwowanie trybu tylko szablonu 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 szablon.

  3. Sprawdź informacje w oknie potwierdzenia i kliknij Potwierdź.