Najczęstsze pytania i rozwiązywanie problemów

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

Aby używać pakietów SDK Vertex AI in Firebase, musisz włączyć 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:

Otwórz stronę Kompilacja za pomocą Gemini.
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):

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.
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?

Czynność	Wymagane uprawnienia	Role uprawnień, które domyślnie zawierają wymagane uprawnienia
Przejście na abonament Blaze z płatnościami według wykorzystania	`firebase.billingPlans.update` `resourcemanager.projects.createBillingAssignment` `resourcemanager.projects.deleteBillingAssignment`	Właściciel
Włączanie interfejsów API w projekcie	`serviceusage.services.enable`	Edytujący Właściciel
Tworzenie aplikacji Firebase	`firebase.clients.create`	Administrator Firebase Edytujący Właściciel

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

Pakietów SDK Vertex AI in Firebase możesz używać z dowolnym modelem podstawy Gemini wymienionym w informacjach o modelach Gemini.

Nie możesz używać modeli Gemini, które nie są modelami podstawowymi, takich jak modele PaLM, modele zoptymalizowane czy modele oparte na Gemini w pakietach SDK Vertex AI in Firebase.

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

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 naprawić 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.

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.
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 Ustawienia projektu w konsoli Firebase.

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 ''

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 lub obiekcie Firebase nie ma na liście dozwolonych interfejsów API dla usługi, której próbujesz użyć.

Upewnij się, że klucz interfejsu API używany przez Twoją aplikację zawiera wszystkie wymagane interfejsy API uwzględnione na liście dozwolonych interfejsów API w sekcji „Ograniczenia interfejsu API”. 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.