Vertex AI in Firebase の一般提供版を使用するように移行する

Vertex AI in Firebase は 2024 年 10 月 21 日に一般提供（GA）にリリースされました。

Vertex AI in Firebase ライブラリのプレビューバージョン（firebase/vertexai-preview）を使用していた場合は、ライブラリの一般提供バージョン（firebase/vertexai）を使用するようにアップグレードするために、次の変更を行う必要があります。

移行に必要な変更の大まかなリストは次のとおりです。

Firebase プロジェクトで新しい必須 API を有効にする （すべてのユーザーに必須）
ライブラリの一般提供版に更新する （全ユーザーに必須）
その他の変更 （使用する機能に応じて必要）

Firebase プロジェクトで新しい必須 API を有効にする（すべてのユーザーに必須）

Firebase プロジェクトで Vertex AI in Firebase API を有効にして、Firebase API キーの許可リストに追加する必要があります。これは、Vertex AI in Firebase の一般提供版を使用する際に必要な新しい API です。

Firebase コンソールで、[Gemini を使用した構築] ページに移動します。
[Vertex AI in Firebase] カードで [使ってみる] をクリックして、この API を有効にして Firebase API キーの許可リストに追加するワークフローを開始します。
コンソールで残りのワークフローをスキップできます。

ライブラリの一般提供版に更新する（全ユーザー必須）

ライブラリの GA バージョンを使用するようにアプリのコードを更新する手順は次のとおりです。

npm を使用して Firebase JS SDK for Web の最新バージョンを取得します。
```
npm i firebase@latest
```
または
```
yarn add firebase@latest
```

ライブラリをインポートした場所で、インポートステートメントを更新して firebase/vertexai を使用します。

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

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

その他の変更（使用する機能に応じて必要）

SDK の一般提供版には、いくつかの変更が実装されています。次のリストを参照して、アプリで GA バージョンの SDK の使用に対応するためにコードに変更を加える必要のある点を確認します。

関数呼び出し
一般提供前にこの機能を実装した場合は、スキーマの定義方法を更新する必要があります。関数宣言の作成方法については、更新された関数呼び出しガイドをご覧ください。
responseSchema を使用して構造化出力（JSON など）を生成する
一般提供前にこの機能を実装した場合は、スキーマの定義方法を更新する必要があります。JSON スキーマの作成方法については、新しい構造化出力ガイドをご覧ください。
タイムアウト
- リクエストのデフォルトのタイムアウトを 180 秒に変更しました。

列挙型
- HarmCategory、BlockThreshold、HarmProbability、HarmSeverity、BlockReason、FinishReason の各列挙型から値を削除しました。
ブロックの理由
- PromptFeedback の blockReason を省略可能に変更しました。

移行に関連する可能性のあるエラー

Vertex AI in Firebase の一般提供版を使用するように移行する際、この移行ガイドに記載されている必要な変更をすべて完了していないと、エラーが発生することがあります。

403 エラー: `Requests to this API firebasevertexai.googleapis.com ... are blocked.`

Requests to this API firebasevertexai.googleapis.com ... are blocked. という 403 エラーが表示される場合は、通常、Firebase 構成ファイル/オブジェクトの API キーに、使用しようとしているプロダクトの許可リストに必要な API が含まれていないことを意味します。

アプリで使用している API キーに、キーの「API の制限」許可リストに必要な API がすべて含まれていることを確認します。Vertex AI in Firebase の場合、API キーの許可リストに少なくとも Vertex AI in Firebase API が含まれている必要があります。この API は、Firebase コンソールから新しい API を有効にしたときに、API キーの許可リストに自動的に追加されているはずです。

すべての API キーは、Google Cloud コンソールの [API とサービス] > [認証情報] パネルで確認できます。