Agente do Copilot Studio não consegue ler fonte de conhecimento do SharePoint: correção

Você criou um agente no Copilot Studio e o conectou a uma fonte de conhecimento do SharePoint, mas o agente não retorna respostas ou diz que não encontra informações. Isso acontece quando o agente não tem permissão para ler o site do SharePoint, a fonte está mal configurada ou o formato do conteúdo não é compatível. Este artigo explica as três causas raiz e fornece correções passo a passo para restaurar o acesso aos dados do SharePoint para seu agente do Copilot Studio.

Por que os agentes do Copilot Studio falham ao ler fontes de conhecimento do SharePoint

Os agentes do Copilot Studio usam o Microsoft Graph para buscar conteúdo do SharePoint. Três condições devem ser atendidas: o agente deve estar autenticado como um usuário ou entidade de serviço com acesso ao site do SharePoint, a fonte do SharePoint deve ser um tipo de conteúdo compatível e o agente deve estar configurado para usar o Microsoft Entra ID para autenticação. Se alguma dessas falhar, o agente não consegue ler a fonte de conhecimento.

A causa raiz mais comum é a permissão. Quando você adiciona uma fonte de conhecimento do SharePoint no Copilot Studio, o agente não herda permissões automaticamente. Você deve conceder explicitamente à entidade de serviço do agente ou ao usuário autenticado acesso ao site do SharePoint e seus documentos. Sem isso, o Graph retorna um erro 403 Forbidden silenciosamente, e o agente responde com “Não consigo encontrar essa informação.”

Tipos de conteúdo não compatíveis

O Copilot Studio indexa apenas bibliotecas de documentos padrão e páginas wiki. Ele não indexa itens de lista do SharePoint, colunas de dados externos ou arquivos armazenados fora de uma biblioteca de documentos. Se sua fonte de conhecimento apontar para uma lista ou uma biblioteca com formatos de arquivo não compatíveis, como .zip ou .exe, o agente vê uma fonte vazia.

Incompatibilidade de modo de autenticação

Os agentes do Copilot Studio podem usar dois modos de autenticação: “Autenticar com Microsoft”, que usa a própria entidade de serviço do agente, ou “Site personalizado”, que requer um registro de aplicativo no Microsoft Entra ID. Se o agente estiver configurado como “Sem autenticação”, as chamadas do Graph são bloqueadas completamente.

Etapas para corrigir o acesso do agente do Copilot Studio ao SharePoint

Siga estas etapas em ordem. Teste o agente após cada etapa para confirmar a correção.

1. Verifique a configuração de autenticação do agente
   Abra o Copilot Studio. Vá para Configurações > Segurança > Autenticação. Selecione “Autenticar com Microsoft” se quiser que o agente use sua própria identidade. Para agentes de produção, selecione “Site personalizado” e registre um aplicativo do Microsoft Entra ID com as permissões do Graph necessárias. Não deixe a autenticação definida como “Sem autenticação” ao usar fontes do SharePoint.
2. Conceda ao agente acesso ao site do SharePoint
   Abra o site do SharePoint em um navegador. Clique no ícone de engrenagem e selecione Permissões do site > Compartilhar site. Na caixa de diálogo, digite o nome da entidade de serviço do agente do Copilot Studio. O nome da entidade de serviço é exibido no Copilot Studio em Configurações > Canais > Microsoft Teams > Gerenciar. Geralmente se parece com “copilot-studio-@.onmicrosoft.com”. Atribua o nível de permissão Leitura. Clique em Compartilhar.
3. Verifique a URL da fonte de conhecimento
   No Copilot Studio, vá para Conhecimento > Adicionar fonte de conhecimento > SharePoint. Cole a URL completa do site do SharePoint ou da biblioteca de documentos. Não inclua filtros ou parâmetros de consulta. Para uma biblioteca de documentos, use o formato de URL: https://.sharepoint.com/sites//Shared%20Documents. Para um site, use a URL raiz: https://.sharepoint.com/sites/.
4. Confirme o conteúdo compatível
   Certifique-se de que a fonte do SharePoint contenha apenas tipos de arquivo compatíveis: .docx, .pptx, .xlsx, .pdf, .txt e .html. Remova ou mova arquivos não compatíveis, como .zip, .exe, .msg ou .csv, para uma biblioteca separada. O Copilot Studio também indexa páginas wiki do SharePoint. Itens de lista em uma lista não são indexados.
5. Reindexe a fonte de conhecimento
   Após alterar permissões ou conteúdo, remova a fonte de conhecimento do SharePoint do agente. Salve o agente. Adicione a fonte novamente com a URL correta. O Copilot Studio reindexa o conteúdo em até 15 minutos. Para forçar uma atualização, vá para Conhecimento, selecione a fonte e clique em Sincronizar.
6. Teste com uma consulta específica
   Abra o painel de teste do agente. Faça uma pergunta que corresponda a um título de documento conhecido ou conteúdo na biblioteca do SharePoint. Por exemplo, se você tiver um arquivo chamado “Política de Integração.docx”, pergunte “Qual é a política de integração?” Se o agente ainda não retornar resposta, inspecione o status da fonte em Conhecimento. Um status vermelho indica uma falha de permissão ou indexação.

Se o agente do Copilot Studio ainda não conseguir ler o SharePoint

Se as principais etapas de correção não resolverem o problema, verifique esses padrões adicionais de falha.

Erro “A fonte de conhecimento não retornou dados”

Este erro aparece no painel de status da fonte de conhecimento do Copilot Studio. A causa geralmente é uma URL de site incorreta. Verifique se a URL não inclui um caminho de arquivo ou string de consulta. Confirme também que o site do SharePoint não é um site de comunicação com acesso restrito. Conceda ao agente acesso ao site conforme descrito na Etapa 2.

O agente retorna respostas genéricas em vez de dados do SharePoint

Isso indica que o agente consegue se conectar ao SharePoint, mas não consegue ler os arquivos específicos. Verifique se os documentos não estão check-out para outro usuário. Documentos com check-out são invisíveis para o Graph. Confirme também que os documentos não estão em uma pasta com permissões exclusivas. O agente deve ter acesso de Leitura a todas as pastas e arquivos da biblioteca.

A fonte do SharePoint mostra “Sincronizando” indefinidamente

Isso acontece quando o site do SharePoint é muito grande ou tem muitas pastas aninhadas. O Copilot Studio indexa até 10.000 itens por fonte. Se a biblioteca exceder esse limite, remova a fonte e adicione uma URL de biblioteca de documentos mais específica em vez da raiz do site. Por exemplo, use https://.sharepoint.com/sites//Shared%20Documents/Políticas%20RH em vez da raiz do site.

O agente falha após alterações no registro do aplicativo do Microsoft Entra ID

Se você usar autenticação personalizada, verifique se o registro do aplicativo tem a permissão delegada “Sites.Read.All” ou “Sites.ReadWrite.All” no Microsoft Graph. Conceda também consentimento administrativo para as permissões. Sem consentimento, o agente não pode autenticar no SharePoint. Vá para Microsoft Entra ID > Registros de aplicativo > Seu aplicativo > Permissões de API e clique em Conceder consentimento administrativo.

Item	Autenticar com Microsoft	Site personalizado
Descrição	O agente usa sua própria identidade de entidade de serviço interna	O agente usa um aplicativo do Microsoft Entra ID que você registra
Tempo de configuração	Minutos	Horas
Permissões do Graph necessárias	Nenhuma para configurar	Permissão delegada Sites.Read.All
Melhor para	Testes e equipes pequenas	Agentes de produção com marca personalizada ou SSO
Limitação	Não pode ser usado com fontes de dados personalizadas fora do Microsoft 365	Requer consentimento administrativo e tratamento de renovação de token

Agora você pode diagnosticar e corrigir falhas de acesso do agente do Copilot Studio ao SharePoint verificando autenticação, permissões e tipos de conteúdo. Comece verificando o modo de autenticação do agente e concedendo acesso de Leitura ao site do SharePoint. Se os problemas persistirem, restrinja a URL da fonte de conhecimento a uma biblioteca de documentos específica e confirme que todos os arquivos são compatíveis e não estão com check-out. Para cenários avançados, revise as permissões do registro do aplicativo do Microsoft Entra ID e certifique-se de que o consentimento administrativo foi concedido.