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

Atlas 埋め込みと再ランク付けAPIを使用するようにアプリケーションを移行する

既存のVoyage AIユーザーの場合は、次の手順を完了して、 Atlas 埋め込みと再ランクAPI を使用するようにアプリケーションを移行します。

1

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

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

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

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

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

  4. APIキーが有効であることを確認するには、埋め込みと保証APIにテストリクエストを送信します。

    curl \ --request POST 'https://ai.mongodb.com/v1/embeddings' \ --header "Authorization: Bearer $VOYAGE_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "input": "Sample text", "model": "voyage-4-lite", "input_type": "document" }'

APIキーの作成と管理について学ぶには、「Voyage AIモデルAPIキーを管理する。」を参照してください。

3

例、 APIキーを環境変数として設定する場合は、値を更新します。

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

コード内でAPIキーを直接渡す場合は、クライアントを初期化する場所またはAPIリクエストを行う場所で の値を更新します。

注意

APIキーを環境変数として設定している場合は、次のコマンドを実行して変数が設定されていることを確認できます。

echo $VOYAGE_API_KEY
4

アプリケーションでAPIエンドポイントが明示的に指定されている場合は、同等の埋め込み API エンドポイントと Reranking API ポイントを使用するようにアップデートします。

古いエンドポイントとなる接続されたデバイス
新しいエンドポイントとなる接続されたデバイス

https://api.voyageai.com/v1/embeddings

https://ai.mongodb.com/v1/embeddings

https://api.voyageai.com/v1/rerank

https://ai.mongodb.com/v1/rerank

https://api.voyageai.com/v1/multimodalembeddings

https://ai.mongodb.com/v1/multimodalembeddings

https://api.voyageai.com/v1/contextualizedembeddings

https://ai.mongodb.com/v1/contextualizedembeddings

注意

voyageai Pythonクライアント(バージョン 0.3.7 以降)を使用すると、クライアントはAPIキー形式に基づいてリクエストを正しいエンドポイントとなる接続されたデバイスに自動的にルーティングします。base_url パラメータを明示的に設定せずにクライアントを使用する場合は、エンドポイントの変更は必要ありません。

詳細については、 Pythonクライアント を参照してください。

5

アプリケーションをテストして、埋め込みが正しく生成され、埋め込みと再ランクAPIを使用して再ランク操作が実行されることを確認します。

6

アプリケーションがモデルAPIキーで動作することを確認したら、不正アクセスを防ぐために、Vyage AIプラットフォームから古いAPIキーを削除します。

このページを評価

項目一覧

ドキュメンテーション