次の方法で共有


Azure OpenAI ベクター化

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 を空のままにします。 apiKeyauthIdentity の両方を設定すると、接続で 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-002text-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",
        },
    }
]

こちらも参照ください