Выполните миграцию для использования общедоступной версии Vertex AI в Firebase,Перейдите на использование общедоступной версии Vertex AI в Firebase.


Vertex AI в Firebase выпущен в общедоступную версию (GA) 21 октября 2024 г.

Если вы использовали бета-версию Vertex AI в библиотеке Firebase ( firebase-vertexai:16.0.0-betaXX ), вам необходимо внести следующие изменения для обновления, чтобы использовать общедоступную версию библиотеки ( firebase-vertexai:16.0.0 или выше).

Вот общий список изменений, необходимых для миграции:

Включите новый обязательный API в своем проекте Firebase (обязательно для всех).

Вам необходимо включить Vertex AI в Firebase API в своем проекте Firebase и добавить его в белый список вашего ключа Firebase API. Это новый API, который необходим для использования общедоступной версии Vertex AI в Firebase .

  1. В консоли Firebase перейдите на страницу Build with Gemini .

  2. На карточке Vertex AI в Firebase нажмите « Начать» , чтобы запустить рабочий процесс, который поможет вам включить этот API и добавить его в белый список вашего ключа API Firebase.

  3. Вы можете пропустить остальную часть рабочего процесса в консоли.

Обновление до общедоступной версии библиотеки (обязательно для всех)

Следуйте этим инструкциям, чтобы обновить зависимости для использования последней версии Firebase Android BoM . Использование BoM не является обязательным, но мы настоятельно рекомендуем его использовать, поскольку это помогает гарантировать, что ваше приложение использует совместимые версии каждой библиотеки Firebase.

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

    // 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. Синхронизируйте проект Android с файлами Gradle.

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

Дополнительные изменения (требуются в зависимости от используемых вами функций)

Несколько изменений были внесены в общедоступные версии SDK. Просмотрите следующие списки на предмет любых изменений, которые вам может потребоваться внести в свой код, чтобы обеспечить использование общедоступной версии SDK в вашем приложении.

  • Вызов функции
    Если вы реализовали эту функцию до общедоступной версии, вам потребуется внести изменения в определение схемы. Мы рекомендуем просмотреть обновленное руководство по вызову функций , чтобы узнать, как писать объявления функций.

  • Генерация структурированного вывода (например, JSON) с использованием responseSchema
    Если вы реализовали эту функцию до общедоступной версии, вам потребуется внести изменения в определение схемы. Мы рекомендуем просмотреть новое руководство по структурированному выводу , чтобы научиться писать схемы JSON.

  • Тайм-аут

    • Изменено время ожидания по умолчанию для запросов, теперь оно составляет 180 секунд.
  • Перечисления

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

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

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

  • Методы BLOB-объектов

    • Все методы, в имена которых входили Blob , переименованы, чтобы вместо них использовать InlineData .
  • Настройки безопасности

    • Изменен method поля, чтобы он мог иметь значение NULL.
  • Класс продолжительности

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

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

    • Поле totalBillableCharacters изменено на обнуляемое.
  • Всего оплачиваемых персонажей

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

    • Параметр requestOptions перемещён в конец списка параметров, чтобы соответствовать другим платформам.

Возможные ошибки, связанные с миграцией

При переходе на общедоступную версию Vertex AI в Firebase вы можете столкнуться с ошибками, если не внесли все необходимые изменения, как описано в этом руководстве по миграции.

Ошибка 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Если вы получили сообщение об ошибке 403, в котором говорится, что Requests to this API firebasevertexai.googleapis.com ... are blocked. , это обычно означает, что ключ API в вашем файле/объекте конфигурации Firebase не имеет необходимого API в белом списке для продукта, который вы пытаетесь использовать.

Убедитесь, что ключ API, используемый вашим приложением, содержит все необходимые API, включенные в список разрешений «Ограничения API» ключа . Для Vertex AI в Firebase ваш ключ API должен иметь как минимум Vertex AI в Firebase API в своем белом списке. Этот API должен был быть автоматически добавлен в белый список вашего ключа API, когда вы включили новый API через консоль Firebase .

Вы можете просмотреть все свои ключи API на панели «API и сервисы» > «Учетные данные» в консоли Google Cloud .