Como Conectar o SharePoint como Fonte de Conhecimento no Copilot Studio

Você precisa que seu agente Copilot responda perguntas usando conteúdo armazenado em bibliotecas de documentos do SharePoint. O Copilot Studio pode extrair dados de sites do SharePoint para fundamentar as respostas nos arquivos da sua organização. Este artigo explica como conectar o SharePoint como fonte de conhecimento no Copilot Studio. Você aprenderá os pré-requisitos, as etapas exatas de configuração e o que evitar ao estabelecer a conexão.

O que significa o SharePoint como fonte de conhecimento no Copilot Studio

O Copilot Studio permite criar agentes personalizados que respondem perguntas usando dados de fontes do Microsoft 365. O SharePoint é uma das fontes de conhecimento compatíveis. Quando você conecta um site ou biblioteca de documentos do SharePoint, o agente indexa o conteúdo dos tipos de arquivo compatíveis. O agente então usa esse conteúdo indexado para gerar respostas às consultas dos usuários.

A conexão funciona por meio da API do Microsoft Graph. O Copilot Studio lê arquivos do local especificado no SharePoint. Os tipos de arquivo compatíveis incluem documentos do Word, apresentações do PowerPoint, PDFs, planilhas do Excel e arquivos de texto. O agente não armazena uma cópia dos arquivos. Ele indexa o conteúdo de texto e o utiliza apenas no momento da consulta.

Pré-requisitos para conectar o SharePoint

Antes de começar, confirme se os seguintes requisitos foram atendidos:

• Você tem uma licença do Copilot Studio com o recurso de agente personalizado. A licença está incluída no Copilot para Microsoft 365 ou como um complemento independente.
• Você tem pelo menos acesso de Colaborador ao site ou biblioteca de documentos do SharePoint que deseja conectar.
• O site do SharePoint é um site de equipe moderno ou site de comunicação. Sites clássicos podem não ser totalmente compatíveis.
• Os arquivos no local do SharePoint estão em um formato compatível. Formatos não compatíveis, como ZIP, imagens sem texto ou arquivos executáveis, são ignorados.

Etapas para conectar o SharePoint como fonte de conhecimento no Copilot Studio

Siga estas etapas para adicionar conteúdo do SharePoint ao seu agente Copilot. As etapas pressupõem que você já tenha um agente do Copilot Studio criado. Caso contrário, crie um novo agente primeiro na página inicial do Copilot Studio.

1. Abra seu agente no Copilot Studio
   Entre no Copilot Studio em copilotstudio.microsoft.com. No painel de navegação esquerdo, selecione Agentes. Clique no nome do agente que deseja modificar. A página de visão geral do agente será aberta.
2. Vá para a seção Tópicos
   Na página de visão geral do agente, selecione a guia Tópicos no menu superior. É aqui que você gerencia as fontes de conhecimento e os fluxos de conversa do seu agente.
3. Abra as configurações de fonte de conhecimento
   Na página Tópicos, procure a seção Fontes de conhecimento. Clique em Adicionar fonte de conhecimento. Um menu suspenso aparece com uma lista de tipos de fonte disponíveis.
4. Selecione SharePoint como o tipo de fonte
   No menu suspenso, escolha SharePoint. Um novo painel é aberto no lado direito da tela.
5. Insira a URL do SharePoint
   No campo URL, cole a URL completa do site ou biblioteca de documentos do SharePoint que deseja conectar. Para uma conexão no nível do site, use a URL do site, como https://contoso.sharepoint.com/sites/Projetos. Para uma conexão no nível da biblioteca, use a URL da biblioteca, como https://contoso.sharepoint.com/sites/Projetos/Documentos%20Compartilhados. Clique em Adicionar.
6. Confirme a conexão
   O Copilot Studio valida a URL e suas permissões. Se a conexão for bem-sucedida, a fonte do SharePoint aparece na lista de fontes de conhecimento. O agente começa a indexar o conteúdo. O tempo de indexação depende do número e tamanho dos arquivos. Você pode continuar editando outras partes do agente enquanto a indexação é executada.
7. Teste a fonte de conhecimento
   Após a conclusão da indexação, abra o painel Testar seu agente no lado direito da página Tópicos. Digite uma pergunta relacionada ao conteúdo da sua biblioteca do SharePoint conectada. O agente deve retornar uma resposta baseada nesse conteúdo. Se a resposta for genérica ou incorreta, verifique se os arquivos foram indexados e se a consulta é relevante.

Erros comuns e o que evitar ao conectar o SharePoint

O agente não retorna resposta do conteúdo do SharePoint

Se o agente não usar o conteúdo do SharePoint, verifique o status da indexação. Na lista de fontes de conhecimento, procure um indicador de status ao lado da fonte do SharePoint. Uma marca de verificação verde significa que a indexação foi concluída. Um aviso amarelo ou erro vermelho significa que a indexação falhou ou ainda está em execução. Readicione a fonte se o status permanecer em erro após 24 horas.

Usar uma URL pessoal do OneDrive em vez de uma URL do SharePoint

O Copilot Studio aceita apenas URLs de sites ou bibliotecas de documentos do SharePoint. URLs do OneDrive for Business não são compatíveis. Se você tentar adicionar uma URL do OneDrive, o sistema exibirá um erro de validação. Copie a URL correta do SharePoint da barra de endereços do navegador quando estiver na página do site ou biblioteca do SharePoint.

Arquivos não são indexados apesar da URL correta

Alguns tipos de arquivo não são indexados pelo Copilot Studio. Tipos não compatíveis incluem PDFs apenas com imagem, documentos digitalizados sem OCR, arquivos ZIP e arquivos executáveis. Converta arquivos não compatíveis para um formato compatível, como Word ou texto, antes de enviá-los ao SharePoint. O agente também ignora arquivos maiores que 100 MB. Divida arquivos grandes em partes menores, se necessário.

A autenticação falha para usuários finais

Por padrão, a fonte de conhecimento do SharePoint usa as credenciais da pessoa que adicionou a fonte. Quando outros usuários fazem perguntas, o agente pode não ter permissão para ler os arquivos. Para corrigir isso, configure o agente para usar a autenticação do usuário final. Nas configurações do agente, em Segurança, selecione Autenticar com o usuário que está conversando. Isso garante que cada usuário veja apenas o conteúdo ao qual tem permissão de acesso.

Fonte de conhecimento do SharePoint vs. outras fontes de conhecimento do Copilot Studio

Item	SharePoint	Outras fontes (Web, Dataverse, Personalizada)
Local dos dados	Site ou biblioteca de documentos específica do SharePoint	URLs públicas da web, tabelas do Dataverse ou arquivos enviados
Autenticação	Credenciais do criador ou autenticação do usuário final	Varia conforme a fonte: web pública não requer autenticação, Dataverse usa funções do ambiente
Tipos de arquivo compatíveis	Word, PowerPoint, PDF, Excel, arquivos de texto	Fontes web: apenas conteúdo HTML; Dataverse: linhas de tabela; Personalizada: documentos enviados
Frequência de atualização	Índice é atualizado a cada 24 horas ou na ressincronização manual	Fontes web reindexam conforme agendamento; Dataverse usa consultas em tempo real
Melhor caso de uso	Documentação interna, arquivos de projeto, documentos de políticas	Bases de conhecimento públicas, dados estruturados, conteúdo proprietário

Agora você pode conectar o SharePoint como fonte de conhecimento no Copilot Studio e controlar exatamente quais documentos seu agente utiliza. Após a conexão estar ativa, teste o agente com várias consultas reais para verificar se as respostas estão precisas. Para agentes em produção, mude para autenticação do usuário final para que as permissões sejam respeitadas por pessoa. Considere adicionar várias bibliotecas do SharePoint ou combinar o SharePoint com uma fonte web se seu conteúdo abranger dados internos e públicos.