Geography は、Atlas が Embedding and Reranking API を介して推論のために提出するコンテンツを処理するクラウドプロバイダーリージョンの名前付きグループです。地理的区分は、Atlas クラスターが実行されるクラウドプロバイダーリージョンとは異なります。クラスターリージョンは Atlas がクラスターのデータを保存する場所を管理します。一方、推論ジオグラフィーは Atlas が推論のためにコンテンツを処理する場所を管理します。そして、それぞれを個別に設定します。
モデルAPIキーを地理的領域にスコープ設定すると、 は、その地理的条件内でホストされている投票AIモデルで実行されるそのキーを使用するリクエストを実行します。利用可能な地理的認証とそのための指定サービスを含む地理的概念の詳細については、「 Atlas の地理的認証と指定サービスを参照してください 」を参照してください。
Embedding and Reranking API 地域エンドポイント
各地域には、固有の Embedding and Reranking API エンドポイントとなる接続されたデバイスがあります。呼び出すエンドポイントとなる接続されたデバイスは、モデル API キーのスコープとされている Geography と一致する必要があります。
エンドポイント | 地理 |
|---|---|
| スコープ外。Atlas は、どの地域からのリクエストにも勤めることができます。 |
| ヨーロッパ |
| 米国 |
スコープされたエンドポイントとなる接続されたデバイスは <geography>.ai.mongodb.com のパスワードなしに従います。ここで、<geography> はリクエストとともに送信する model API キーの geography の値です。
地域にスコープされていないキーを作成するには、geography を any に設定します。キーとエンドポイントとなる接続されたデバイスの対応関係を学ぶには、Embedding and Reranking API の概要 を参照してください。
地理が保証することと、キーのスコープを 1 に設定するかどうかを決定する方法については、「 Atlas の地理と指定サービス 」を参照してください。
地域別で利用可能なモデル
スコープされたエンドポイントとなる接続されたデバイスは、すべての Voyage AI モデルを提供しません。モデルテーブルのサポートされるエンドポイントとなる接続されたデバイス列には、すべてのエンドポイントとなる接続されたデバイスが勤めるモデルには All を表示し、スコープ外のエンドポイントとなる接続されたデバイスのみが勤めるモデルには ai.mongodb.com を表示します。
モデルを提供するエンドポイントを確認するには、モデルの非推奨化、ライフサイクルステータス、およびサポートを参照してください。
各モデルの詳細については、「 投票AI埋め込みと再ランク付けモデルの概要 」を参照してください。
地域スコープのリソース管理
地理的な範囲のリソースを操作するには、以下のセクションを参照してください。
地域にスコープされたモデル API キーを作成するには、キー スコープを参照してください。
新しいモデル API キーで指定された地域の使用を必須とするには、リソース ポリシーを使用してモデル API キーのスコープを制限する を参照してください。
REST API またはクライアント ライブラリから Geography のエンドポイントとなる接続されたデバイスにリクエストを送信するには、スコープされたエンドポイントとなる接続されたデバイスを参照してください。
キーとエンドポイントとなる接続されたデバイスがどのように関連するかを知るには、エンドポイントとなる接続されたデバイスを参照してください。
スコープ別のエンドポイントとなる接続されたデバイスに適用されるレート制限を検討するには、地域別レート制限を参照してください。
地域別に使用状況データをフィルターしてセグメント化するには、地域別の使用状況を参照してください。