Compartilhar via

Vetorizador Azure OpenAI

  • Artigo

O vetorizador de Inserção do Azure OpenAI conecta-se a um modelo de inserção implantado no seu recurso do Azure OpenAI para gerar inserções no momento da consulta. Seus dados são processados na área geográfica em que o 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 OpenAI do Azure é chamado AzureOpenAIVectorizer na API.

Observação

Esse vetorizador está associado ao Azure OpenAI e é cobrado no Preço pago conforme o uso do Azure OpenAI existente.

Pré-requisitos

Seu Serviço OpenAI do Azure deve ter um subdomínio personalizado associado. Se o serviço tiver sido criado por meio do portal do Azure, esse subdomínio será gerado automaticamente como parte da configuração do serviço. Certifique-se de que o serviço inclua um subdomínio personalizado antes de usá-lo com a integração da Pesquisa de IA do Azure.

Não há suporte para recursos do Serviço OpenAI do Azure (com acesso a modelos de inserção) criados no portal do Azure AI Foundry. Somente os recursos do Serviço OpenAI do Azure criados no portal do Azure são compatíveis com a integração da habilidade de Incorporação do OpenAI do Azure.

Parâmetros do vetorizador

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

Nome do parâmetro Descrição
resourceUri O URI do provedor de modelo, nesse caso, um recurso do OpenAI do Azure. Esse parâmetro só oferece suporte a URLs com domínio openai.azure.com, como https://<resourcename>.openai.azure.com. Se o ponto de extremidade do OpenAI do Azure tiver uma URL com o domínio cognitiveservices.azure.com, como https://<resourcename>.cognitiveservices.azure.com, um subdomínio personalizado com openai.azure.com deverá ser criado primeiro para o recurso OpenAI do Azure e usado https://<resourcename>.openai.azure.com em seu lugar.
apiKey A chave secreta usada para acessar o modelo. Se você fornecer uma chave, deixe authIdentity vazio. Se você definir apiKey e authIdentity, apiKey será usado na conexão.
deploymentId O nome do modelo de inserção do Azure OpenAI implantado. O modelo deve ser um modelo de inserção, como text-embedding-ada-002. Consulte a Lista de modelos do Azure OpenAI para modelos com suporte.
authIdentity Uma identidade gerenciada pelo usuário usada pelo serviço de pesquisa para se conectar ao Azure OpenAI. Você pode usar um sistema ou uma identidade gerenciada pelo usuário. Para usar uma identidade gerenciada pelo sistema, deixe apiKey e authIdentity em branco. A identidade gerenciada pelo sistema é usada automaticamente. Uma identidade gerenciada deve ter permissões de Usuário do OpenAI dos Serviços Cognitivos para enviar textos ao Azure OpenAI.
modelName (Obrigatório na API versão 2024-05-01-Versão prévia e posterior). O nome do modelo de inserção do Azure OpenAI implantado no resourceUri e no deploymentIdfornecidos. Os valores atualmente compatíveis são text-embedding-ada-002, text-embedding-3-large e text-embedding-3-small

Tipos de consultas vetoriais com suporte

O vetor do Azure OpenAI dá suporte apenas a consultas de vetor text.

Dimensões de campo esperadas

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

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

Definição de exemplo

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

Confira também