Adicionar Azure AI Search como uma fonte de conhecimento

Azure AI Search fornece um poderoso mecanismo de pesquisa que pode pesquisar por meio de uma grande coleção de documentos. Copilot Studio dá suporte à adição de Azure AI Search como uma fonte de conhecimento.

Para concluir a conexão, você precisa de uma conta Azure. Se você não tiver uma conta Azure, poderá criar uma conta em Microsoft Azure.

Depois de criar a conta Azure, use os seguintes artigos do Azure para configurar e definir o Azure AI Search. Estes artigos fornecem informações sobre a configuração e a configuração necessárias para usar a conexão Azure AI Search como uma fonte de conhecimento:

Aqui, a autenticação baseada em chave é usada para se conectar a Azure AI Search.

Copilot Studio dá suporte a índices vectorizados usando vetorização integrada. Prepare seus dados e escolha um modelo incorporado e use Importar e vetorizar dados em Azure AI Search para criar índices de vetor. Esse método permite que o sistema use o mesmo modelo incorporado usado para vetorizar os dados para também vetorizar o prompt de entrada no runtime, o que reduz a necessidade de gravar funções especiais para fazer o mesmo.

Copilot Studio também dá suporte ao uso do recurso semantic ranker. Esse recurso também precisa ser configurado em Azure AI Search antes de adicionar a conexão em Copilot Studio. Para mais informações, consulte Introdução ao classificador semântico.

Observação

Você deve adicionar o Azure AI Search por meio de uma conexão formal de dados. Não configure manualmente um endpoint e uma chave de API.

Se você criar uma conexão Azure AI Search sem suporte, Copilot Studio poderá armazenar uma conexão de dados com falha que impede o carregamento da caixa de diálogo de conexão Azure AI Search. Quando isso acontece, a caixa de diálogo pode aparecer brevemente e, em seguida, falhar com um erro. Copilot Studio atualmente não fornece uma interface para excluir uma conexão de dados Azure AI Search interrompida. Como as conexões de dados são gerenciadas no nível do ambiente, esse problema pode afetar todos os agentes.

Para recuperar a conexão, redefina o acesso externo do agente ou exclua e recrie o agente afetado. Ao adicionar novamente a Pesquisa de IA do Azure, use Fontes de dados → Pesquisa de IA do Azure com autenticação do Entra ID, não chaves de API.

  1. Abrir o agente.

  2. Selecione Adicionar conhecimento das páginas Visão geral ou Conhecimento ou nas Propriedades de um nó de respostas generativas.

  3. Na caixa de diálogo Adicionar conhecimento, selecione Em Destaque.

  4. Selecione Azure AI Search.

  5. Selecione Criar uma Nova Conexão.

  6. Selecione o Tipo de autenticação. Você tem as seguintes opções:

    • Chave de Acesso
    • Autenticação do Certificado do Cliente
    • Service principal (aplicativo Microsoft Entra ID)
    • Microsoft Entra ID Integrado

  7. Insira os detalhes necessários para o tipo de autenticação. Para autenticação baseada em chave, conforme descrito na seção de configuração anterior, insira a URL do ponto de extremidade Azure AI Search e a chave de administrador Azure AI Search.

  8. Selecione Criar para concluir a conexão. Uma marca de seleção verde aparece para confirmar a conexão.

  9. Selecione Próximo.

  10. Insira o índice de vetor do Azure AI Search a ser usado. Apenas um índice vetorial pode ser adicionado.

  11. Selecione Adicionar ao agente para completar a conexão.

Depois de adicionar a conexão, ela aparecerá na tabela de fontes de conhecimento. O status é exibido como Em andamento enquanto o Copilot Studio indexa os metadados nas tabelas. Após a conclusão da indexação, o status é atualizado para Pronto e você pode começar a testar a fonte de conhecimento. Durante o teste, você pode verificar se as referências apropriadas foram chamadas revisando os arquivos e citações citados pelo agente.

Retornar citações

Para retornar citações ao usar Azure AI Search em Copilot Studio, inclua um campo de URL com o link real para o documento no índice de pesquisa. Quando o campo metadata_storage_path é incluído no índice, Copilot Studio interpreta esse campo como a citação. No entanto, se esse campo não existir, o Copilot Studio considera qualquer campo que contenha um link de URL completo como a citação. Para obter mais informações, consulte Indexe o conteúdo e os metadados do arquivo usando a Pesquisa de IA do Azure

Observação

Ao configurar citações em Azure AI Search, verifique se os usuários do seu agente têm as permissões necessárias para acessar as fontes de dados às quais as citações apontam. Por exemplo, se você adicionar uma URL no índice de pesquisa que remete para um site ou base de conhecimento, os usuários devem ter acesso a essas fontes. Se a URL apontar para uma fonte de dados restrita, os usuários não podem acessar as citações geradas.

suporte de Rede Virtual

Copilot Studio dá suporte a índices Azure AI Search configurados para redes virtuais. Essa configuração permite que você use um ponto de extremidade privado para conectar com segurança seus índices de pesquisa.

Para obter instruções sobre como configurar o ponto de extremidade, consulte Criar um ponto de extremidade privado para Azure AI Search

Configurar o suporte de Rede Virtual no ambiente do Power Platform, consulte Configurar o suporte de Rede Virtual para o Power Platform.

Em Copilot Studio, siga o steps para concluir a configuração da conexão.

  • Last updated on