Partager via

Vectoriseur Azure OpenAI

  • Article

Important

Cette fonctionnalité est en préversion publique sous les conditions d’utilisation supplémentaires. L’API REST 2023-10-01-Preview et toutes les API REST en préversion plus récentes prennent en charge cette fonctionnalité.

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é.

Remarque

Ce vectoriseur est liée à Azure OpenAI et est facturée au prix du paiement à l’utilisation 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