Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Note
O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.
Importante
Funcionalidades, capacidades ou propriedades assinaladas (pré-visualização) não são abrangidas por um acordo de nível de serviço, não são recomendadas para cargas de trabalho em produção e podem mudar ou ser limitadas antes de se tornarem geralmente disponíveis. Os termos de pré-visualização do Pesquisa de IA do Azure aplicam-se a todas as funcionalidades de pré-visualização, sejam independentes ou parte de uma funcionalidade geralmente disponível.
O vetorizador de catálogo de modelos Microsoft Foundry (pré-visualização) liga-se a um modelo de embedding implementado a partir do catálogo de modelos Foundry ou de um endpoint Azure Machine Learning (AML). Os seus dados são processados na Geo onde o seu modelo é implementado.
Se estiver a usar vetorização integrada para criar os arrays vetoriais, o conjunto de competências deve incluir uma competência AML que aponte para o mesmo modelo especificado no vetorizador.
Pré-requisitos
Um projeto baseado no hub Foundry da Microsoft ou um espaço de trabalho AML para um modelo personalizado que você cria.
Para projetos baseados apenas em hub, uma implementação serverless de um modelo suportado do catálogo Foundry da Microsoft. Podes usar o CLI do Azure para provisionar a implementação serverless.
Parâmetros do vetorizador
Os parâmetros diferenciam letras maiúsculas de minúsculas. Os parâmetros que utiliza dependem da autenticação que o seu fornecedor de modelos exige, se é que exige.
| Nome do parâmetro | Descrição |
|---|---|
uri |
(Necessário para autenticação chave) O URI-alvo da implementação serverless do catálogo de modelos Microsoft Foundry ou do URI de pontuação do endpoint online AML. Só o esquema URI HTTPS é permitido. |
key |
(Obrigatório para autenticação de chaves) A chave API do fornecedor do modelo. |
resourceId |
(Obrigatório para a autenticação do token) O ID de recurso do Azure Resource Manager do fornecedor do modelo. Para um endpoint AML online, utilize o formato subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/onlineendpoints/{endpoint_name}. |
modelName |
O nome do modelo de incorporação do catálogo de modelos da Microsoft Foundry implementado no uri especificado. Modelos suportados (apenas implementações serverless) são:
|
region |
(Opcional para autenticação de token) A região em que o fornecedor do modelo está localizado. É obrigatório se a região for diferente da região do serviço de pesquisa. |
timeout |
(Opcional) O timeout para o cliente HTTP fazer a chamada de API. Deve ser formatado como um valor XSD "dayTimeDuration" (um subconjunto restrito de um valor de duração ISO 8601 ). Por exemplo, PT60S durante 60 segundos. Se não estiver definido, é escolhido um valor padrão de 30 segundos. O tempo limite pode ser definido para um máximo de 230 segundos e um mínimo de 1 segundo. |
Que parâmetros de autenticação usar
O vetorizador de catálogo de modelos Microsoft Foundry oferece duas opções de autenticação:
Autenticação baseada em chaves. Você fornece uma chave estática para autenticar pedidos de pontuação do vetorizador. Defina os parâmetros
uriekeypara esta ligação.Autenticação baseada em tokens. O projeto baseado no hub Foundry, ou endpoint online AML, é implementado usando autenticação baseada em token. O serviço Pesquisa de IA do Azure deve ter uma managed identity e uma atribuição de função ao fornecedor do modelo. O vetorizador usa então a identidade do serviço de pesquisa para autenticar contra o fornecedor do modelo, sem necessidade de chaves estáticas. A identidade do serviço de pesquisa deve ter o papel de Proprietário ou Contribuidor . Defina o
resourceIdparâmetro e, se o serviço de pesquisa estiver numa região diferente do fornecedor do modelo, defina oregionparâmetro.
Tipos de consulta vetorial suportados
Quais os tipos de consulta vetorial suportados pelo vetorizador de catálogo de modelos da Microsoft Foundry dependem do modelName configurado.
| Modelo de incorporação | Suporta consultas text |
Suporta consultas imageUrl |
Suporta consultas imageBinary |
|---|---|---|---|
| Cohere-embed-v3-english | X | X | |
| Cohere-embed-v3-multilingual | X | X | |
| Cohere-embed-v4 | X | X |
Dimensões esperadas do campo
As dimensões esperadas do campo para um campo vetorial configurado com um vetorizador de catálogo de modelos Microsoft Foundry dependem do modelName que está configurado.
modelName |
Dimensões esperadas |
|---|---|
| Cohere-embed-v3-english | 1024 |
| Cohere-embed-v3-multilingual | 1024 |
| Cohere-embed-v4 | 256–1536 |
Definição de exemplo
Os nomes sugeridos de modelos no catálogo de modelos da Foundry consistem no modelo base mais um sufixo aleatório de três letras. O nome do seu modelo será diferente do mostrado neste exemplo.
"vectorizers": [
{
"name": "my-model-catalog-vectorizer",
"kind": "aml",
"amlParameters": {
"uri": "https://Cohere-embed-v3-multilingual-hin.eastus.models.ai.azure.com",
"key": "aaaaaaaa-0b0b-1c1c-2d2d-333333333333",
"timeout": "PT60S",
"modelName": "Cohere-embed-v3-multilingual-hin",
"resourceId": null,
"region": null,
},
}
]