Freigeben über


Azure OpenAI-Vektorisierung

Die Vektorisierung von Azure OpenAI stellt eine Verbindung zu einem bereitgestellten Einbettungsmodell auf Ihrer Azure OpenAI Ressource her, um zur Abfragezeit Einbettungen zu erzeugen. Ihre Daten werden im geografischen Raum verarbeitet, in dem Ihr Modell bereitgestellt wird.

Vektorisierer werden zur Abfragezeit verwendet, in Indexdefinitionen jedoch angegeben und über ein Vektorprofil auf Vektorfelder verwiesen. Der Azure OpenAI-Vektorizer wird in der API aufgerufen AzureOpenAIVectorizer .

Hinweis

Dieser Vektorizer ist an Azure OpenAI gebunden und wird zum vorhandenen Azure OpenAI Standard-Preis berechnet.

Voraussetzungen

Ihre Azure OpenAI in Azure AI Foundry Models muss über eine zugeordnete benutzerdefinierte Unterdomäne verfügen. Wenn der Dienst über das Azure-Portal erstellt wurde, wird diese Unterdomäne automatisch im Rahmen Ihres Dienstsetups generiert. Stellen Sie sicher, dass Ihr Dienst eine benutzerdefinierte Unterdomäne enthält, bevor Sie ihn mit der Integration der Azure KI-Suche verwenden.

Azure OpenAI-Ressourcen (mit Zugriff auf Einbettungsmodelle), die im Azure AI Foundry-Portal erstellt wurden, werden nicht unterstützt. Nur die im Azure-Portal erstellten Azure OpenAI-Ressourcen sind mit der Azure OpenAI Embedding Skill Integration kompatibel.

Vektorisierungsparameter

Bei den Parametern wird zwischen Groß- und Kleinschreibung unterschieden.

Parametername Beschreibung
resourceUri Der URI des Modellanbieters, in diesem Fall eine Azure OpenAI-Ressource. Dieser Parameter unterstützt nur URLs mit Domäne openai.azure.com, z https://<resourcename>.openai.azure.com. B. . Wenn der Azure OpenAI-Endpunkt über eine URL mit Domäne cognitiveservices.azure.comverfügt, z https://<resourcename>.cognitiveservices.azure.com. B. eine benutzerdefinierte Unterdomäne , die openai.azure.com zuerst für die Azure OpenAI-Ressource erstellt und stattdessen verwendet https://<resourcename>.openai.azure.com werden muss.
apiKey Der geheime Schlüssel, mit dem auf das Modell zugegriffen wird. Wenn Sie einen Schlüssel angeben, lassen Sie authIdentity leer. Wenn Sie sowohl die apiKey als auch die authIdentity einstellen, wird die apiKey für die Verbindung verwendet.
deploymentId Der Name des bereitgestellten Azure OpenAI-Einbettungsmodells. Das Modell sollte ein Einbettungsmodell sein, z. B. text-embedding-ada-002. Siehe die Liste der Azure OpenAI-Modelle für unterstützte Modelle.
authIdentity Eine benutzerverwaltete Identität, die vom Suchdienst für die Verbindung zu Azure OpenAI verwendet wird. Sie können entweder eine system- oder eine benutzerverwaltete Identität verwenden. Wenn Sie eine vom System verwaltete Identität verwenden möchten, lassen Sie sie leerapiKey.authIdentity Die vom System verwaltete Identität wird automatisch verwendet. Eine verwaltete Identität muss über Cognitive Services OpenAI User Berechtigungen verfügen, um Text an Azure OpenAI zu senden.
modelName (Erforderlich in API Version 2024-05-01-Vorschau und neuer). Der Name des Azure OpenAI-Einbettungsmodells, das bei der angegebenen resourceUri und deploymentId bereitgestellt wird. Derzeit werden die Werte text-embedding-ada-002, text-embedding-3-large und text-embedding-3-small unterstützt.

Unterstützte Vektorabfragetypen

Die Azure OpenAI-Vektorisierung unterstützt nur text-Vektorabfragen.

Erwartete Feldabmessungen

Die erwarteten Feldabmessungen für ein Feld, das mit einer Azure OpenAI-Vektorisierung konfiguriert ist, hängen vom Wert modelName ab, der konfiguriert wird.

modelName Mindestmaße Maximale Dimensionen
text-embedding-ada-002 1536 1536
Texteinbettung-3-groß 1 3072
Texteinbettung-3-klein 1 1536

Beispieldefinition

"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",
        },
    }
]

Weitere Informationen