Freigeben über

Azure OpenAI-Vektorisierung

  • Artikel

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

Diese Vektorisierung ist an Azure OpenAI gebunden und wird zum bestehenden Azure OpenAI-Preis bei nutzungsbasierter Bezahlung berechnet.

Voraussetzungen

Ihr Azure OpenAI-Dienst 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 Service-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 Service-Ressourcen sind mit der Skillintegration Azure OpenAI-Einbettung 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. Um eine vom System verwaltete Identität zu verwenden, lassen Sie apiKey und authIdentity leer. 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
text-embedding-3-large 1 3072
text-embedding-3-small 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