Por que o Copilot não consegue ler meu arquivo do SharePoint mesmo com permissões
🔍 WiseChecker

Por que o Copilot não consegue ler meu arquivo do SharePoint mesmo com permissões

Você tem permissões totais para um arquivo do SharePoint, mas o Copilot se recusa a lê-lo. Esse problema geralmente ocorre porque o Copilot depende de configurações adicionais de acesso a dados além das permissões padrão de arquivo. A causa geralmente é um índice de pesquisa ausente, uma conexão com a API Graph bloqueada ou uma política restritiva de fonte de dados no centro de administração do Microsoft 365. Este artigo explica as causas técnicas e fornece correções passo a passo para resolver o problema.

Principais conclusões: Restaurando o acesso do Copilot a arquivos do SharePoint

  • Centro de administração do Microsoft 365 > Configurações > Copilot > Fontes de dados: Controla quais dados do Microsoft Graph o Copilot pode ler para respostas fundamentadas.
  • Site do SharePoint > Configurações do site > Pesquisa e disponibilidade offline: Garante que o arquivo seja indexado e descoberto pela Pesquisa da Microsoft.
  • Permissões da API Graph para o Copilot: Exige permissões delegadas para ler arquivos do SharePoint em nome do usuário conectado.

Por que o Copilot não consegue ler um arquivo do SharePoint mesmo com permissões adequadas

Quando você concede permissões diretas a um arquivo do SharePoint, o usuário pode abri-lo no navegador ou no aplicativo para desktop. No entanto, o Copilot acessa arquivos por meio da API Graph da Microsoft, que impõe camadas adicionais de controle. Os três fatores a seguir geralmente bloqueiam o Copilot mesmo quando as permissões de arquivo estão corretas.

Indexação de pesquisa e descoberta de conteúdo

O Copilot usa a Pesquisa da Microsoft para localizar arquivos. Se um site ou biblioteca de documentos do SharePoint não estiver configurado para permitir a indexação de pesquisa, o Copilot não encontrará o arquivo. O site deve estar configurado para permitir que o conteúdo apareça nos resultados da pesquisa. Mesmo que o usuário tenha permissões de leitura, um site que bloqueia a visibilidade na pesquisa impedirá o Copilot de ler o arquivo.

Políticas de fonte de dados do Copilot

O centro de administração do Microsoft 365 inclui uma página de configurações do Copilot que define quais fontes de dados o Copilot pode acessar. Um administrador pode restringir o Copilot a apenas sites indexados do SharePoint ou tipos específicos de dados do Microsoft Graph. Se o arquivo de destino estiver em um site não incluído nas fontes de dados permitidas, o Copilot não poderá lê-lo, independentemente das permissões do usuário.

Permissões delegadas da API Graph

O Copilot é executado sob a identidade do usuário conectado. O usuário deve ter as permissões delegadas corretas concedidas por meio de um registro de aplicativo ou das permissões padrão do Microsoft 365. Em alguns locatários, os administradores revogam ou limitam escopos da API Graph, como Sites.Read.All ou Files.Read.All. Sem esses escopos, o Copilot não pode buscar o conteúdo do arquivo por meio da API, mesmo que o arquivo em si esteja acessível via URL direto.

Etapas para restaurar o acesso do Copilot a um arquivo do SharePoint

Siga estas etapas em ordem. Cada etapa aborda uma das causas raiz descritas acima.

  1. Verifique as configurações de pesquisa do site do SharePoint
    Acesse o site do SharePoint onde o arquivo está armazenado. Selecione o ícone de engrenagem no canto superior direito. Escolha Informações do site e depois Exibir todas as configurações do site. Em Pesquisa, clique em Pesquisa e disponibilidade offline. Certifique-se de que o botão de opção Permitir que este site apareça nos resultados da pesquisa esteja selecionado. Clique em OK.
  2. Verifique as configurações de pesquisa da biblioteca de documentos
    Navegue até a biblioteca que contém o arquivo. Selecione o ícone de engrenagem e escolha Configurações da biblioteca. Em Configurações gerais, clique em Configurações avançadas. Na seção Pesquisa, confirme se Permitir que itens desta biblioteca de documentos apareçam nos resultados da pesquisa? está definido como Sim. Clique em OK.
  3. Reindexe o site ou a biblioteca
    Se as configurações de pesquisa foram alteradas, force uma reindexação. Volte para Pesquisa e disponibilidade offline nas configurações do site. Clique em Reindexar site. Para uma única biblioteca, vá em Configurações da biblioteca > Configurações avançadas > Reindexar biblioteca de documentos. Aguarde até 30 minutos para o índice ser atualizado.
  4. Confirme as políticas de fonte de dados do Copilot no centro de administração
    Faça login no centro de administração do Microsoft 365. Vá para Configurações > Copilot > Fontes de dados. Em Dados do Microsoft Graph, certifique-se de que SharePoint e OneDrive estejam ativados. Se sites específicos estiverem listados, verifique se o site que contém o arquivo está incluído. Adicione a URL do site se estiver faltando. Salve as alterações.
  5. Verifique as concessões de permissão da API Graph
    No centro de administração do Microsoft 365, vá para Configurações > Configurações da organização > Permissões da API Graph da Microsoft. Procure a permissão Sites.Read.All ou Files.Read.All concedida ao principal de serviço do Copilot. Se estiver faltando, um administrador deve conceder consentimento. Use o portal do Azure: navegue até Azure Active Directory > Registros de aplicativo > Todos os aplicativos > selecione o aplicativo do Copilot > Permissões de API. Adicione Microsoft Graph > Permissões delegadas > Sites.Read.All. Clique em Conceder consentimento do administrador.
  6. Teste com um arquivo diferente no mesmo site
    Crie um novo arquivo de texto na mesma biblioteca do SharePoint. Dê a si mesmo permissões de leitura. Peça ao Copilot para resumi-lo. Se o Copilot ler o novo arquivo, o arquivo original pode ter problemas de corrupção ou metadados. Faça o upload novamente do arquivo original.

Se o Copilot ainda não conseguir ler o arquivo após a correção principal

Alguns cenários exigem solução de problemas adicional. Abaixo estão os problemas restantes mais comuns e suas soluções.

O Copilot retorna saída genérica em vez de dados específicos do locatário

Isso geralmente indica que o Copilot está usando dados públicos da web em vez do conteúdo do SharePoint do seu locatário. No painel do Copilot, verifique o menu suspenso Fontes. Se mostrar Web em vez de Trabalho ou Organização, clique no menu suspenso e selecione Trabalho. Isso força o Copilot a pesquisar apenas dados do Microsoft Graph dentro do seu locatário.

O arquivo está em um rótulo de confidencialidade restrito

Os rótulos de confidencialidade do Microsoft Purview Information Protection podem impedir que o Copilot leia o conteúdo do arquivo, mesmo que o usuário tenha permissões de leitura. Abra o arquivo no navegador. Procure um banner de rótulo de confidencialidade na parte superior. Se o rótulo incluir criptografia ou restringir a leitura por máquina, o Copilot não poderá acessar o conteúdo. Solicite que o proprietário do documento altere o rótulo para um menos restritivo ou peça ao administrador para criar um rótulo que permita o acesso do Copilot.

Tipo de arquivo não suportado pelo Copilot

O Copilot suporta tipos de arquivo comuns como .docx, .xlsx, .pptx, .pdf e .txt. Ele não suporta arquivos .odt, .ods, .odp, .rtf ou .html. Se o seu arquivo usar um formato não suportado, converta-o para um tipo suportado. Por exemplo, salve um arquivo .odt como .docx no Word.

Problemas de cache do navegador ou sessão

Um token de autenticação desatualizado pode impedir que o Copilot busque o arquivo. Saia de todos os aplicativos do Microsoft 365 no seu navegador. Limpe o cache e os cookies do navegador. Faça login novamente e tente de novo.

Item Apenas permissões de arquivo Acesso do Copilot
Requer indexação de pesquisa do site do SharePoint Não Sim
Requer permissões delegadas da API Graph Não Sim
Afetado por políticas de fonte de dados do Copilot Não Sim
Bloqueado por criptografia de rótulo de confidencialidade Não (usuário pode abrir) Sim

Após aplicar as correções deste artigo, você pode forçar o Copilot a ler arquivos do SharePoint que antes eram ignorados. Comece verificando a indexação de pesquisa e as políticas de fonte de dados. Se o problema persistir, verifique as concessões de permissão da API Graph e os rótulos de confidencialidade. Como dica avançada, use o log de auditoria do centro de administração do Microsoft 365 para pesquisar eventos de interação do Copilot e ver exatamente qual chamada de API falhou e por quê.