Adicione o Azure AI Search como fonte de conhecimento

O Azure AI Search oferece um motor de busca poderoso que pode pesquisar através de uma grande coleção de documentos. Copilot Studio suporta a adição de Azure AI Search como fonte de conhecimento.

Para completar a ligação, precisa de uma conta no Azure. Se não tiver uma conta Azure, pode criar uma conta em Microsoft Azure.

Depois de criar a conta de Azure, utilize os seguintes artigos de Azure para configurar e atualizar o Azure AI Search. Estes artigos fornecem informações sobre a configuração necessária para usar a ligação Azure AI Search como fonte de conhecimento:

Aqui, a autenticação baseada em chaves é usada para se ligar ao Azure AI Search.

Copilot Studio suporta índices vetorizados usando vetorização integrada. Prepara os teus dados e escolhe um modelo embutido, depois usa Importar e vetorizar dados em Azure AI Search para criar índices vetoriais. Este método permite ao sistema usar o mesmo modelo incorporado usado para vetorizar os dados para também vetorizar o prompt recebido em tempo de execução, o que reduz a necessidade de escrever funções especiais para fazer o mesmo.

Copilot Studio também suporta a utilização da funcionalidade ranker semântico. Esta funcionalidade também precisa de ser configurada no Azure AI Search antes de adicionar a ligação no Copilot Studio. Para mais informações, veja Como começar com o classificador semântico.

Nota

Deve adicionar a Pesquisa de IA do Azure através de uma ligação de dados formal. Não configures manualmente um endpoint e uma chave API.

Se criar uma ligação Azure AI Search não suportada, o Copilot Studio pode armazenar uma ligação de dados defeituosa que impede o carregamento do diálogo de ligação do Azure AI Search. Quando isto acontece, o diálogo pode aparecer brevemente e depois falhar com um erro. O Copilot Studio atualmente não fornece uma interface para eliminar uma ligação de dados do Azure AI Search avariada. Como as ligações de dados são geridas ao nível do ambiente, esta questão pode afetar todos os agentes.

Para recuperar a ligação, reinicie o acesso externo do agente ou apague e recrie o agente afetado. Ao voltar a adicionar o Azure AI Search, utilize Fontes de Dados → Azure AI Search com autenticação Entra ID, e não as chaves API.

  1. Abra o agente.

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

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

  4. Selecione Azure AI Search.

  5. Selecione Criar nova ligação.

  6. Selecione o Tipo de autenticação. Tem as seguintes opções:

    • Chave de Acesso
    • Autenticação de Certificados de Cliente
    • Principal de serviço (aplicação do Microsoft Entra ID)
    • Microsoft Entra ID Integrado

  7. Introduza os dados necessários para o tipo de autenticação. Para autenticação baseada em chaves, conforme descrito na secção de configuração anterior, introduza o URL do endpoint Azure AI Search e a Chave de Administração Azure AI Search.

  8. Selecione Criar para concluir a ligação. Aparece uma marca de verificação verde para confirmar a ligação.

  9. Selecione Avançar.

  10. Insira o índice vetorial Azure AI Search que será usado. Só pode ser adicionado um índice vetorial.

  11. Selecione Adicionar ao agente para completar a ligação.

Depois de adicionar a ligação, aparece na tabela de fontes de conhecimento. O estado é mostrado como Em progresso enquanto Copilot Studio indexa os metadados nas tabelas. Depois de concluída a indexação, o estado é atualizado para Pronto, e pode começar a testar a fonte de conhecimento. Durante os testes, pode verificar que as referências corretas foram invocadas ao rever os ficheiros e citações mencionadas pelo agente.

Citações de retorno

Para devolver citações ao usar Azure AI Search no Copilot Studio, inclua um campo 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 o campo que contém um link URL completo como a citação. Para mais informações, consulte Indexar o conteúdo e os metadados dos ficheiros usando Azure AI Search

Nota

Ao configurar citações no Azure AI Search, certifique-se de que os utilizadores do seu agente têm as permissões necessárias para aceder às fontes de dados para onde as citações apontam. Por exemplo, se adicionar um URL no índice de pesquisa que aponte para um site ou uma base de dados de conhecimento, os utilizadores devem aceder a essas fontes. Se o URL apontar para uma origem de dados restrita, os utilizadores não podem aceder às citações geradas.

Suporte à Virtual Network

O Copilot Studio suporta índices Azure AI Search configurados para redes virtuais. Esta configuração permite-lhe usar um ponto final privado para ligar de forma segura os seus índices de pesquisa.

Para instruções sobre como configurar o endpoint, veja Criar um Endpoint Privado para Azure AI Search

Configure o suporte para Rede Virtual no ambiente do Power Platform, veja Configurar suporte para a Rede Virtual no Power Platform.

No Copilot Studio, siga os passos para completar a configuração da conexão.

  • Last updated on