Переход на Firebase AI Logic SDKs с предварительной версии Vertex AI in Firebase SDKs

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Быстрый

1. В Xcode, открыв проект приложения, обновите пакет Firebase до версии 11.13.0 или более поздней, используя один из следующих вариантов:

   • Вариант 1 : Обновить все пакеты: Перейдите в Файл > Пакеты > Обновить до последних версий пакетов .

   • Вариант 2 : Обновите Firebase по отдельности: Перейдите к пакету Firebase в разделе Package Dependencies . Щелкните правой кнопкой мыши по пакету Firebase, а затем выберите Update Package .

2. Убедитесь, что пакет Firebase теперь показывает v11.13.0 или более позднюю версию. Если это не так, проверьте, что указанные вами требования к пакету позволяют обновиться до v11.13.0 или более поздней версии.

3. Выберите цель вашего приложения в редакторе проектов, а затем перейдите в раздел «Фреймворки, библиотеки и встроенный контент» .

4. Добавьте новую библиотеку: нажмите кнопку + , а затем добавьте FirebaseAI из пакета Firebase.

5. После завершения миграции приложения (см. оставшиеся разделы этого руководства) обязательно удалите старую библиотеку:
   Выберите FirebaseVertexAI-Preview , а затем нажмите кнопку — .

Kotlin

1. В файле Gradle вашего модуля (уровня приложения) (об��чно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) замените старые зависимости (если применимо) следующими.

   Обратите внимание, что перед удалением старой зависимости может быть проще перенести кодовую базу вашего приложения (см. оставшиеся разделы этого руководства).

   // 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.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Синхронизируйте свой проект Android с файлами Gradle.

Обратите внимание: если вы решили не использовать Firebase Android BoM , просто добавьте зависимость для библиотеки firebase-ai и примите последнюю версию, предложенную Android Studio.

Java

1. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) замените старые зависимости (если применимо) следующими.

   Обратите внимание, что перед удалением старой зависимости может быть проще перенести кодовую базу вашего приложения (см. оставшиеся разделы этого руководства).

   // 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.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Синхронизируйте свой проект Android с файлами Gradle.

Обратите внимание: если вы решили не использовать Firebase Android BoM , просто добавьте зависимость для библиотеки firebase-ai и примите последнюю версию, предложенную Android Studio.

Web

1. Получите последнюю версию Firebase JS SDK для Web с помощью npm:

   npm i firebase@latest

   ИЛИ

   yarn add firebase@latest

2. Везде, где вы импортировали библиотеку, обновите операторы импорта, чтобы вместо этого использовать firebase/ai .

   Обратите внимание, что перед удалением старых импортов может быть проще перенести кодовую базу вашего приложения (см. оставшиеся разделы этого руководства).

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Обновите файл pubspec.yaml , чтобы использовать пакет firebase_ai , выполнив следующую команду из каталога проекта Flutter:

   flutter pub add firebase_ai

2. Перестройте свой проект Flutter:

   flutter run

3. После завершения миграции приложения (см. оставшиеся разделы этого руководства) обязательно удалите старый пакет:

   flutter pub remove firebase_vertexai

Единство

Поддержка Unity не была доступна в « Vertex AI in Firebase ».

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

import FirebaseAI

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")

Kotlin

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.0-flash")

Java

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.0-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-flash" });

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.0-flash');

Единство

Поддержка Unity не была доступна в « Vertex AI in Firebase ».

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .

Быстрый

• Перечисления

  • Заменено большинство типов enum на struct со статическими переменными. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом виде. При использовании операторов switch теперь необходимо включать случай default: для охвата неизвестных или необработанных значений, включая новые значения, которые будут добавлены в SDK в будущем.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold ; теперь этот тип является struct .

  • Удалены unknown и unspecified случаи из следующих перечислений (теперь struct ): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason и FinishReason .

  • Заменил перечисление ModelContent.Part протоколом с именем Part , чтобы разрешить добавление новых типов обратно совместимым способом. Это изменение более подробно описано в разделе Части контента .

• Части контента

  • Удален протокол ThrowingPartsRepresentable и упрощены инициализаторы для ModelContent , чтобы избежать случайных ошибок компилятора. Изображения, которые не кодируются должным образом, все равно будут ��ыдавать ошибки при использовании в generateContent .

  • Заменены случаи ModelContent.Part следующими struct типами, соответствующими протоколу Part :

    • .text в TextPart
    • .data в InlineDataPart
    • .fileData в FileDataPart
    • .functionCall в FunctionCallPart
    • .functionResponse на FunctionResponsePart

• Категория вреда

  • Изменено HarmCategory , чтобы больше не быть вложенным в тип SafetySetting . Если вы ссылаетесь на него как на SafetySetting.HarmCategory , это можно заменить на HarmCategory .

• Обратная связь по безопасности

  • Удален тип SafetyFeedback , так как он не использовался ни в одном из ответов.

• Метаданные цитирования

  • Свойство citationSources в CitationMetadata переименовано в citations .

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Ответ кандидата

  • CandidateResponse переименован в Candidate для соответствия другим платформам.

• Конфигурация генерации

  • Изменил публичные свойства GenerationConfig на internal . Все они остаются настраиваемыми в инициализаторе.

Kotlin

• Перечисления

  • Заменены enum классы и sealed классы на обычные классы. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом режиме.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold .

  • Удалены значения из следующих перечислений: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Методы Blob

  • Переименованы все методы, включающие Blob в свое имя, чтобы вместо этого использовать InlineData .

• Настройки безопасности

  • method поля изменен так, чтобы он допускал значение NULL.

• Продолжительность класса

  • Удалены все использования класса Duration из Kotlin и заменены на long . Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Обернул все поля, ранее объявленные в CitationMetadata , в новый класс под названием Citation . Ссылки можно найти в списке под названием citations в CitationMetadata . Это изменение позволяет лучше согласовывать типы на разных платформах.

• Подсчет жетонов

  • Поле totalBillableCharacters изменено на допускающее значение NULL.

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Создание модели

  • Параметр requestOptions перенесен в конец списка параметров для соответствия другим платформам.

• Live API

  • Удалено значение UNSPECIFIED для класса enum ResponseModality . Вместо этого используйте null .

  • LiveGenerationConfig.setResponseModalities переименован в LiveGenerationConfig.setResponseModality .

  • Удален класс LiveContentResponse.Status , и вместо этого вложены поля статуса как свойства LiveContentResponse .

  • Удален класс LiveContentResponse и вместо него предостав��ены подклассы LiveServerMessage , которые соответствуют ответам модели.

  • Изменен LiveModelFutures.connect для возврата ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession> .

Java

• Перечисления

  • Заменены enum классы и sealed классы на обычные классы. Это изменение обеспечивает большую гибкость для развития API в обратно совместимом режиме.

  • Перечисление BlockThreshold переименовано в HarmBlockThreshold .

  • Удалены значения из следующих перечислений: HarmBlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Методы Blob

  • Переименованы все методы, включающие Blob в свое имя, чтобы вместо этого использовать InlineData .

• Настройки безопасности

  • method поля изменен так, чтобы он допускал значение NULL.

• Продолжительность класса

  • Удалены все использования класса Duration из Kotlin и заменены на long . Это изменение обеспечивает лучшую совместимость с Java.

• Метаданные цитирования

  • Обернул все поля, ранее объявленные в CitationMetadata , в новый класс под названием Citation . Ссылки можно найти в списке под названием citations в CitationMetadata . Это изменение позволяет лучше согласовывать типы на разных платформах.

• Подсчет жетонов

  • Поле totalBillableCharacters изменено на допускающее значение NULL.

• Всего оплачиваемых символов

  • Свойство totalBillableCharacters в CountTokensResponse изменено на необязательное для отражения ситуаций, когда символы не отправляются.

• Создание модели

  • Параметр requestOptions перенесен в конец списка параметров для соответствия другим платформам.

• Live API

  • Удалено значение UNSPECIFIED для класса enum ResponseModality . Вместо этого используйте null .

  • LiveGenerationConfig.setResponseModalities переименован в LiveGenerationConfig.setResponseModality .

  • Удален класс LiveContentResponse.Status , и вместо этого вложены поля статуса как свойства LiveContentResponse .

  • Удален класс LiveContentResponse и вместо него предоставлены подклассы LiveServerMessage , которые соответствуют ответам модели.

  • Изменен LiveModelFutures.connect для возврата ListenableFuture<LiveSessionFutures> вместо ListenableFuture<LiveSession> .

• Изменены различные методы Java-конструктора, чтобы теперь они правильно возвращали экземпляр своего класса вместо void .

Web

• Перечисления

  • Удалены значения из следующих перечислений: HarmCategory , BlockThreshold , HarmProbability , HarmSeverity , BlockReason и FinishReason .

• Причина блокировки

  • Изменено blockReason в PromptFeedback на необязательное.

Изменения требуются только в том случае, если вы начинаете использовать Gemini Developer API (вместо Vertex AI Gemini API ):

• Настройки безопасности

  • Удалены случаи использования неподдерживаемого метода SafetySetting.method .

• Встроенные данные

  • Удалены случаи использования неподдерживаемого InlineDataPart.videoMetadata .

Dart

• Перечисления

  • Удалены значения из следующих перечислений: HarmCategory , HarmProbability , BlockReason и FinishReason .

• Часть данных

  • DataPart переименован в InlineDataPart , а функция static data — в inlineData для соответствия другим платформам.

• Запросить варианты

  • Удален RequestOptions , поскольку timeout не работал. Он будет добавлен снова в ближайшем будущем, но будет перемещен в тип GenerativeModel для соответствия другим платформам.

• Остановочные последовательности

  • Параметр stopSequences в GenerationConfig изменен на необязательный и по умолчанию имеет значение null вместо пустого массива.

• Цитаты

  • Свойство citationSources переименовано в citations в CitationMetadata . Тип CitationSource переименован в Citation для соответствия другим платформам.

• Ненужные публичные типы, методы и свойства

  • Удалены следующие типы, методы и свойства, которые были непреднамеренно раскрыты: defaultTimeout , CountTokensResponseFields , parseCountTokensResponse , parseEmbedContentResponse , parseGenerateContentResponse , parseContent , BatchEmbedContentsResponse , ContentEmbedding , EmbedContentRequest и EmbedContentResponse .

• Подсчет жетонов

  • Удалены дополнительные поля из функции countTokens , которые больше не нужны. Необходимо только contents .

• Создание модели

  • Параметр systemInstruction перенесен в конец списка параметров для соответствия другим платформам.

• Встраиваем��я функциональность

  • Из модели удалены неподдерживаемые функции встраивания ( embedContent и batchEmbedContents ).

Единство

Поддержка Unity не была доступна в « Vertex AI in Firebase ».

Узнайте, как начать работу с Firebase AI Logic SDK для Unity .