Compartir a través de

Vectorizador de Azure OpenAI

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

Aunque los vectorizadores se usan en el momento de la consulta, se especifican en definiciones de índice y se hace referencia a ellos en campos vectoriales a través de un perfil de vector. Para obtener más información, vea Configurar un vectorizador en un índice de búsqueda.

Se llama AzureOpenAIVectorizer al vectorizador OpenAI de Azure en la API REST. Use la versión estable más reciente de Indexes- Create (REST API) o un paquete de Azure SDK que proporcione la característica.

Note

Este vectorizador está enlazado a Azure OpenAI y se cobra por el precio estándar de Azure OpenAI.

Prerequisites

  • Un recurso de Azure OpenAI en foundry Models o un proyecto Foundry.

    • El recurso de Azure OpenAI debe tener un subdominio personalizado, como https://<resource-name>.openai.azure.com. Puede encontrar este punto de conexión en la página Claves y punto de conexión de Azure Portal y usarlo para la resourceUri propiedad de esta aptitud.

    • El recurso primario del proyecto Foundry proporciona acceso a varios puntos de conexión, incluidos https://<resource-name>.openai.azure.com, https://<resource-name>.services.ai.azure.comy https://<resource-name>.cognitiveservices.azure.com. Puede encontrar estos puntos de conexión en la página Claves y punto de conexión de Azure Portal y usar cualquiera de ellos para la resourceUri propiedad de esta aptitud.

  • Un modelo de inserción de Azure OpenAI implementado en el recurso o proyecto. Para ver los modelos admitidos, consulte la sección siguiente.

Parámetros de vectorizador

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

Nombre del parámetro Description
resourceUri (Obligatorio) Identificador URI del proveedor de modelos. Los dominios admitidos son:

  • openai.azure.com
  • services.ai.azure.com
  • cognitiveservices.azure.com

Los puntos de conexión de Azure API Management se admiten con la dirección URL https://<resource-name>.azure-api.net. Los vínculos privados compartidos no se admiten para los puntos de conexión de API Management.
apiKey Clave secreta que se usa para acceder al modelo. Si proporciona una clave, deje authIdentity vacío. Si establece y apiKeyauthIdentity, apiKey se usa en la conexión.
deploymentId (Obligatorio) Identificador del modelo de inserción de Azure OpenAI implementado. Este es el nombre de implementación que especificó al implementar el modelo.
authIdentity Una identidad administrada por el usuario que usa el servicio de búsqueda para la conexión. Puede usar una identidad administrada por el sistema o por el usuario. Para usar una identidad administrada por el 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) Nombre del modelo de Azure OpenAI implementado en el especificado deploymentId. Los valores admitidos son:

  • text-embedding-ada-002
  • text-embedding-3-large
  • 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

  • Last updated on