Azure OpenAI ベクター化
Azure OpenAI ベクタライザーは、Azure OpenAI リソースにデプロイされた埋め込みモデルに接続して、クエリ時に埋め込みを生成します。 データは、モデルがデプロイされている geo で処理されます。
Vectorizer はクエリ時に使用されますが、インデックス定義で指定され、ベクター プロファイルを介してベクター フィールドで参照されます。 Azure OpenAI ベクターライザーは、API で AzureOpenAIVectorizer
呼び出されます。
2024-07-01 REST API または更新された Azure SDK パッケージを使用して機能を提供します。
検索インデックスでベクターライザーを構成使用手順を示します。
Note
このベクタライザーは Azure OpenAI にバインドされており、既存の Azure OpenAI の従量課金制の価格で課金されます。
ベクタライザー パラメーター
パラメーターの大文字と小文字は区別されます。
パラメーター名 | 説明 |
---|---|
resourceUri |
モデル プロバイダー (この場合は Azure OpenAI リソース) の URI。 このパラメーターは、https://<resourcename>.openai.azure.com などのドメイン openai.azure.com を持つ URL のみをサポートします。 Azure OpenAI エンドポイントにドメイン cognitiveservices.azure.com を含む URL (https://<resourcename>.cognitiveservices.azure.com など) がある場合は、 openai.azure.com を含むを Azure OpenAI リソース用に最初に作成し、代わりにhttps://<resourcename>.openai.azure.com を使用する必要があります。 |
apiKey |
モデルのアクセスに使用されるシークレット キー。 キーを指定する場合は、authIdentity を空のままにします。 apiKey と authIdentity の両方を設定すると、接続で apiKey が使用されます。 |
deploymentId |
デプロイされた Azure OpenAI 埋め込みモデルの名前。 このモデルは、text-embedding-ada-002 などの埋め込みモデルである必要があります。 サポートされているモデルについては、Azure OpenAI モデルの一覧を参照してください。 |
authIdentity |
Azure OpenAI に接続するために検索サービスによって使用されるユーザー マネージド ID。 システムまたはユーザーのマネージド ID を使用できます。 システム マネージド ID を使用するには、apiKey と authIdentity を空白のままにします。 システム マネージド ID が自動的に使用されます。 Azure OpenAI にテキストを送信するには、マネージド ID に Cognitive Services OpenAI ユーザー アクセス許可が必要です。 |
modelName |
(API バージョン 2024-05-01-Preview 以降で必須)。 指定された resourceUri および deploymentId にデプロイされる Azure OpenAI 埋め込みモデルの名前。 現在サポートされている値は、text-embedding-ada-002 、text-embedding-3-large 、text-embedding-3-small です |
サポートされているベクター クエリの種類
Azure OpenAI ベクタライザーでは、text
ベクター クエリのみがサポートされます。
想定されるフィールドのディメンション
Azure OpenAI ベクタライザーを使用して構成されたフィールドに想定されるフィールド ディメンションは、構成されている modelName
によって異なります。
modelName |
最小ディメンション | 最大ディメンション |
---|---|---|
text-embedding-ada-002 | 1536 | 1536 |
text-embedding-3-large | 1 | 3072 |
text-embedding-3-small | 1 | 1536 |
定義例
"vectorizers": [
{
"name": "my-openai-vectorizer",
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://my-fake-azure-openai-resource.openai.azure.com",
"apiKey": "0000000000000000000000000000000000000",
"deploymentId": "my-ada-002-deployment",
"authIdentity": null,
"modelName": "text-embedding-ada-002",
},
}
]