次の方法で共有

Azure OpenAI ベクター化

  • [アーティクル]

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

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

Note

このベクタライザーは Azure OpenAI にバインドされており、既存の Azure OpenAI の従量課金制の価格で課金されます。

前提条件

Azure OpenAI サービスには、カスタム サブドメインが関連付けられている必要があります。 サービスが Azure portal を使用して作成された場合、このサブドメインはサービス セットアップの一部として自動的に生成されます。 Azure AI 検索統合で使用する前に、サービスにカスタム サブドメインが含まれていることを確認します。

AI Studio で作成された (埋め込みモデルにアクセスできる) Azure OpenAI サービス リソースはサポートされていません。 Azure Portal で作成された Azure OpenAI サービス リソースのみが、Azure OpenAI Embedding スキル統合と互換性があります。

ベクタライザー パラメーター

パラメーターの大文字と小文字は区別されます。

パラメーター名 説明
resourceUri モデル プロバイダー (この場合は Azure OpenAI リソース) の URI。 このパラメーターは、ドメイン openai.azure.comを持つ URL のみをサポートします。次に例を示 https://<resourcename>.openai.azure.comします。 Azure OpenAI エンドポイントにドメインcognitiveservices.azure.comを含む URL がある場合は、https://<resourcename>.cognitiveservices.azure.comAzure OpenAI リソース用にカスタム サブドメインopenai.azure.comを最初に作成し、代わりに使用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",
        },
    }
]

関連項目