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 w poziomie podglądu biblioteki Vertex AI in Firebase (FirebaseVertexAI-Preview), musisz wprowadzić te zmiany, aby przejść na wersję GA biblioteki (FirebaseVertexAI).

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ć kod aplikacji, aby używała wersji ogólnodostępnej biblioteki:

  1. Po otwarciu projektu aplikacji w Xcode zaktualizuj Pakiet Firebase do wersji 11.4.0 lub nowszej, korzystając z jednej z tych opcji:

    • Opcja 1: zaktualizuj wszystkie pakiety: kliknij kolejno Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów.

    • Opcja 2. Aktualizuj Firebase osobno: przejdź do pakietu Firebase w sekcji Zależności pakietu. Kliknij prawym przyciskiem myszy pakiet Firebase, a następnie wybierz Zaktualizuj pakiet.

  2. Upewnij się, że pakiet Firebase ma teraz wersję 11.4.0 lub nowszą. Jeśli nie, sprawdź, czy określone wymagania dotyczące pakietu umożliwiają aktualizację do wersji 11.6.0 lub nowszej.

  3. W Edytorze projektu wybierz docelowe urządzenie aplikacji, a potem przejdź do sekcji Frameworki, biblioteki i osadzone treści.

  4. Kliknij przycisk +, a potem dodaj FirebaseVertexAI z pakietu Firebase.

  5. Wybierz FirebaseVertexAI-Preview i kliknij —.

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

Wprowadziliśmy kilka zmian w wersjach GA pakietów SDK. Sprawdź poniższe listy, aby dowiedzieć się, jakie zmiany możesz wprowadzić w kodzie, aby korzystać z wersji GA pakietu SDK w swojej aplikacji.

  • 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 większość typów enum zmiennymi struct z wartościami statycznymi. Ta zmiana zapewnia większą elastyczność w rozwijaniu interfejsu API w sposób zgodny z wstecz. Jeśli używasz instrukcji switch, musisz uwzględnić przypadek default:, aby uwzględnić nieznane lub nieobsługiwane wartości, w tym nowe wartości dodane do SDK w przyszłości.

    • Nazwa zbioru BlockThreshold została zmieniona na HarmBlockThreshold. Ten typ jest teraz typem struct.

    • Usunięto przypadki unknown i unspecified z tych zbiorów (teraz struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason i FinishReason.

    • Wymiana enumeracji ModelContent.Part na protokół o nazwie Part, aby umożliwić dodawanie nowych typów w sposób zgodny z wstecz. Ta zmiana jest opisana bardziej szczegółowo w sekcji Elementy treści.

  • Elementy treści

    • Usunięto protokół ThrowingPartsRepresentable i uproszczono inicjalizatory dla ModelContent, aby uniknąć sporadycznych błędów kompilatora. Obrazy, które nie są prawidłowo kodowane, będą nadal generować błędy podczas używania w generateContent.

    • Zgodnie z protokołem Part zastąpiono przypadki ModelContent.Part tymi typami struct:

      • .text do TextPart
      • .data do InlineDataPart
      • .fileData do FileDataPart
      • .functionCall do FunctionCallPart
      • .functionResponse do FunctionResponsePart

  • Kategoria szkody

    • Element HarmCategory nie jest już zagnieżdżony w typie SafetySetting. Jeśli używasz nazwy SafetySetting.HarmCategory, możesz ją zastąpić tagiem HarmCategory.

  • Informacje dotyczące bezpieczeństwa

    • Usunięto typ SafetyFeedback, ponieważ nie był używany w żadnej z odpowiedzi.

  • Metadane cytowania

    • Nazwa właściwości citationSources została zmieniona na citations w pliku CitationMetadata.

  • Łą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.

  • Odpowiedź kandydata

    • Zmieniliśmy nazwę CandidateResponse na Candidate, aby była zgodna z innymi platformami.

  • Konfiguracja generowania

    • Zmieniono publiczne właściwości z GenerationConfig na internal. Wszystkie te parametry pozostają konfigurowalne w inicjalizowanym obiekcie.

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 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 mieć na liście dozwolonych co najmniej interfejs API Vertex AI in Firebase. 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.