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


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

Если вы использовали предварительную версию Vertex AI in Firebase ( FirebaseVertexAI-Preview ), вам необходимо внести следующие изменения для обновления, чтобы использовать общедоступную версию библиотеки ( FirebaseVertexAI ).

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

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

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

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

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

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

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

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

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

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

    • Вариант 2. Обновите Firebase индивидуально. Перейдите к пакету Firebase в разделе «Зависимости пакета» . Щелкните правой кнопкой мыши пакет Firebase и выберите «Обновить пакет» .

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

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

  4. Нажмите кнопку + , а затем добавьте FirebaseVertexAI из пакета Firebase.

  5. Выберите FirebaseVertexAI-Preview и нажмите кнопку — .

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

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

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

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

  • Тайм-аут

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

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

    • Заменено большинство типов 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 . Все они остаются настраиваемыми в инициализаторе.

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

При переходе на общедоступную версию Vertex AI in 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 in Firebase ваш ключ API должен иметь как минимум Vertex AI in Firebase API в своем белом списке. Этот API должен был быть автоматически добавлен в белый список вашего ключа API, когда вы включили новый API через консоль Firebase .

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