Fonte de Conhecimento do SharePoint no Copilot Studio Não Retorna Resultados: Solução

Ao configurar uma fonte de conhecimento do SharePoint no Copilot Studio, o esperado é que seu copiloto personalizado recupere documentos e respostas relevantes dos sites do SharePoint especificados. No entanto, você pode encontrar uma situação em que a fonte de conhecimento retorna zero resultados, mesmo que existam documentos nos locais do SharePoint adicionados. Esse problema geralmente ocorre devido a configurações incorretas de permissão, atrasos na indexação ou configuração errada da fonte de dados no ambiente do Copilot Studio. Este artigo explica as causas raiz por trás de resultados vazios da fonte de conhecimento do SharePoint e fornece correções passo a passo para resolver o problema.

Por que a Fonte de Conhecimento do SharePoint no Copilot Studio Não Retorna Resultados

O Copilot Studio usa o índice de pesquisa do SharePoint para consultar documentos dos sites que você adiciona como fontes de conhecimento. Quando a fonte de conhecimento retorna zero resultados, a causa raiz mais comum é que a entidade de serviço do Copilot Studio não tem permissões suficientes para ler o conteúdo do SharePoint. Outra causa frequente é que o site do SharePoint ou a biblioteca de documentos específica não está indexada pela pesquisa do SharePoint, o que pode acontecer se o site for um site de comunicação moderno sem uma biblioteca de documentos padrão ou se o site foi excluído da pesquisa por um administrador. Além disso, se a fonte de conhecimento foi adicionada recentemente, o processo de indexação pode não ter sido concluído, levando a resultados vazios temporários. Por fim, a configuração incorreta da própria fonte de conhecimento, como apontar para uma URL de site que não existe ou usar um tipo de site não suportado, pode causar o problema.

Requisitos de Permissão para Fontes de Conhecimento do SharePoint

Para que o Copilot Studio leia o conteúdo do SharePoint, a entidade de serviço chamada Copilot Studio deve ter pelo menos acesso de Leitura ao site do SharePoint e suas bibliotecas de documentos. Essa permissão geralmente é concedida automaticamente ao adicionar a fonte de conhecimento pela interface do Copilot Studio, mas pode ser necessária intervenção manual em algumas configurações de locatário. Se sua organização tiver políticas de permissão restritas, a entidade de serviço pode ser bloqueada.

Dependência do Índice de Pesquisa do SharePoint

O Copilot Studio não consulta diretamente os bancos de dados do SharePoint. Em vez disso, ele envia consultas de pesquisa para o índice de pesquisa do SharePoint. Se o site do SharePoint não estiver indexado, ou se os documentos estiverem armazenados em um local excluído da pesquisa, a fonte de conhecimento não retornará resultados. Cenários comuns incluem bibliotecas de documentos com permissões exclusivas que não são indexadas ou sites configurados para bloquear rastreadores de pesquisa.

Passos para Corrigir a Fonte de Conhecimento do SharePoint que Não Mostra Resultados

Siga estes passos em ordem para diagnosticar e resolver o problema. Após cada etapa, teste a fonte de conhecimento fazendo uma pergunta ao seu copiloto relacionada ao conteúdo do SharePoint.

1. Verifique a URL do Site do SharePoint
   Abra o Copilot Studio e navegue até o copiloto que usa a fonte de conhecimento do SharePoint. Vá para Configurações > Conhecimento. Encontre a entrada da fonte de conhecimento do SharePoint e anote a URL do site. Abra essa URL em um navegador para confirmar que o site existe e contém documentos. Se o site for um site de equipe moderno, certifique-se de que ele tenha uma biblioteca de Documentos padrão com arquivos. Se o site for um site de comunicação, verifique se existe uma biblioteca de documentos e se ela tem conteúdo.
2. Verifique as Permissões do Site do SharePoint para a Entidade de Serviço do Copilot Studio
   Na central de administração do Microsoft 365, vá para SharePoint > Sites. Selecione o site usado como fonte de conhecimento. Clique em Permissões e depois em Configurações avançadas de permissão. Na seção Níveis de permissão, clique em Conceder permissões. Adicione a entidade de serviço Copilot Studio como membro com nível de permissão Leitura. Se você não encontrar a entidade de serviço no seletor de pessoas, digite o nome completo: Copilot Studio. Aguarde 5 minutos para a alteração de permissão se propagar e teste a fonte de conhecimento novamente.
3. Confirme o Status de Indexação da Pesquisa do SharePoint
   No site do SharePoint, vá para Configurações do site > Pesquisa e disponibilidade offline. Certifique-se de que Permitir que este site apareça nos resultados da pesquisa esteja definido como Sim. Para a biblioteca de documentos específica, vá para Configurações da biblioteca > Configurações avançadas e confirme que Permitir que itens desta biblioteca de documentos apareçam nos resultados da pesquisa esteja definido como Sim. Se essas configurações foram alteradas, aguarde até 15 minutos para o índice de pesquisa ser atualizado e teste a fonte de conhecimento.
4. Remova e Adicione Novamente a Fonte de Conhecimento do SharePoint
   No Copilot Studio, vá para Configurações > Conhecimento. Exclua a fonte de conhecimento do SharePoint existente. Clique em Adicionar fonte de conhecimento e selecione SharePoint. Digite a URL exata do site novamente. Se sua organização usar vários locatários do SharePoint, certifique-se de selecionar o locatário correto. Após adicionar, aguarde 10 minutos para o processo de indexação ser concluído e teste o copiloto.
5. Verifique as Configurações de Pesquisa do SharePoint em Todo o Locatário
   Na central de administração do Microsoft 365, vá para SharePoint > Pesquisa. Clique em Gerenciar esquema de pesquisa e certifique-se de que nenhuma propriedade gerenciada personalizada esteja bloqueando o conteúdo padrão. Além disso, verifique Origens de resultados da pesquisa para confirmar que a origem padrão Resultados locais do SharePoint está ativa e inclui o site. Se seu locatário usar uma origem de resultados de pesquisa personalizada, adicione o site a essa origem.
6. Verifique as Limitações de Tipo de Conteúdo
   O Copilot Studio pode indexar arquivos em formatos comuns como DOCX, PDF, PPTX e TXT. Se sua biblioteca do SharePoint contiver apenas tipos de arquivo não suportados, como imagens, vídeos ou arquivos ZIP, a fonte de conhecimento não retornará resultados. Verifique se existem pelo menos alguns documentos em formatos suportados na biblioteca.

Se o Copilot Studio Ainda Não Mostrar Resultados Após a Correção Principal

Se a fonte de conhecimento ainda retornar resultados vazios após concluir as etapas acima, investigue estes cenários adicionais.

Copilot Studio Não Retorna Resultados para uma Biblioteca de Documentos Específica

Se você adicionou um caminho de biblioteca de documentos específico em vez do site inteiro, verifique se a biblioteca não está excluída da pesquisa. No SharePoint, vá para Configurações da biblioteca > Configurações avançadas e confirme que Permitir que itens desta biblioteca de documentos apareçam nos resultados da pesquisa está definido como Sim. Além disso, verifique se a biblioteca tem permissões exclusivas que bloqueiam a entidade de serviço do Copilot Studio. Se necessário, quebre a herança de permissões e conceda acesso de Leitura à entidade de serviço.

Fonte de Conhecimento Funciona em um Locatário, mas Não em Outro

Esse problema aponta para uma diferença de configuração no nível do locatário. Compare as configurações de pesquisa do SharePoint entre os locatários que funcionam e os que não funcionam. Preste atenção especial a Central de administração do SharePoint > Pesquisa > Origens de resultados e Esquema de pesquisa. Além disso, verifique se a entidade de serviço do Copilot Studio não está bloqueada por uma política de acesso condicional no locatário que não funciona. Trabalhe com o administrador do locatário para revisar as permissões da entidade de serviço no Microsoft Entra ID.

Fonte de Conhecimento Retorna Resultados na Visualização, mas Não na Produção

Se seu copiloto foi publicado e a fonte de conhecimento funciona no painel de teste do Copilot Studio, mas não no ambiente de produção, o problema provavelmente está relacionado à autenticação. No Copilot Studio, vá para Configurações > Segurança > Autenticação. Certifique-se de que o método de autenticação esteja definido como Microsoft Entra ID ou Sem autenticação, dependendo da sua implantação. Se você usar Microsoft Entra ID, confirme se o registro do aplicativo tem as permissões de API corretas para o SharePoint. Se você usar Sem autenticação, o copiloto usa as permissões da entidade de serviço que você configurou anteriormente, então verifique essas permissões novamente.

Fonte de Conhecimento do SharePoint no Copilot Studio vs Integração Manual com SharePoint

Item	Fonte de Conhecimento do Copilot Studio	Integração Manual com SharePoint via API
Esforço de configuração	Baixo — configurado através da interface gráfica	Alto — requer código personalizado e chamadas de API
Gerenciamento de permissões	Usa a entidade de serviço do Copilot Studio automaticamente	Requer criar e gerenciar manualmente uma entidade de serviço
Dependência de pesquisa	Depende do índice de pesquisa do SharePoint	Pode usar a API do Graph ou chamadas REST diretas do SharePoint
Conteúdo suportado	Documentos em bibliotecas em sites indexados	Qualquer conteúdo do SharePoint acessível via API
Escalabilidade	Limitado a 5 sites por copiloto	Sem limite embutido

Após concluir as etapas deste artigo, você deve conseguir ver documentos relevantes da sua fonte de conhecimento do SharePoint nas respostas do Copilot Studio. Se o problema persistir, considere usar o conector do Graph do SharePoint no Copilot Studio como alternativa, que contorna a dependência do índice de pesquisa. Como dica avançada, use a análise do Copilot Studio para revisar quais consultas retornaram zero resultados e cruzá-las com os logs de pesquisa do SharePoint para identificar conteúdo não indexado.