Agentes do Microsoft Copilot: Como Eles Descobrem Fontes de Conhecimento

Ao criar um agente Copilot no Microsoft Copilot Studio, ele precisa encontrar as informações certas para responder perguntas dos usuários. Sem um método claro para descobrir fontes de conhecimento, o agente pode retornar respostas desatualizadas, incompletas ou incorretas. Este artigo explica o processo técnico que os agentes Copilot usam para localizar e extrair dados do Microsoft Graph, SharePoint e outros serviços conectados. Você aprenderá como o pipeline de descoberta funciona e como configurá-lo para obter resultados precisos.

Como os Agentes Copilot Descobrem Fontes de Conhecimento

Um agente Copilot não pesquisa a internet ou todo o seu locatário do Microsoft 365 por padrão. Em vez disso, ele usa um pipeline de descoberta que começa com as fontes de conhecimento configuradas do agente. O pipeline tem três estágios principais: indexação, recuperação e fundamentação. No estágio de indexação, o agente escaneia as fontes definidas e cria um índice vetorial pesquisável. No estágio de recuperação, quando um usuário faz uma pergunta, o agente converte a consulta em um embedding e encontra os trechos mais semelhantes no índice. No estágio de fundamentação, o agente verifica o conteúdo recuperado em relação às permissões do usuário e à configuração do agente para decidir o que incluir na resposta.

Fontes de Conhecimento Suportadas pelos Agentes Copilot

Os agentes Copilot podem descobrir conhecimento dos seguintes tipos de fonte:

• Dados do Microsoft Graph: E-mails, arquivos, eventos de calendário, mensagens do Teams e sites do SharePoint aos quais o usuário tem acesso. O agente usa a API de pesquisa do Microsoft Graph para encontrar esses dados.
• Sites e páginas do SharePoint: Coleções de sites específicas do SharePoint, bibliotecas de documentos ou páginas que você adiciona ao agente. O agente indexa o conteúdo e o usa para fundamentação.
• Pastas do OneDrive: Pastas pessoais do OneDrive compartilhadas com o usuário. O agente respeita as permissões de compartilhamento.
• URLs da web: Páginas da web públicas ou autenticadas que você especificar. O agente rastreia essas páginas e indexa seu conteúdo de texto.
• Conectores do Microsoft Graph: Serviços externos como ServiceNow, Salesforce, Jira ou bancos de dados SQL. Você configura um conector no centro de administração do Microsoft 365, que indexa os dados externos no índice de pesquisa do Microsoft 365.
• Conjuntos de dados personalizados: Arquivos CSV, JSON ou PDF carregados diretamente no agente no Copilot Studio. Esses arquivos são armazenados no armazenamento interno do agente.

O Processo de Descoberta em Detalhes

Quando um usuário envia uma mensagem para o agente, as seguintes etapas ocorrem:

1. Análise da consulta
   O agente usa um modelo de linguagem grande para entender a intenção do usuário e extrair entidades-chave, como nomes de projetos, datas ou tipos de documentos.
2. Seleção de fonte
   O agente verifica suas fontes de conhecimento configuradas. Se o agente tiver várias fontes, ele aplica um algoritmo de pontuação de relevância para escolher as fontes mais prováveis para a consulta.
3. Geração de embedding
   O agente converte a consulta em um embedding vetorial usando um modelo de embedding de texto. Esse embedding representa o significado semântico da consulta.
4. Pesquisa vetorial
   O agente pesquisa o índice vetorial das fontes selecionadas em busca de trechos de texto com embeddings semelhantes. O índice é construído durante o estágio de indexação usando o Azure AI Search.
5. Filtragem de permissões
   O agente verifica cada trecho recuperado em relação aos direitos de acesso do usuário. Se o usuário não tiver permissão de leitura em um arquivo, o agente descarta esse trecho.
6. Fundamentação e geração de resposta
   O agente passa os trechos filtrados para o modelo de linguagem junto com a consulta do usuário. O modelo gera uma resposta usando apenas o conteúdo fundamentado. O agente não usa seus próprios dados de treinamento para responder.

Etapas para Configurar Fontes de Conhecimento para um Agente Copilot

Para garantir que seu agente descubra as fontes corretas, siga estas etapas no Copilot Studio.

Adicionar Sites do SharePoint como Fontes de Conhecimento

1. Abra seu agente no Copilot Studio
   Vá para Copilot Studio e faça login com sua conta corporativa ou de estudante. Selecione o agente que deseja configurar.
2. Navegue até a guia Conhecimento
   No painel de navegação esquerdo, clique em Conhecimento. Isso abre a página de gerenciamento de fontes de conhecimento.
3. Adicione uma fonte do SharePoint
   Clique em Adicionar fonte de conhecimento e selecione SharePoint. Cole a URL do site do SharePoint que deseja incluir. Você pode adicionar vários sites repetindo esta etapa.
4. Salve e sincronize
   Clique em Salvar. O agente começa a indexar o conteúdo do SharePoint. O tempo de indexação depende da quantidade de conteúdo. Você pode monitorar o progresso na coluna Status de sincronização.

Adicionar URLs da Web como Fontes de Conhecimento

1. Abra a guia Conhecimento
   No Copilot Studio, vá para seu agente e clique em Conhecimento.
2. Selecione Site público
   Clique em Adicionar fonte de conhecimento e escolha Site público. Insira a URL completa do site que deseja indexar. O agente rastreará todas as páginas sob esse domínio.
3. Defina a profundidade do rastreamento
   Nas configurações, defina o número máximo de páginas a serem rastreadas. Uma profundidade de 50 páginas é típica para um site de documentação. Clique em Salvar.
4. Revise o conteúdo indexado
   Após a sincronização, você pode visualizar as páginas indexadas na guia Conhecimento. Remova quaisquer páginas que contenham informações irrelevantes.

Configurar Conectores do Microsoft Graph para Dados Externos

1. Vá para o centro de administração do Microsoft 365
   Abra o centro de administração do Microsoft 365 e faça login como administrador global ou administrador de pesquisa.
2. Abra o Microsoft Search
   No painel de navegação esquerdo, expanda Configurações e selecione Pesquisa e inteligência. Em seguida, clique em Fontes de dados.
3. Adicione um conector do Graph
   Clique em Adicionar conector e selecione o serviço que deseja conectar, como ServiceNow ou Salesforce. Siga o assistente do conector para autenticar e configurar a fonte de dados.
4. Atribua o conector ao seu agente
   No Copilot Studio, vá para a guia Conhecimento e clique em Adicionar fonte de conhecimento. Selecione Conector do Microsoft Graph e escolha o conector que você criou. Salve a configuração.

Se o Agente Não Consegue Encontrar o Conhecimento Correto

O Agente Não Retorna Resultados para um Arquivo Conhecido

O agente pode não encontrar um arquivo se ele não estiver incluído em nenhuma fonte de conhecimento configurada. Verifique se o site do SharePoint pai do arquivo ou a pasta do OneDrive foi adicionada ao agente. Também verifique se o arquivo não está excluído por uma política de retenção ou rótulo de sensibilidade. Vá para a guia Conhecimento e confirme se o status de sincronização da fonte mostra Sincronizado.

O Agente Retorna Resultados de Fontes Não Autorizadas

Se o agente extrair dados de uma fonte que você não pretendia, a configuração de fundamentação pode estar muito ampla. Abra as configurações do agente e navegue até Fundamentação. Ative a opção Limitar a fontes de conhecimento selecionadas. Isso força o agente a usar apenas as fontes que você adicionou explicitamente. Sem essa configuração, o agente pode recorrer a todo o índice de pesquisa do Microsoft 365 para o usuário.

O Agente Ignora uma Fonte de Conector do Graph

Um conector do Graph pode não aparecer na lista de fontes de conhecimento do agente se não foi atribuído corretamente. No Copilot Studio, vá para a guia Conhecimento e clique em Adicionar fonte de conhecimento. Se o conector estiver faltando, retorne ao centro de administração do Microsoft 365 e verifique se o conector está habilitado e tem dados indexados. Também confirme se as permissões do conector incluem os usuários que interagirão com o agente.

Item	Descoberta de Conhecimento do Agente Padrão	Descoberta de Conhecimento do Agente Personalizado
Descrição	Usa dados do Microsoft Graph para o usuário conectado	Usa fontes definidas pelo usuário, incluindo SharePoint, URLs da web e conectores do Graph
Escopo da fonte	Arquivos, e-mails e calendário do próprio usuário	Qualquer site do SharePoint, pasta do OneDrive, URL da web ou sistema externo
Modelo de permissão	Respeita as permissões existentes do Microsoft 365	Respeita as permissões existentes mais restrições no nível da fonte
Frequência de indexação	Quase em tempo real via Microsoft Graph	Configurável via agendamento de sincronização no Copilot Studio
Controle de fundamentação	Sem limite para fontes específicas	Pode limitar a fontes selecionadas via configurações de Fundamentação

Agora você entende como os agentes Copilot descobrem fontes de conhecimento por meio de indexação, pesquisa vetorial e fundamentação. Comece adicionando seus sites do SharePoint e URLs da web mais importantes à guia Conhecimento do agente. Em seguida, defina a opção de fundamentação para limitar o agente a essas fontes. Para dados externos, use conectores do Microsoft Graph e atribua-os ao agente no Copilot Studio.