AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

Voyage AIクイック スタート

このガイドでは、Voyage AIを使用して最初のベクトル埋め込みを生成し、 基本的なアプリケーションを構築する 方法を学習します。

Voyage AIモデルにアクセスするには、 MongoDB Atlas UIでモデルAPIキーを作成します。

1

Atlas を初めて使用する場合、組織とプロジェクトが作成されます。

詳細については、「 Atlas アカウントの作成 」を参照してください。

2
  1. Atlasプロジェクトで、ナビゲーション バーから AI Model APIs を選択します。

  2. [Create model API key] をクリックします。

  3. APIキーに名前を指定し、[Create] をクリックします。

詳細について学ぶには、Voyage AI モデル API キーを管理するを参照してください。

3

APIキーをコピーし、安全なロケーションに保存します。次に、VyageクライアントがアクセスできるようにAPIキーを環境変数としてターミナルにエクスポートします。

export VOYAGE_API_KEY="<your-model-api-key>"

このセクションでは、Voyage AI埋め込みモデルとPythonクライアントを使用してベクトル埋め込みを生成します。

Voyage AI埋め込み図
クリックして拡大します
1

ターミナルで次のコマンドを実行してプロジェクトを作成し、Voyage AI Pythonクライアント をインストールします。

mkdir mongodb-voyage-quickstart
cd mongodb-voyage-quickstart
pip install --upgrade voyageai
2

プロジェクトに quickstart.py という名前のファイルを作成し、次のコードをそのファイルに貼り付けます。このコードは、 Voyage AIクライアントを初期化し、サンプルテキストを定義し、クライアントを使用して Voyage APIにアクセスし、voyage-4-large モデルのベクトル埋め込みを生成します。

詳細については、 Pythonクライアントを参照するか、完全なAPI仕様を調べてください。

import voyageai
# Initialize Voyage client
vo = voyageai.Client()
# Sample texts
texts = [
"hello, world",
"welcome to voyage ai!"
]
# Generate embeddings
result = vo.embed(
texts,
model="voyage-4-large"
)
print(f"Generated {len(result.embeddings)} embeddings")
print(f"Each embedding has {len(result.embeddings[0])} dimensions")
print(f"First embedding (truncated): {result.embeddings[0][:5]}...")
3

埋め込みを生成するには、ターミナルで次のコマンドを実行します。

python quickstart.py
Generated 2 embeddings
Each embedding has 1024 dimensions
First embedding (truncated): [0.05843968689441681, -0.035438042134046555, -0.059422507882118225, -0.018386829644441605, -0.04523468762636185]...

ベクトル埋め込みを生成する方法がわかったので、基本的なRAGアプリケーションを構築して、Voyage AIモデルを使用してAI検索と取得を実装する方法を学びます。RAG を使用すると、応答を生成する前にデータから関連情報を取得することで、LDM がコンテキストに対応した応答を生成できるようになります。

注意

RAG アプリケーションは LLM へのアクセスが必要です。このチュートリアルでは、Anthropic または OpenAI を使用する例を提供しますが、お好みの任意の LLM プロバイダーを使用できます。

基本 Voyage AI RAG の図
クリックして拡大します

Voyage AIを使用して最初のアプリケーションを作成したので、次のセクションを展開して、このクイック スタートで説明されている概念の詳細を学習してください。

学習を続けるには、次のリソースを参照してください。