Przejdź na wersję GA Vertex AI w Firebase


Vertex AI in Firebase została udostępniona wszystkim użytkownikom 21 października 2024 r.

Jeśli korzystasz z wersji beta biblioteki Vertex AI in Firebase (firebase-vertexai:16.0.0-betaXX), musisz wprowadzić te zmiany, aby przejść na wersję GA biblioteki (firebase-vertexai:16.0.0 lub nowszą).

Oto ogólna lista zmian wymaganych do przeprowadzenia migracji:

Włącz nowy wymagany interfejs API w projekcie Firebase (wymagane dla wszystkich).

W projekcie Firebase musisz włączyć interfejs Vertex AI in Firebase API i dodać go do listy dozwolonych kluczy interfejsu Firebase API. Jest to nowy interfejs API wymagany do korzystania z wersji GA usługi Vertex AI in Firebase.

  1. W konsoli Firebase otwórz stronę Tworzenie za pomocą Gemini.

  2. Na karcie Vertex AI in Firebase kliknij Rozpocznij, aby uruchomić przepływ pracy, który pomoże Ci włączyć ten interfejs API i dodać go do listy dozwolonych kluczy interfejsu API Firebase.

  3. W konsoli możesz pominąć pozostałą część procesu.

Zaktualizuj bibliotekę do wersji GA (wymagane dla wszystkich)

Aby zaktualizować zależności, aby używać najnowszej wersji Firebase Android BoM, wykonaj te instrukcje. Korzystanie z BoM nie jest wymagane, ale zdecydowanie zalecamy to, ponieważ pomaga to zapewnić, że aplikacja używa zgodnych wersji każdej biblioteki Firebase.

  1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle)) zastąp zależność Vertex AI in Firebase tym:

    // BEFORE
dependencies {
  implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
}

// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.10.0"))

  // Add the dependency for the Vertex AI in Firebase library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-vertexai")
}

  2. Synchronizuj projekt Androida z plikami Gradle.

Jeśli nie chcesz używać Firebase BoM, po prostu zaakceptuj najnowszą wersję firebase-vertexai sugerowaną przez Android Studio.

Dodatkowe zmiany (wymagane w zależności od używanych funkcji)

W wersjach pakietów SDK dla Google Analytics wprowadziliśmy kilka zmian. Sprawdź poniższe listy, aby dowiedzieć się, jakie zmiany możesz wprowadzić w kodzie, aby uwzględnić w aplikacji wersję GA pakietu SDK.

  • Wywołania funkcji
    Jeśli ta funkcja została zaimplementowana przed GA, musisz zaktualizować sposób definiowania schematu. Aby dowiedzieć się, jak pisać deklaracje funkcji, przeczytaj zaktualizowany przewodnik po wywoływaniu funkcji.

  • Generowanie uporządkowanego wyjścia (np. w formacie JSON) za pomocą funkcji responseSchema
    Jeśli wdrożyłeś tę funkcję przed udostępnieniem wersji GA, musisz zaktualizować sposób definiowania schematu. Aby dowiedzieć się, jak pisać schematy JSON, zapoznaj się z nowym przewodnikiem dotyczącym danych wyjściowych w formacie uporządkowanym.

  • Limit czasu

    • Zmieniono domyślny limit czasu żądań na 180 sekund.

  • Wyliczenia

    • Zastąpiono zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana daje większą elastyczność w rozwijaniu interfejsu API w sposób zgodny z wstecz.

    • Nazwa zbioru BlockThreshold została zmieniona na HarmBlockThreshold.

    • Usunięto wartości z tych typów danych: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

  • Metody obiektów blob

    • W nazwach wszystkich metod, w których nazwie występuje znak Blob, zastąpiliśmy go znakiem InlineData.

  • Ustawienia bezpieczeństwa

    • Zmieniono pole method tak, aby mogło być puste.

  • Klasa czasu trwania

    • Usunięto wszystkie przypadki użycia klasy Duration w Kotlinie i zastąpiono ją klasą long. Ta zmiana zapewnia lepszą współpracę z językiem Java.

  • Metadane cytowania

    • Wszystkie pola zadeklarowane wcześniej w CitationMetadata zostały umieszczone w nowej klasie o nazwie Citation. Odwołania znajdziesz na liście citations w sekcji CitationMetadata. Ta zmiana umożliwia lepsze dopasowanie typów na różnych platformach.

  • Liczba tokenów

    • Zmieniono pole totalBillableCharacters tak, aby mogło być puste.

  • Łączna liczba znaków podlegających rozliczeniu

    • Właściwość totalBillableCharacters w elementach CountTokensResponse została zmieniona na opcjonalną, aby uwzględnić sytuacje, w których nie są wysyłane żadne znaki.

  • Tworzenie wystąpienia modelu

    • Parametr requestOptions został przeniesiony na koniec listy parametrów, aby dostosować go do innych platform.

Możliwe błędy związane z migracją

Podczas migracji do wersji GA usługi Vertex AI in Firebase możesz napotkać błędy, jeśli nie wprowadzisz wszystkich wymaganych zmian opisanych w tym przewodniku.

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 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. Ten interfejs API powinien zostać automatycznie dodany do listy dozwolonych kluczy API, gdy włączysz nowy interfejs API w konsoli Firebase.

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