Compartir a través de

Vectorizador de Azure OpenAI

  • Artículo

Importante

Esta característica se encuentra en versión preliminar pública en los Términos de uso complementarios. La API DE REST 2023-10-01-Preview y todas las API REST en versión preliminar más recientes admiten esta característica.

El vectorizador de Azure OpenAI se conecta a un modelo de inserción implementado en el recurso de Azure OpenAI para generar inserciones en el momento de la consulta. Los datos se procesan en la ubicación geográfica en la que se implementa el modelo.

Nota:

Este vectorizador está enlazado a Azure OpenAI y se cobra según el precio de pago por uso de Azure OpenAI existente.

Parámetros de vectorizador

Los parámetros distinguen mayúsculas de minúsculas.

Nombre de parámetro Descripción
resourceUri URI de un proveedor de modelos, como un recurso de Azure OpenAI o una dirección URL de OpenAI.
apiKey Clave secreta que se usa para acceder al modelo. Si proporciona una clave, deje authIdentity vacío. Si establece apiKey y authIdentity, apiKey se usa en la conexión.
deploymentId El nombre del modelo de inserción de Azure OpenAI implementado. El modelo debe ser un modelo de inserción, como text-embeding-ada-002. Consulte la lista de modelos de Azure OpenAI para ver los modelos admitidos.
authIdentity Una identidad administrada por el usuario que usa el servicio de búsqueda para conectarse a Azure OpenAI. Puede usar una identidad administrada por el usuario o por el sistema. Para usar una identidad administrada del sistema, deje apiKey y authIdentity en blanco. La identidad administrada por el sistema se usa automáticamente. Una identidad administrada debe tener permisos de usuario de OpenAI de Cognitive Services para enviar texto a Azure OpenAI.
modelName Obligatorio en la versión de API 2024-05-01-Preview y versiones posteriores. Nombre del modelo de inserción de Azure OpenAI que se implementa en los valores proporcionados resourceUri y deploymentId. Actualmente, los valores admitidos son text-embedding-ada-002, text-embedding-3-large y text-embedding-3-small.

Tipos de consulta vectorial admitidos

El vectorizador de Azure OpenAI solo admite text consultas vectoriales.

Dimensiones de campo esperadas

Las dimensiones de campo esperadas para un campo configurado con un vectorizador de Azure OpenAI dependen del modelName que esté configurado.

modelName Dimensiones mínimas Dimensiones máximas
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3072
text-embedding-3-small 1 1536

Definición de ejemplo

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

Consulte también