Najczęstsze pytania i rozwiązywanie problemów


Na tej stronie znajdziesz odpowiedzi na najczęstsze pytania i informacje dotyczące rozwiązywania problemów z pakietami SDK Gemini APIVertex AI in Firebase. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących Gemini API w dokumentacji Google Cloud.

Aby używać pakietów SDK Vertex AI in Firebase, musisz włączyć w projekcie te 2 interfejsy API:

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

  1. Otwórz stronę Kompilacja za pomocą Gemini.

  2. Kliknij kartę Vertex AI in Firebase, aby uruchomić przepływ pracy, który umożliwia użycie tych 2 interfejsów 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.

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

  • Z pakietami SDK Vertex AI in Firebase możesz używać dowolnych modeli fundamentu GeminiImagen 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 spoza pakietu Foundation (np. modeli PaLM, modeli dostrojonych czy modeli opartych na Gemma) z pakietami SDK Vertex AI in Firebase.

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

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 Vertex AI Gemini API, 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.

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 edytować limit.

Rozwiązywanie problemów

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 Google Clouddokumentacji.

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

Jeśli otrzymasz błąd 400 z komunikatemAPI key not valid. Please pass a valid API key., oznacza to zwykle, że klucz interfejsu 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.

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 interfejsów API w sekcji „Ograniczenia 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.

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.


Prześlij opinię na temat korzystania z usługi Vertex AI in Firebase