Partager via

Vectoriseur Azure OpenAI

  • Article

Le vectoriseur Azure OpenAI se connecte à un modèle d’incorporation déployé sur votre ressource Azure OpenAI pour générer des incorporations au moment de la requête. Vos données sont traitées dans l’emplacement géographique où votre modèle est déployé.

Les vectoriseurs sont utilisés au moment de la requête, mais spécifiés dans les définitions d’index et référencés sur les champs vectoriels par le biais d’un profil vectoriel. Le vectoriseur Azure OpenAI est appelé AzureOpenAIVectorizer dans l’API.

Remarque

Ce vectoriseur est liée à Azure OpenAI et est facturée au prix du paiement à l’utilisation d’Azure OpenAI.

Prérequis

Votre service Azure OpenAI doit avoir un sous-domaine personnalisé associé. Si le service a été créé via le Portail Azure, ce sous-domaine est automatiquement généré dans le cadre de la configuration de votre service. Vérifiez que votre service inclut un sous-domaine personnalisé avant de l’utiliser avec l’intégration de Recherche Azure AI.

Les ressources Azure OpenAI Service (avec accès aux modèles d’incorporation) créées dans AI Studio ne sont pas prises en charge. Seules les ressources Azure OpenAI Service créées dans le Portail Azure sont compatibles avec l’intégration de la compétence Incorporation d’Azure OpenAI.

Paramètres du vectoriseur

Les paramètres respectent la casse.

Nom du paramètre Description
resourceUri URI du fournisseur de modèles, dans ce cas, une ressource Azure OpenAI. Ce paramètre prend uniquement en charge les URL avec un domaine openai.azure.com, par https://<resourcename>.openai.azure.comexemple . Si le point de terminaison Azure OpenAI a une URL avec un domaine cognitiveservices.azure.com, par https://<resourcename>.cognitiveservices.azure.comexemple, un sous-domaine personnalisé avec lequel openai.azure.com vous devez d’abord être créé pour la ressource Azure OpenAI et l’utiliser https://<resourcename>.openai.azure.com à la place.
apiKey La clé secrète utilisée pour accéder au modèle. Si vous fournissez une clé, laissez le champ authIdentity vide. Si vous définissez le apiKey et leauthIdentity, le apiKey est utilisé sur la connexion.
deploymentId Le nom du modèle d’incorporation Azure OpenAI déployé. Le modèle doit être un modèle d’incorporation, comme text-embedding-ada-002. Voir la Liste des modèles Azure OpenAI pour les modèles pris en charge.
authIdentity Une identité managée par l’utilisateur utilisée par le service de recherche pour la connexion à Azure OpenAI. Vous pouvez utiliser une identité managée par le système ou l’utilisateur. Pour utiliser une identité managée par le système, laissez apiKey et authIdentity vide. L’identité managée par le système est utilisée automatiquement. Une identité managée doit avoir les autorisations utilisateur OpenAI Cognitive Services pour envoyer du texte à Azure OpenAI.
modelName (Nécessaire dans l’API version 2024-05-01-Preview et les versions ultérieures). Nom du modèle d’incorporation Azure OpenAI déployé sur les resourceUri et deploymentId fournis. Valeurs actuellement prises en charge : text-embedding-ada-002, text-embedding-3-large et text-embedding-3-small

Types de requêtes vectorielles pris en charge

Le vectoriseur Azure OpenAI prend uniquement en charge les requêtes vectorielles text.

Dimensions attendues du champ

Les dimensions attendues du champ pour un champ configuré avec un vectoriseur Azure OpenAI dépendent de celles modelName configurées.

modelName Dimensions minimales Dimensions maximales
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3 072
text-embedding-3-small 1 1536

Exemple de définition

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

Voir aussi