Copilot Studio: conhecimento do SharePoint funciona para você, mas não para outros usuários – uma checklist
By Mirko Peters ·
Seu agente do Copilot Studio responde com base no SharePoint nos seus próprios testes, mas os colegas recebem a mensagem de fallback. Verifique autenticação, permissões, índice de pesquisa, arquivos protegidos e configurações do locatário nesta ordem.
Automatically translated with AI from the original post. Read the English original
Você criou um agente do Copilot Studio, conectou um site ou uma biblioteca do SharePoint e testou. Ele responde bem. Depois, um colega abre o mesmo agente no Teams ou no Microsoft 365 Copilot e recebe a mensagem genérica de fallback, como "I'm not sure how to help with that" ou "Sorry, I am not able to find a related topic".
Pontos-chave
- O conhecimento do SharePoint é executado como a pessoa que está conversando, não como o criador; por isso, um teste feito pelo criador prova muito pouco sobre os demais usuários.
- Um usuário sem acesso de leitura, uma entrada ausente no índice de pesquisa ou um arquivo criptografado terminam no mesmo resultado silencioso: nenhuma resposta e nenhum erro.
- Teste a mesma pergunta como o usuário afetado no Microsoft 365 Copilot Chat para separar um problema do agente de um problema de permissão ou de índice.
- Autenticação, Pesquisa Restrita do SharePoint e limites de tamanho de arquivo são verificações rápidas que descartam grupos inteiros de causas.
Três tópicos do Microsoft Q&A e do Microsoft Community Hub, entre março e setembro de 2026, descrevem exatamente isso. Em um deles, um testador com permissão de leitura apenas na pasta recebia somente respostas de fallback. Em outro, um usuário com acesso de leitura e gravação, uma licença do Copilot e um lugar na lista de permitidos do agente aprovou a solicitação de permissão do SharePoint e, mesmo assim, não obteve nada. No terceiro, listas do SharePoint adicionadas como conhecimento exibiam um erro sem mensagem.
Este artigo é uma checklist montada a partir desses tópicos e da página atual de solução de problemas da Microsoft Learn sobre conhecimento do SharePoint. Não é um procedimento oficial da Microsoft. Quando os tópicos e a Learn divergirem, a Learn prevalece, e eu deixo isso claro.
Sintomas
- O criador recebe respostas corretas no painel de teste. Os demais usuários recebem a mensagem de fallback.
- Arquivos enviados diretamente ao agente funcionam para o usuário afetado, mas a fonte do SharePoint não.
- A fonte de conhecimento aparece como pronta e não há nenhum erro em lugar algum.
- Nada útil aparece na exibição de atividades para o usuário afetado.
Por que a falha acontece silenciosamente
A Microsoft Learn afirma que o conhecimento do SharePoint segue o recorte de segurança do Microsoft 365. O usuário precisa de pelo menos acesso de leitura e, sem ele, o agente se comporta como se o documento não existisse. Não há erro. O mesmo resultado silencioso aparece quando o documento não está no índice de pesquisa, quando está criptografado ou quando a configuração de autenticação não tem os escopos necessários.
O agente também não lê sua biblioteca arquivo por arquivo. A Learn diz que ele usa apenas os três primeiros resultados do Microsoft Search para escrever uma resposta. Se a pesquisa não retornar o arquivo certo para aquele usuário, não há nada para resumir.
Etapa 1: reproduzir como o usuário afetado
- Peça ao usuário afetado que abra o arquivo exato pelo endereço dele no SharePoint. Se isso falhar, o problema está nas permissões, não no agente.
- Faça a mesma pergunta, com o mesmo usuário, no Microsoft 365 Copilot Chat. A Learn recomenda esse teste. Se o Copilot Chat também não encontrar nada, a causa está em permissões ou indexação. Se o Copilot Chat funcionar e o agente não, continue com a etapa 2 e as seguintes.
- Peça ao usuário que digite no campo de pesquisa do SharePoint uma frase exclusiva que esteja dentro do arquivo. Use um trecho do corpo do documento, e não apenas o nome do arquivo.
Etapa 2: verifique como o agente autentica os usuários
A Learn informa que agentes criados no Copilot Studio e no Teams usam Autenticar com a Microsoft por padrão, e que as respostas generativas do SharePoint então são executadas em nome do usuário que está conversando. Com Nenhuma autenticação, o agente não recupera nenhuma informação do SharePoint.
Uma resposta da comunidade, marcada como solução em um tópico sobre listas do SharePoint, relatou que o acesso ao SharePoint e ao OneDrive era bloqueado com a autenticação definida como Nenhuma autenticação, e que funcionou após a mudança para Autenticar com a Microsoft ou autenticação manual.
- No Copilot Studio, abra o agente e acesse as configurações de autenticação dele.
- Escolha Autenticar com a Microsoft, a menos que você precise de uma configuração personalizada do Microsoft Entra ID.
- Se você usar Autenticar manualmente, adicione os escopos
Sites.Read.AlleFiles.Read.Alljunto com os já existentesprofileeopenid. No registro do aplicativo, adicione as permissões delegadasSites.Read.AlleFiles.Read.Alle conceda o consentimento. - Publique novamente. No caso do Teams, a Learn observa que as alterações podem levar algumas horas, e os usuários podem digitar "start over" para reiniciar com a versão mais recente.
A Learn também lista dois limites: respostas generativas do SharePoint não estão disponíveis para usuários convidados em aplicativos com single sign-on, e chats em grupo ou mensagens de canal no Teams ainda não são compatíveis com o caminho sem autenticação manual.
Etapa 3: verifique as permissões no conteúdo exato
Conceda aos usuários pelo menos acesso de leitura aos sites e arquivos da fonte de conhecimento. A Learn faz um alerta de que você não deve depender apenas da herança de permissões no nível da pasta. No tópico dos testadores, a resposta da equipe da Microsoft disse que importam as permissões na pasta ou nos arquivos específicos, e não apenas no site.
O agente pesquisa o endereço que você registrou e tudo o que está abaixo dele. Ele não examina pastas superiores, pastas irmãs nem outros sites, a menos que você os adicione como fontes separadas.
Etapa 4: verifique o índice de pesquisa
A Learn informa que arquivos enviados recentemente podem ainda não estar indexados, e algumas configurações podem impedir que um site apareça na pesquisa.
- Use o teste de palavra-chave da etapa 1. Se o arquivo não aparecer para o usuário afetado, a causa está na indexação ou nas configurações de pesquisa.
- Um administrador do site do SharePoint pode solicitar uma nova indexação: abra Informações do site, depois Exibir todas as configurações do site, depois Pesquisa e disponibilidade offline, e selecione Reindexar site.
- Um moderador da equipe externa da Microsoft, no tópico do Microsoft Q&A de março de 2026, sugeriu verificações adicionais. Confirme se a configuração do site para aparecer nos resultados de pesquisa está definida como sim, se a biblioteca não está configurada para ficar fora do índice e se a segmentação de público na biblioteca está desativada. A resposta também sugeriu aguardar até 24 horas após alterações de acesso. Esses pontos vêm de uma resposta em fórum sem link para documentação, então trate-os como informações relatadas em um tópico da comunidade, não como confirmadas na Microsoft Learn.
Etapa 5: procure conteúdo protegido ou não compatível
- Criptografia: a Learn informa que o agente respeita os rótulos de confidencialidade para controle de acesso, mas não consegue ler conteúdo criptografado. Isso inclui rótulos que aplicam criptografia, Double Key Encryption e arquivos protegidos por senha. Um arquivo assim pode aparecer como pronto e, ainda assim, não retornar nenhuma resposta. Para testar, pergunte sobre um texto que só aparece em arquivos não protegidos da mesma fonte.
- Tipos de página: páginas modernas funcionam. Páginas com componentes do SharePoint Framework não são compatíveis, e o conteúdo de páginas clássicas
.aspxnão é usado. - Tamanho do arquivo: a Learn indica 7 MB para locatários sem licença do Microsoft 365 Copilot e 200 MB para quem tem a licença, junto com uma configuração correspondente chamada tenant graph grounding with semantic search. Arquivos maiores podem aparecer na pesquisa, mas não são processados.
- Renomeações: a Learn alerta que renomear um site ou uma pasta pode quebrar o link da fonte. Gere um novo link, atualize a fonte no agente e verifique as permissões no novo local.
Etapa 6: verificar as configurações do locatário
Pesquisa restrita do SharePoint: se ela estiver ativada para o locatário, a Learn informa que o conhecimento do SharePoint fica bloqueado, independentemente de como o agente está configurado. O administrador do SharePoint precisa desativá-la ou adicionar os sites à lista de permitidos. Veja Restricted SharePoint Search.
Listas: para listas do SharePoint, a Learn exige que a pesquisa do Dataverse esteja ativada no ambiente do agente. Ela também informa que listas com mais de 35.000 linhas reduzem a qualidade e que você deve usar no máximo 10 listas por agente. Uma resposta de setembro de 2026 no tópico sobre listas menciona o mesmo requisito de pesquisa do Dataverse. Outra resposta nesse tópico sugeriu recriar a lista como uma tabela do Dataverse como solução provisória até que uma correção seja lançada. A resposta não confirma que isso funcionou e não é uma correção.
Filtros e configurações de tópico: verifique os filtros da fonte (título, autor, modificado por, data de modificação) em Conhecimento, depois na fonte, depois em Editar e, em seguida, em Configurações avançadas. Em um tópico com um nó de respostas generativas, a opção de pesquisar somente as fontes selecionadas significa que o agente não recorrerá a outro conhecimento.
Etapa 7: moderação de conteúdo
A Learn lista a moderação de conteúdo como uma possível causa. Quando ela bloqueia uma resposta, você não vê nenhuma resposta nem qualquer indício. Só é possível vê-la nos logs se o agente enviar telemetria para o Application Insights. Se as perguntas forem inofensivas e tudo acima estiver correto, configure a telemetria e procure o resultado filtrado, usando a consulta indicada na página da Learn.
Colete evidências antes de abrir um chamado
Se tudo isso estiver correto, anote:
- o ID da conversa no chat do usuário afetado,
- a pergunta exata e o horário em UTC,
- o cliente (Teams, aplicativo Copilot ou web),
- o ID do ambiente,
- o resultado do teste do Copilot Chat da etapa 1.
O que os tópicos mostraram e o que não mostraram
- Dois dos tópicos terminaram sem uma correção confirmada. No tópico dos testadores, a primeira resposta (de um colaborador externo da Microsoft) era uma lista de causas prováveis, nenhuma resposta foi marcada como aceita e quem perguntou não voltou para informar o resultado. No tópico de março de 2026, quem perguntou também não voltou para informar o resultado.
- O tópico sobre listas tem uma marca de solução em uma resposta com orientações gerais de configuração. Quem perguntou não confirmou que funcionou.
- Em agosto de 2026, outros dois tópicos relataram que agentes que funcionavam pararam de usar o conteúdo do SharePoint de repente. Em um deles, sobre um arquivo do Excel no SharePoint, várias pessoas relataram que o problema começou na quarta-feira, 12 de agosto, e um colaborador externo da Microsoft abriu um bug interno em 18 de agosto como uma possível regressão do serviço. O outro tópico foi publicado em 19 de agosto e relatou que agentes existentes e recém-criados ignoravam documentos do SharePoint. Nesse tópico, quem perguntou escreveu em 20 de agosto que a Microsoft havia corrigido um problema interno. Trata-se de uma informação de segunda mão, e não de uma declaração da Microsoft, e outro usuário relatou o mesmo problema em 26 de agosto. Se o seu caso afeta todos os usuários e todos os agentes, verifique primeiro a integridade do serviço. Esse padrão é diferente do que está descrito nesta lista de verificação.
Relacionados
Fontes
- Microsoft Learn: SharePoint knowledge sources don't return results
- Microsoft Learn: Adicionar o SharePoint como fonte de conhecimento
- Microsoft Q&A: Testadores não conseguem obter respostas do agente do Copilot no ambiente de Stage (abril de 2026)
- Microsoft Q&A: Outros usuários não conseguem conversar com o agente do Copilot usando a base de conhecimento do SharePoint (março de 2026)
- Microsoft Community Hub: Listas do SharePoint com erro no Copilot Studio (abril de 2026)
- Microsoft Q&A: O Copilot Studio não consegue usar documentos do SharePoint como fontes de conhecimento (agosto de 2026)
- Microsoft Q&A: Fonte de conhecimento em Excel do SharePoint não retorna mais resultados (agosto de 2026)