Vectorizador do Azure OpenAI

  • Artigo

O vetorizador do Azure OpenAI se conecta a um modelo de incorporação implantado em seu recurso do Azure OpenAI para gerar incorporações no momento da consulta. Seus dados são processados na área geográfica onde seu modelo é implantado.

Os vetorizadores são usados no momento da consulta, mas especificados em definições de índice e referenciados em campos vetoriais por meio de um perfil vetorial. O vetorizador do Azure OpenAI é chamado AzureOpenAIVectorizer na API.

Nota

Este vetorizador está vinculado ao Azure OpenAI e é cobrado pelo preço existente do Azure OpenAI pay-as-you go.

Pré-requisitos

Seu Serviço OpenAI do Azure deve ter um subdomínio personalizado associado. Se o serviço tiver sido criado através do portal do Azure, este subdomínio é gerado automaticamente como parte da configuração do serviço. Certifique-se de que seu serviço inclua um subdomínio personalizado antes de usá-lo com a integração do Azure AI Search.

Os recursos do Serviço OpenAI do Azure (com acesso a modelos de incorporação) criados no AI Studio não são suportados. Somente os recursos do Serviço OpenAI do Azure criados no portal do Azure são compatíveis com a integração de habilidades do Azure OpenAI Embedding .

Parâmetros do vetorizador

Os parâmetros diferenciam maiúsculas de minúsculas.

Nome do parâmetro Description
resourceUri O URI do provedor de modelo, neste caso, um recurso do Azure OpenAI. Este parâmetro suporta apenas URLs com domínio openai.azure.com, como https://<resourcename>.openai.azure.com. Se o ponto de extremidade do Azure OpenAI tiver uma URL com domínio , como https://<resourcename>.cognitiveservices.azure.com, um subdomínio personalizado com openai.azure.com deverá ser criado primeiro para o recurso do Azure OpenAI e usá-lohttps://<resourcename>.openai.azure.com.cognitiveservices.azure.com
apiKey A chave secreta usada para acessar o modelo. Se fornecer uma chave, deixe authIdentity em branco. Se você definir o apiKey e authIdentity, o apiKey é usado na conexão.
deploymentId O nome do modelo de incorporação do Azure OpenAI implantado. O modelo deve ser um modelo de incorporação, como text-embedding-ada-002. Consulte a Lista de modelos do Azure OpenAI para modelos suportados.
authIdentity Uma identidade gerenciada pelo usuário usada pelo serviço de pesquisa para se conectar ao Azure OpenAI. Você pode usar uma identidade gerenciada pelo sistema ou pelo usuário. Para usar uma identidade gerenciada pelo sistema, deixe apiKey em authIdentity branco. A identidade gerenciada pelo sistema é usada automaticamente. Uma identidade gerenciada deve ter permissões de Usuário OpenAI dos Serviços Cognitivos para enviar texto para o Azure OpenAI.
modelName (Necessário na versão da API 2024-05-01-Preview e posterior). O nome do modelo de incorporação do Azure OpenAI que é implantado no fornecido resourceUri e deploymentId. Atualmente, os valores suportados são text-embedding-ada-002, text-embedding-3-largee text-embedding-3-small

Tipos de consulta vetorial suportados

O vetorizador do Azure OpenAI dá suporte text apenas a consultas vetoriais.

Dimensões de campo esperadas

As dimensões de campo esperadas para um campo configurado com um vetorizador OpenAI do Azure dependem do modelName que está configurado.

modelName Dimensões mínimas Dimensões máximas
incorporação de texto-ada-002 1536 1536
incorporação de texto-3-grande 1 3072
incorporação de texto-3-pequeno 1 1536

Definição da amostra

"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 também