注意
Vertex AI 拡張機能はプレビュー版であり、今後変更される可能性があります。この機能へのアクセス方法については、Google Cloud の担当者にお問い合わせください。
Vertex AI と MongoDB ベクトル検索を使用して RAG を実装するだけでなく、Vertex AI Extensions を使用することで、Vertex AI モデルを Atlas と交流する方法をさらに柔軟にカスタマイズできます。このチュートリアルでは、自然言語を使って Atlas 上のデータをリアルタイムにクエリできるようにする Vertex AI Extension を作成します。

バックグラウンド
このチュートリアルでは、以下のコンポーネントを使用して、Atlas での自然言語によるクエリ実行を可能にします。
Google Cloud Platform Vertex AI SDK を使用して、 AIモデルを管理し、Vertex AIのカスタム拡張機能を有効にします。このチュートリアルでは、GeoMon 1.5 を使用しますPro モデル。
Google Cloud RunVertex AI と Atlas 間の API エンドポイントとして機能する関数をデプロイするために使用します。
自然言語クエリがMongoDB操作にマッピングする方法を定義するMongoDB APIの OpenAPI 3 仕様。詳しくは、 OpenAPI 仕様 を参照してください。
Vertex AI拡張機能 は、Vertex AIから Atlas とのリアルタイムインタラクションを可能にし、自然言語クエリの処理方法を構成します。
Google Cloud Secrets Manager を使用して、MongoDB の API キーを保存します。
注意
詳細なコードやセットアップ手順については、この例の「 GitHub リポジトリ 」を参照してください。
前提条件
始める前に、以下のものを用意してください。
MongoDB Atlasアカウント。サインアップするには、Google Cloud Platform Marketplace を使用するか、新しいアカウントを登録します。
サンプル データセットが読み込まれた Atlas クラスターが必要です。詳細については、「Atlas Infinite または Atlas Core クラスターの作成」を参照してください。
Google Cloud Platformプロジェクト。
プロジェクトで有効になっている API :
クラウド構築API
Cloud Functions API
クラウド ロギングAPI
クラウド Pub/Sub API
Colas Enterprise 環境。
Google Cloud Run 関数を作成する
このセクションでは、Vertex AI Extension と Atlas クラスター間の API エンドポイントとして機能する Google Cloud Run 関数を作成します。この関数は、認証の処理、Atlas クラスターへの接続、および Vertex AI からのリクエストに基づくデータベース操作を行います。
新しい関数を作成します。
Google Cloud Platformコンソールで、Cloud Run ページを開き、Write a function をクリックします。
関数を設定します。
関数を配置する関数名とGoogle Cloud Platformリージョンを指定します。
Runtime として利用可能な最新の Python バージョンを選択してください。
Authentication section で、Allow unauthenticated invocations を選択します。
残りの設定にデフォルト値を使用し、Next をクリックします。
詳細な構成手順については、Cloud Run のドキュメントを参照してください。
Vertex AI 拡張機能を作成する
このセクションでは、Gemini 1.5 Pro モデルを使用して、Atlas 内のデータに対する自然言語クエリを可能にする Vertex AI 拡張機能を作成します。この拡張機能は、OpenAPI 仕様と、作成した Cloud Run 関数を使用して、自然言語をデータベース操作にマッピングし、Atlas のデータをクエリします。
この拡張機能を実装するには、対話式の Python ノートブックを使用します。これにより、Python のコード スニペットを個別に実行することができます。このチュートリアルでは、Colab Enterprise 環境で mongodb-vertex-ai-extension.ipynb という名前のノートブックを作成します。
自然言語クエリの実行
Vertex AIで、左側のナビゲーション メニューにある [Extensions] をクリックします。MongoDB Vertex API Interpreter という名前の新しい拡張機能が拡張機能のリストに表示されます。
次の例では、Atlas 上のデータに対して使用できる 2 種類の自然言語クエリを示しています。

