Wymuszanie trybu tylko szablon


Możesz wymusić tryb tylko szablonu w projekcie 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, w odpowiedzi pojawi się błąd 403: unauthorized.

Ważne kwestie

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

Gdy jest wymuszony tryb tylko szablonu

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

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

    • Ma zastosowanie do wszystkich aplikacji zarejestrowanych w projekcie.
    • Dotyczy to tylko projektu, w którym jest egzekwowane.
  • 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 za pomocą interfejsu 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 przez Firebase AI Logic.

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

    • 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 countTokens (interfejsu Count Tokens API).

Przed wymuszeniem trybu tylko szablonu

Zanim wymusisz tryb tylko szablonu, pamiętaj o tych kwestiach:

  • 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.
    • Zanim wymusisz tryb tylko szablonów, upewnij się, że wszyscy aktywni klienci są zaktualizowani, aby używać 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 korzystają one (i nie mogą korzystać) z szablonów promptów na serwerze.
    • Zanim włączysz tryb tylko z szablonami, upewnij się, że Twoja aplikacja (w tym każda jej poprzednia wersja) nie korzysta aktywnie z żadnych z tych jeszcze nieobsługiwanych funkcji.

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 zawarte w tych rolach uprawnień: Właściciel, Edytujący, Administrator Firebase i Administrator Firebase AI Logic.

Wymuszanie trybu tylko szablon

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 Wymuś tryb tylko szablonu na Wymuszony.

  4. Przeczytaj informacje w oknie z potwierdzeniem 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 szablonów 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. Przeczytaj informacje w oknie z potwierdzeniem i kliknij Potwierdź.