Azure OpenAI ベクターライザーは、Azure OpenAI リソースまたは Azure AI Foundry プロジェクトにデプロイされた埋め込みモデルに接続して、クエリ時に埋め込みを生成します。 データは、モデルがデプロイされている geo で処理されます。
ベクター化はクエリ時に使用されますが、インデックス定義で指定し、ベクター プロファイルを使用してベクター フィールドで参照します。 詳細については、「 検索インデックスでベクターライザーを構成する」を参照してください。
Azure OpenAI ベクターライザーは、REST API で AzureOpenAIVectorizer
呼び出されます。 最新の安定バージョンの インデックス - 作成 (REST API) または機能を提供する Azure SDK パッケージを使用します。
Note
このベクター化は Azure OpenAI にバインドされ、既存の Azure OpenAI Standard 価格で課金されます。
Prerequisites
Azure AI Foundry Models リソースまたは Azure AI Foundry プロジェクトの Azure OpenAI。
Azure OpenAI リソースには、などの
https://<resourcename>.openai.azure.com
が必要です。 Azure portal でリソースを作成した場合、このサブドメインはリソースのセットアップ中に自動的に生成されました。Azure AI Foundry プロジェクトには、
cognitiveservices.azure.com
ドメインを持つ Azure AI サービス エンドポイントが必要です。 Azure OpenAI 埋め込みモデルをプロジェクトにデプロイした後、openai.azure.com
ドメインを使用するようにエンドポイントを変更する必要があります。 たとえば、エンドポイントをhttps://<resourcename>.cognitiveservices.azure.com
からhttps://<resourcename>.openai.azure.com
に変更します。 その後、このベクターライザーのresourceUri
プロパティに対して、この更新されたエンドポイントを使用できます。
リソースまたはプロジェクトにデプロイされた Azure OpenAI 埋め込みモデル。 サポートされているモデルについては、次のセクションを参照してください。
Vectorizer パラメーター
パラメーターの大文字と小文字は区別されます。
パラメーター名 | Description |
---|---|
resourceUri |
モデル プロバイダーの URI。 このパラメーターは、openai.azure.com など、https://<resourcename>.openai.azure.com ドメインを持つ URL のみをサポートします。
Azure API Management エンドポイントは、URL https://<resourcename>.azure-api.net でサポートされています。 共有プライベート リンクは、API Management エンドポイントではサポートされていません。 |
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",
},
}
]