Vertex AI в Firebase выпущен в общедоступную версию (GA) 21 октября 2024 г.
Если вы использовали бета-версию Vertex AI в библиотеке Firebase ( firebase-vertexai:16.0.0-betaXX
), вам необходимо внести следующие изменения для обновления, чтобы использовать общедоступную версию библиотеки ( firebase-vertexai:16.0.0
или выше).
Вот общий список изменений, необходимых для миграции:
- Включите новый обязательный API в своем проекте Firebase (обязательно для всех).
- Обновление до общедоступной версии библиотеки (обязательно для всех)
- Дополнительные изменения (требуются в зависимости от используемых вами функций)
Включите новый обязательный API в своем проекте Firebase (обязательно для всех).
Вам необходимо включить Vertex AI в Firebase API в своем проекте Firebase и добавить его в белый список вашего ключа Firebase API. Это новый API, который необходим для использования общедоступной версии Vertex AI в Firebase .
В консоли Firebase перейдите на страницу Build with Gemini .
На карточке Vertex AI в Firebase нажмите « Начать» , чтобы запустить рабочий процесс, который поможет вам включить этот API и добавить его в белый список вашего ключа API Firebase.
Вы можете пропустить остальную часть рабочего процесса в консоли.
Обновление до общедоступной версии библиотеки (обязательно для всех)
Следуйте этим инструкциям, чтобы обновить зависимости для использования последней версии Firebase Android BoM . Использование BoM не является обязательным, но мы настоятельно рекомендуем его использовать, поскольку это помогает гарантировать, что ваше приложение использует совместимые версии каждой библиотеки Firebase.
В файле 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") }Синхронизируйте проект 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 .