Azure OpenAI ベクター化
Azure OpenAI ベクタライザーは、Azure OpenAI リソースにデプロイされた埋め込みモデルに接続して、クエリ時に埋め込みを生成します。 データは、モデルがデプロイされている geo で処理されます。
Vectorizer はクエリ時に使用されますが、インデックス定義で指定され、ベクター プロファイルを介してベクター フィールドで参照されます。 Azure OpenAI ベクターライザーは、API で AzureOpenAIVectorizer
呼び出されます。
2024-07-01 REST API または更新された Azure SDK パッケージを使用して機能を提供します。
検索インデックスでベクターライザーを構成使用手順を示します。
Note
このベクタライザーは Azure OpenAI にバインドされており、既存の Azure OpenAI の従量課金制の価格で課金されます。
前提条件
Azure OpenAI サービスには、 custom サブドメインが関連付けられている必要があります。 サービスが Azure portal を使用して作成された場合、このサブドメインはサービス セットアップの一部として自動的に生成されます。 Azure AI 検索統合で使用する前に、サービスにカスタム サブドメインが含まれていることを確認します。
Azure AI Foundry ポータルで作成された (埋め込みモデルにアクセスできる) Azure OpenAI サービス リソースはサポートされていません。 Azure portal で作成された Azure OpenAI Service リソースのみが、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",
},
}
]