次の方法で共有


Azure OpenAI ベクター化

Azure OpenAI ベクタライザーは、Azure OpenAI リソースにデプロイされた埋め込みモデルに接続して、クエリ時に埋め込みを生成します。 データは、モデルがデプロイされている geo で処理されます。

Vectorizer はクエリ時に使用されますが、インデックス定義で指定され、ベクター プロファイルを介してベクター フィールドで参照されます。 Azure OpenAI ベクターライザーは、API で AzureOpenAIVectorizer 呼び出されます。

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 を空のままにします。 apiKeyauthIdentity の両方を設定すると、接続で apiKey が使用されます。
deploymentId デプロイされた Azure OpenAI 埋め込みモデルの名前。 このモデルは、text-embedding-ada-002 などの埋め込みモデルである必要があります。 サポートされているモデルについては、Azure OpenAI モデルの一覧を参照してください。
authIdentity Azure OpenAI に接続するために検索サービスによって使用されるユーザー マネージド ID。 システムまたはユーザーのマネージド ID を使用できます。 システム マネージド ID を使用するには、apiKeyauthIdentity を空白のままにします。 システム マネージド ID が自動的に使用されます。 Azure OpenAI にテキストを送信するには、マネージド ID に Cognitive Services OpenAI ユーザー アクセス許可が必要です。
modelName (API バージョン 2024-05-01-Preview 以降で必須)。 指定された resourceUri および deploymentIdにデプロイされる Azure OpenAI 埋め込みモデルの名前。 現在サポートされている値は、text-embedding-ada-002text-embedding-3-largetext-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",
        },
    }
]

関連項目