Najczęstsze pytania i rozwiązywanie problemów

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Które interfejsy API należy włączyć, aby korzystać z pakietów SDK Vertex AI in Firebase? Jak je włączyć?

Aby korzystać z pakietów SDK Vertex AI in Firebase, musisz mieć włączone w projekcie te 2 interfejsy API:

• Vertex AI API (aiplatform.googleapis.com)
• Vertex AI in Firebase API (firebasevertexai.googleapis.com)

Możesz włączyć te interfejsy API za pomocą kilku kliknięć w konsoli Firebase:

1. Otwórz stronę Vertex AI.

2. Kliknij kartę Vertex AI in Firebase, aby uruchomić przepływ pracy, który włącza te 2 interfejsy API. W ramach tego procesu interfejs API Vertex AI in Firebase zostanie też dodany do listy dozwolonych kluczy interfejsu API Firebase.

Możesz też użyć konsoli Google Cloud (opcja bardziej ręczna):

1. Kliknij link do każdego interfejsu API u góry tego artykułu z najczęściej zadawanymi pytaniami, a potem na stronie każdego interfejsu API kliknij Włącz.

2. Dodaj interfejs API Vertex AI in Firebase do listy dozwolonych kluczy interfejsu API Firebase, wykonując instrukcje podane w sekcji Dodawanie ograniczeń interfejsu API w dokumentacji Google Cloud.

Jakich uprawnień wymagają pakiety SDK Vertex AI in Firebase?

Których modeli można używać z pakietami SDK Vertex AI in Firebase?

• Z pakietami SDK Vertex AI in Firebase możesz używać dowolnych modeli fundamentu Gemini i Imagen 3, w tym wersji podglądu i eksperymentalnych. Zobacz listę tych modeli w sekcji Więcej informacji o obsługiwanych modelach.

• Nie możesz używać modeli Gemini innych niż podstawowe (np. modeli PaLM, modeli zoptymalizowanych czy modeli opartych na Gemma) z pakietami SDK Vertex AI in Firebase.

  Interfejs Vertex AI in Firebase nie obsługuje też starszych modeli Imagen ani imagen-3.0-capability-001.

Często dodajemy do zestawów SDK nowe funkcje, dlatego sprawdzaj tę stronę z odpowiadaniami na najczęstsze pytania (a także informacje o wersji, blogi i posty w mediach społecznościowych).

Co zrobić, gdy modele są wycofywane z użycia?

Gdy udostępniamy stabilną wersję modelu, staramy się, aby była ona dostępna co najmniej przez rok. „Data zakończenia” jest podana w wielu miejscach w dokumentacji Firebase i Google Cloud (np. na stronie „Modele”).

Gdy model zostanie wycofany, wszystkie wywołania do niego zakończą się niepowodzeniem. Z tego powodu zdecydowanie zalecamy skonfigurowanie i używanie Firebase Remote Config, aby dynamicznie zmieniać model i wersję w aplikacji bez publikowania nowej wersji aplikacji.

Po zaktualizowaniu aplikacji do korzystania z nowej wersji modelu zalecamy przetestowanie aplikacji, aby sprawdzić, czy odpowiedzi są zgodne z oczekiwaniami. Pamiętaj, że podczas korzystania z Vertex AI in Firebase zazwyczaj nie trzeba modyfikować żadnego kodu, który faktycznie wywołuje model.

Oto daty wycofania z oferty poszczególnych modeli:

• Gemini 1.5 Pro modeli:

  • gemini-1.5-pro-002 (i gemini-1.5-pro): 24 września 2025 r.
  • gemini-1.5-pro-001: 24 maja 2025 r.

• Gemini 1.5 Flash modeli:

  • gemini-1.5-flash-002 (i gemini-1.5-flash): 24 września 2025 r.
  • gemini-1.5-flash-001: 24 maja 2025 r.

• Gemini 1.0 Pro Vision: 21 kwietnia 2025 r. (wcześniej zaplanowano to na 9 kwietnia 2025 r.)

• Gemini 1.0 Pro: 21 kwietnia 2025 r. (wcześniej zaplanowano to na 9 kwietnia 2025 r.)

Czy te funkcje są dostępne podczas korzystania z Vertex AI in Firebase? Buforowanie kontekstu, wyszukiwarka jako narzędzie, grounding z użyciem wyszukiwarki Google, wykonywanie kodu, dostrojenie modelu, generowanie wektorów osadzonych i wyszukiwanie semantyczne?

Buforowanie kontekstu, wyszukiwanie jako narzędzie, grounding z użyciem wyszukiwarki Google, wykonywanie kodu, dostrojenie modelu, generowanie wektorów zastępczych i wyszukiwanie semantyczne są obsługiwane przez różne modele lub Gemini API in Vertex AI, ale nie są dostępne podczas korzystania z Vertex AI in Firebase.

Jeśli chcesz dodać te funkcje jako żądania funkcji lub zagłosować na istniejące żądanie funkcji, odwiedź Firebase UserVoice.

Jak ustawić limit szybkości na użytkownika?

Domyślnie Vertex AI in Firebase ustawia limit żądań na użytkownika na 100 żądań na minutę (RPM).

Jeśli chcesz dostosować limit szybkości na użytkownika, musisz dostosować ustawienia limitu interfejsu API Vertex AI in Firebase.

Dowiedz się więcej o Vertex AI in Firebase limitach interfejsu API. Na tej stronie możesz też dowiedzieć się, jak wyświetlić i zmienić limit.

Jak naprawić błąd 400? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Jeśli próbujesz wysłać żądanie multimodalne za pomocą adresu URL Cloud Storage for Firebase, możesz napotkać ten błąd 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Ten błąd jest spowodowany tym, że w projekcie nie zostały automatycznie utworzone wymagane agenty usług, gdy włączono w nim interfejs API Vertex AI. Jest to znany problem z niektórymi projektami. Pracujemy nad globalnym rozwiązaniem.

Oto obejście, które pozwoli Ci poprawić projekt i prawidłowo skonfigurować tych agentów usług, aby można było uwzględniać adresy URL Cloud Storage for Firebase w żądaniach multimodalnych. Musisz być właścicielem projektu. Wystarczy, że wykonasz ten zestaw zadań tylko raz.

1. Uzyskaj dostęp i uwierzytelnij się za pomocą usługi gcloud CLI.
   Najłatwiej zrobić to z poziomu Cloud Shell. Więcej informacji znajdziesz w dokumentacji Google Cloud.

2. Jeśli pojawi się monit, postępuj zgodnie z instrukcjami wyświetlanymi na terminalu, aby wykonać polecenie gcloud CLI w projekcie Firebase.

   Potrzebujesz identyfikatora projektu Firebase, który znajdziesz u góry strony settings Ustawienia projektu w konsoli Firebase.

3. Włącz wymagane usługi agentów w projekcie, uruchamiając to polecenie:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. Zaczekaj kilka minut, aby upewnić się, że agenci obsługi klienta są dostępni, a następnie ponownie wyślij żądanie multimodalne zawierające adres URL Cloud Storage for Firebase.

Jeśli po kilku minutach nadal widzisz ten błąd, skontaktuj się z zespołem pomocy Firebase.

Jak naprawić błąd 400? API key not valid. Please pass a valid API key.

Jeśli otrzymasz błąd 400 z komunikatemAPI key not valid. Please pass a valid API key., oznacza to zwykle, że klucz API w pliku lub obiekcie konfiguracji Firebase nie istnieje lub nie jest skonfigurowany do użycia z aplikacją lub projektem Firebase.

Sprawdź, czy klucz API podany w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem API Twojej aplikacji. Wszystkie klucze API możesz wyświetlić w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

Jeśli okaże się, że nie są one zgodne, pobierz nowy plik lub obiekt konfiguracji Firebase, a potem zastąp nim ten, który jest w aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz API dla Twojej aplikacji i Twojego projektu Firebase.

Jak naprawić błąd 403? Requests to this API firebasevertexai.googleapis.com ... are blocked.

Jeśli widzisz błąd 403 z wiadomością Requests to this API firebasevertexai.googleapis.com ... are blocked., zwykle oznacza to, że klucz interfejsu API w pliku konfiguracyjnym/obiekcie Firebase nie ma na liście dozwolonych interfejsów API dla usługi, której próbujesz używać.

Upewnij się, że klucz interfejsu API używany przez Twoją aplikację zawiera wszystkie wymagane interfejsy API uwzględnione na liście dozwolonych „ograniczeń interfejsu API” klucza. W przypadku Vertex AI in Firebase klucz interfejsu API musi zawierać co najmniej interfejs API Vertex AI in Firebase na liście dozwolonych.

Wszystkie klucze interfejsu API znajdziesz w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

Jak naprawić błąd 403? PERMISSION_DENIED: The caller does not have permission.

Jeśli otrzymasz błąd 403 z wiadomością PERMISSION_DENIED: The caller does not have permission., oznacza to zwykle, że klucz interfejsu API w pliku lub obiekcie konfiguracji Firebase należy do innego projektu Firebase.

Sprawdź, czy klucz API podany w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem API Twojej aplikacji. Wszystkie klucze API możesz wyświetlić w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

Jeśli okaże się, że nie są one zgodne, pobierz nowy plik lub obiekt konfiguracji Firebase, a potem zastąp nim ten, który jest w aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz API dla Twojej aplikacji i Twojego projektu Firebase.