注意
パブリック プレビュー
ヨーロッパ地理とそのエンドポイントである eu.ai.mongodb.com は、パブリック プレビュー機能として利用できます。機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。
地理的とは、埋め込みと再ランク付けAPIを通じて推論するために送信したコンテンツを Atlas が処理するクラウドプロバイダーリージョンのグループです。地理は、Atlas クラスターが実行されるクラウドプロバイダーのリージョンと同じではありません。クラスター リージョンは、Atlas がクラスターのデータを保存する場所を管理し、推論 Geograph は Atlas が推論でコンテンツを処理する場所を管理し、それぞれを個別に設定します。
モデルAPIキーを地理的領域にスコープ設定すると、 は、その地理的条件内でホストされている投票AIモデルで実行されるそのキーを使用するリクエストを実行します。利用可能な地理的認証とそのための指定サービスを含む地理的概念の詳細については、「 Atlas の地理的認証と指定サービスを参照してください 」を参照してください。
API地理エンドポイントの埋め込みと再ランク付け
各地域には、独自の埋め込みと再ランク付けAPIエンドポイントがあります。呼び出すエンドポイントは、モデルAPIキーのスコープが設定されている地理的条件と一致する必要があります。
エンドポイント | 地理 |
|---|---|
| スコープが設定されていない。 Atlas はどの地域からのリクエストも処理できます。 |
| ヨーロッパ |
| 米国 |
スコープ付きエンドポイントはパターン <geography>.ai.mongodb.com に従います。ここでは、<geography> はリクエストで送信したモデルAPIキーの geography 値です。
geography地理的範囲に含まれないキーを作成するには、 をany に設定します。キーとエンドポイントの対応方法については、「 埋め込みと再ランク付けAPI の概要 」を参照してください。
地理が保証することと、キーのスコープを 1 に設定するかどうかを決定する方法については、「 Atlas の地理と指定サービス 」を参照してください。
地理で利用可能なモデル
スコープ付きエンドポイントは、すべての MongoDB AIモデルをサポートするわけではありません。モデル テーブルの [サポートされているエンドポイント] 列には、すべてのエンドポイントが提供するモデルは All と、スコープが設定されていないエンドポイントのみが提供するモデルは ai.mongodb.com と表示されます。
どのエンドポイントが特定のモデルを提供しているかを確認するには、「 モデルの非推奨、ライフサイクルの状態、サポート 」を参照してください。
各モデルの詳細については、「 モデルの概要 」を参照してください。
地理的スコープ付きリソースの管理
地理的スコープのリソースを使用するには、次のセクションを参照してください。
地理的スコープのモデルAPIキーを作成するには、「 キースコープ 」を参照してください。
新しいモデルAPIキーが特定の地理的条件を使用することを要求するには、「 リソース ポリシーを使用してモデルAPIキーの範囲を制限する 」を参照してください。
REST APIまたはクライアントライブラリから地理のエンドポイントにリクエストを送信するには、「 スコープ付きエンドポイント 」を参照してください。
キーとエンドポイントの対応方法については、「 エンドポイント 」を参照してください。
スコープ付きエンドポイントに適用されるレート制限を確認するには、「 地理的レート制限 」を参照してください。
地理的別に使用状況データをフィルタリングしてセグメント化するには、「 地理的使用状況 」を参照してください。