Configure o seu serviço Pesquisa de IA do Azure no portal Azure

Configurar o seu novo serviço Pesquisa de IA do Azure envolve várias tarefas para otimizar a segurança, o acesso e o desempenho. Este artigo fornece uma lista de verificação para o primeiro dia para o ajudar a configurar o seu serviço no portal Azure.

Depois de criar um serviço de pesquisa, recomendamos que:

Configurar o acesso baseado em funções

O acesso ao portal baseia-se na atribuição de funções. Por defeito, os novos serviços de pesquisa têm pelo menos um administrador ou proprietário do serviço. Administradores de serviços, coadministradores e proprietários têm permissão para criar mais administradores e atribuir outras funções. Também têm acesso a todas as páginas do portal e operações nos serviços de pesquisa padrão.

Cada serviço de pesquisa vem com chaves API e utiliza autenticação baseada em chaves por defeito. No entanto, recomendamos a utilização do Microsoft Entra ID e do controlo de acesso baseado em funções (RBAC) para melhorar a segurança. O RBAC elimina a necessidade de armazenar e passar chaves API em texto simples.

Quando muda da autenticação baseada em chave para a autenticação sem chave, os administradores de serviço devem atribuir-se papéis no plano de dados para acesso total a objetos e dados. Estas funções incluem Contribuidor de Serviços de Pesquisa, Contribuidor de Dados de Índice de Pesquisa e Leitor de Dados de Índice de Pesquisa.

Para configurar o acesso baseado em funções:

1. Ative funções no seu serviço de pesquisa. Recomendamos o uso tanto de chaves API como de funções.

2. Atribui papéis de plano de dados para substituir a funcionalidade perdida quando desativas as chaves API. Um proprietário só precisa do Search Index Data Reader, mas os programadores precisam de mais funções.

   A atribuição de funções pode demorar vários minutos a fazer efeito. Até lá, as páginas do portal usadas para operações no plano de dados exibem a seguinte mensagem:

   

3. Atribui mais funções aos programadores de soluções e aplicações.

Configurar uma identidade gerida

Se planeia usar indexadores para indexação automatizada, IA aplicada ou vetorização integrada, deve configurar o seu serviço de pesquisa para usar uma identidade gerida. Pode então atribuir funções noutros serviços do Azure que autorizam o seu serviço de pesquisa a aceder a dados e operações.

Para vetorização integrada, a identidade do seu serviço de pesquisa necessita das seguintes funções:

• Leitor de Dados de Blob de Armazenamento no Armazenamento do Azure
• Utilizador de Dados de Serviços Cognitivos num recurso Microsoft Foundry

A atribuição de funções pode demorar vários minutos a fazer efeito.

Antes de avançar para a segurança de rede, considere testar todos os pontos de ligação para validar as atribuições de funções. Executa um assistente de importação para testar permissões.

Configurar a segurança da rede

Por defeito, um serviço de pesquisa aceita pedidos autenticados e autorizados através de ligações públicas à internet. Tem duas opções para melhorar a segurança da rede:

• Configure regras de firewall para restringir o acesso à rede por endereço IP.
• Configure um endpoint privado para permitir apenas tráfego proveniente de redes virtuais Azure. Note que quando desliga o endpoint público, o assistente de Importação de Dados não será executado.

Para saber mais sobre chamadas de entrada e saída em Pesquisa de IA do Azure, consulte Compreender padrões de tráfego de rede.

Verifique a capacidade e compreenda a faturação

Por padrão, um serviço de pesquisa é criado com uma réplica e uma partição. Pode aumentar a capacidade ao adicionar réplicas e partições, mas recomendamos esperar até que os volumes o exijam. Muitos clientes executam cargas de trabalho de produção na configuração mínima.

O ranker semântico e a recuperação agentiva são funcionalidades premium que por padrão utilizam o plano gratuito. Se precisar de utilização paga para além da autorização gratuita, veja Ativar ou desativar a faturação semântica do ranker e Ativar ou desativar a faturação de recuperação agente.

Para saber mais sobre outras funcionalidades que afetam a faturação, consulte Planear e gerir custos de um serviço Pesquisa de IA do Azure.

Ativar registo de diagnóstico

Ative o registo de diagnóstico para acompanhar a atividade do utilizador. Se saltares este passo, continuas a receber registos de atividade e métricas de plataforma automaticamente. No entanto, se quiser informações de utilização de índice e consulta, deve ativar o registo de diagnóstico e escolher um destino para as operações registadas. Recomendamos o Log Analytics Workspace para armazenamento duradouro, permitindo que possa executar consultas ao sistema no portal do Azure.

Internamente, a Microsoft recolhe dados de telemetria sobre o seu serviço e a plataforma. Para saber mais sobre retenção de dados, consulte Retenção de métricas.

Para saber mais sobre localização e privacidade de dados, consulte Residência de dados.

Fornecer informação de ligação aos programadores

Para se ligar ao Pesquisa de IA do Azure, os programadores precisam:

• Um endpoint ou URL da página Visão Geral.
• Uma chave API da página de Chaves ou uma atribuição de uma função. Recomendamos o Contribuidor de Serviço de Pesquisa, o Contribuidor de Dados de Índice de Pesquisa e o Leitor de Dados de Índice de Pesquisa.

Recomendamos o acesso ao portal para o assistente de importação de dados e o explorador de pesquisa. Tens de ser um Contribuinte ou superior para gerir o mago.

Conteúdo relacionado

Para suporte programático para administração de serviços, consulte as seguintes APIs e módulos:

• Referência da API REST de gestão
• Módulo PowerShell Az.Search
• az módulo de pesquisa CLI do Azure

Também pode usar as bibliotecas de clientes de gestão nos SDKs do Azure para .NET, Python, Java e JavaScript.

Há paridade de funcionalidades em todas as modalidades e línguas, exceto nas funcionalidades de gestão de pré-visualizações. Como regra geral, as funcionalidades de gestão de pré-visualizações são lançadas primeiro através da API REST de Gestão.