Vertex AI in Firebase SDK の一般提供版から Firebase AI Logic SDK に移行する


Firebase AI Logic とそのクライアント SDK は、以前は「Vertex AI in Firebase」と呼ばれていました。拡張されたサービスと機能(Gemini Developer API のサポートなど)をより適切に反映するため、サービスの名前を変更して Firebase AI Logic に再パッケージ化しました。

モバイルアプリやウェブアプリから Google の生成 AI モデルに直接安全にアクセスするには、Gemini API」プロバイダ(長い間利用可能な Vertex AI Gemini API または新しい Gemini Developer API)を選択できるようになりました。これにより、Gemini Developer API を使用できるようになりました。Gemini Developer API は、妥当なレートの上限と割り当てを備えた無料の階層を提供します。

Firebase AI Logic SDK に移行する手順の概要

  • ステップ 1: アプリとユースケースに最適な「Gemini API」プロバイダを選択します。

  • ステップ 2: Gemini Developer API を使用できるように Firebase プロジェクトを設定する
    Vertex AI Gemini API の代わりに Gemini Developer API を使用するようにスワップする場合のみ適用されます。

  • ステップ 3: アプリで使用しているライブラリを更新します。

  • ステップ 4: アプリの初期化を更新します。

  • ステップ 5: 使用する機能に応じてコードを更新します。

ステップ 1: アプリに最適な「Gemini API」プロバイダを選択する

この移行では、「Gemini API」プロバイダを選択できます。

  • 古い「Vertex AI in Firebase」SDK では、Vertex AI Gemini API のみを使用できました。

  • 新しい Firebase AI Logic SDK では、モバイルアプリまたはウェブアプリから直接呼び出す「Gemini API」プロバイダ(Gemini Developer API または Vertex AI Gemini API)を選択できます。

2 つの Gemini API プロバイダの使用の違いを確認します。特に、サポートされている機能、料金、レート制限の点に注意してください。たとえば、Gemini Developer APICloud Storage URL を使用したファイルの提供をサポートしていませんが、無料の階層と合理的な割り当てを利用したい場合は、Gemini Developer API が適切な選択肢になる可能性があります。

ステップ 2: Gemini Developer API を使用できるように Firebase プロジェクトを設定する

この手順は、Firebase AI Logic クライアント SDK で Gemini Developer API を使用するように切り替える場合にのみ必要です。ただし、Vertex AI Gemini API を引き続き使用する場合は、次のステップに進みます。

プロジェクトで両方の「Gemini API」プロバイダを同時に有効にすることは問題ありません。

  1. Firebase コンソールで、[Firebase AI Logic] ページに移動します。

  2. [設定] タブに移動し、[Gemini Developer API] を選択します。

  3. Gemini Developer API を有効にします。

    コンソールによって、必要な API が有効になり、Firebase プロジェクトに Gemini API キーが生成されます。
    この Gemini API キーをアプリのコードベースに追加しないでください詳細

  4. この移行ガイドに沿って、アプリのライブラリと初期化を更新します。

ステップ 3: アプリで使用しているライブラリを更新する

Firebase AI Logic ライブラリを使用するようにアプリのコードを更新します。

Swift

  1. Xcode でアプリ プロジェクトを開き、次のいずれかのオプションを使用して Firebase パッケージを v11.13.0 以降に更新します。

    • オプション 1: すべてのパッケージを更新する: [ファイル] > [パッケージ] > [最新のパッケージ バージョンに更新] に移動します。

    • オプション 2: Firebase を個別に更新する: [パッケージの依存関係] セクションで Firebase パッケージに移動します。Firebase パッケージを右クリックし、[Update Package] を選択します。

  2. Firebase パッケージが v11.13.0 以降になっていることを確認します。そうでない場合は、指定したパッケージ要件で v11.13.0 以降への更新が許可されていることを確認します。

  3. プロジェクト エディタでアプリのターゲットを選択し、[フレームワーク、ライブラリ、埋め込みコンテンツ] セクションに移動します。

  4. 新しいライブラリを追加します。[+] ボタンを選択し、Firebase パッケージから FirebaseAI を追加します。

  5. アプリの移行が完了したら(このガイドの残りのセクションを参照)、古いライブラリを削除します。
    [FirebaseVertexAI] を選択し、[-] ボタンを押します。

Kotlin

  1. モジュール(アプリレベル)の Gradle ファイル(通常は <project>/<app-module>/build.gradle.kts または <project>/<app-module>/build.gradle)で、古い依存関係(該当する場合)を次のように置き換えます。

    古い依存関係を削除する前に、アプリのコードを移行する(このガイドの残りのセクションを参照)ほうが簡単な場合があります。

    // BEFORE
    dependencies {
      implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // 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(platform("com.google.firebase:firebase-bom:33.x.y"))
      implementation("com.google.firebase:firebase-vertexai")
      // OR if not using the BoM
      implementation("com.google.firebase:firebase-vertexai:16.x.y")
    }
    
    
    // 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. npm を使用して Firebase JS SDK for Web の最新バージョンを取得します。

    npm i firebase@latest

    または

    yarn add firebase@latest
  2. ライブラリをインポートした場所で、代わりに firebase/ai を使用するようにインポート ステートメントを更新します。

    古いインポートを削除する前に、アプリのコードを移行する(このガイドの残りのセクションを参照)ほうが簡単な場合があります。

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

Dart

  1. Flutter プロジェクト ディレクトリで次のコマンドを実行して、pubspec.yaml ファイルで firebase_ai パッケージを使用するように更新します。

    flutter pub add firebase_ai
  2. Flutter プロジェクトを再ビルドします。

    flutter run
  3. アプリの移行が完了したら(このガイドの残りのセクションを参照)、古いパッケージを削除してください。

    flutter pub remove firebase_vertexai

Unity

「Vertex AI in Firebase」では Unity のサポートは利用できません。

Firebase AI Logic SDK for Unity のスタートガイドをご覧ください。

ステップ 4: アプリの初期化を更新する

Gemini API プロバイダをクリックして、このページでプロバイダ固有のコンテンツとコードを表示します。

選択した API プロバイダのサービス初期化方法を更新し、GenerativeModel インスタンスを作成します。