Przejdź na wersję GA Vertex AI w Firebase

iOS+ Android Sieć Flutter

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)
• Przejdź na wersję GA biblioteki (wymagane dla wszystkich)
• Dodatkowe zmiany (wymagane w zależności od używanych funkcji)

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.

Uwaga: interfejs API Vertex AI (aiplatform.googleapis.com) musi być nadal włączony w projekcie (nie powinien jednak znajdować się na liście dozwolonych kluczy interfejsu API).

Zaktualizuj bibliotekę do wersji GA (wymagane dla wszystkich)

iOS+ Android Sieć Flutter

Aby zaktualizować kod aplikacji, aby używała ogólnodostępnej wersji biblioteki:

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

   • 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. Sprawdź, czy 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.9.0 lub nowszej.

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

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

5. Wybierz FirebaseVertexAI-Preview i kliknij —.

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

iOS+ Android Sieć Flutter

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ąpiliśmy 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 ze starszymi wersjami. 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 pakietu 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: HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason i FinishReason.struct

  • Wymiana enumeracji ModelContent.Part na protokół o nazwie Part, aby umożliwić dodawanie nowych typów w sposób zgodny ze starszymi wersjami. 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 zakodowane, 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 elemencie typu 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/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.

Uwaga: interfejsy API związane z Firebase używają kluczy API tylko do identyfikowania projektu lub aplikacji Firebase, a nie do autoryzacji wywołania interfejsu API (jak to umożliwiają niektóre inne interfejsy API). Autoryzacja interfejsów API związanych z Firebase jest obsługiwana niezależnie od klucza interfejsu API, za pomocą uprawnień Google Cloud, Firebase Security Rules lub Firebase App Check. Dowiedz się więcej o kluczach interfejsu API Firebase.