Compartilhar via

Adicionar o SharePoint como uma fonte de conhecimento

  • Artigo

O SharePoint como uma fonte de conhecimento para respostas generativas funciona emparelhando seu agente com uma URL do SharePoint, como contoso.sharepoint.com/sites/policies. Quando um usuário faz uma pergunta e o agente não tem um tópico para usar para uma resposta, o agente pesquisa a URL e todos os subcaminhos. Por exemplo, um URL como contoso.sharepoint.com/sites também inclui subcaminhos como contoso.sharepoint.com/sites/policies. As respostas generativas resumem esse conteúdo em uma resposta direcionada.

Quando você publica seu agente, as chamadas usando respostas generativas são feitas em nome do usuário que está conversando com o agente, usando as configurações de autenticação definidas no agente. Por padrão, os agentes criados no Copilot Studio e no Microsoft Teams são configurados com a opção de autenticação Autenticar com a Microsoft, que funciona em ambientes como Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Observação

É possível usar respostas generativas com dados do SharePoint em chats do Microsoft Teams, e não exigir autenticação manual. Para usar esse método para um agente publicado anteriormente, reconfigure o agente para usar Autenticar com Microsoft e publique-o novamente Microsoft Teams. Pode levar algumas horas até que essa alteração entre em vigor. Se um usuário estiver no meio de uma conversa e a alteração não parecer ter tido efeito, ele pode digitar "recomeçar" no chat para forçar a conversa a reiniciar com a versão mais recente do agente. Essas alterações agora estão disponíveis para bate-papos do Teams 1:1 entre o usuário e o agente. Eles ainda não estão disponíveis para bate-papos em grupo ou mensagens de canal.

Se você quiser usar a autenticação manual para seu agente, consulte Cenários de autenticação avançada.

Para obter melhores resultados da pesquisa do SharePoint e suporte a arquivos de até 200 MB, use uma licença do Microsoft 365 Copilot no mesmo locatário do agente e ative os resultados de pesquisa aprimorados.

Para criadores sem a licença do Microsoft 365 Copilot no mesmo locatário do agente, devido a limitações de memória, as respostas generativas só podem usar arquivos do SharePoint com menos de 7 MB. Se um arquivo for maior que 7 MB, considere dividi-lo em vários arquivos menores. Para obter mais informações, consulte Suporte para tamanho de arquivo.

Página e tipos de arquivo com suporte

Há suporte para páginas modernas do SharePoint. Além disso, os sites do SharePoint que contêm os seguintes tipos de arquivo podem ser usados como origens de conhecimento:

  • Documento do Word (DOC/DOCX)
  • PowerPoint (PPT/PPTX)
  • Arquivos PDF

Observação

Para obter melhores resultados da pesquisa do SharePoint e suporte a arquivos de até 200 MB, use uma licença do Microsoft 365 Copilot no mesmo locatário do agente e ative os resultados de pesquisa aprimorados.

Observação

Há suporte apenas para páginas modernas. Conteúdo das páginas ASPX clássicas no SharePoint não são usadas para gerar respostas.

Adicionar uma fonte de conhecimento do SharePoint

Para adicionar SharePoint como uma fonte de conhecimento, execute as seguintes etapas:

  1. Abrir o agente.

  2. Selecione Adicionar conhecimento das páginas Visão geral ou Conhecimento ou nas Propriedades de um nó de respostas generativas.

  3. Selecione SharePoint.

  4. Forneça a URL do SharePoint. Separe várias URLs com quebras de linha manuais (use Shift + Enter).

  5. Adicione um nome (por padrão, o nome do arquivo é usado).

  6. Adicione uma descrição. A descrição deve ser o mais detalhada possível, especialmente se a IA generativa estiver habilitada, pois a descrição auxilia a orquestração da IA.

  7. Selecione Adicionar para concluir a adição da nova fonte de conhecimento.

Cenários de autenticação avançada

Por padrão, Copilot Studio pré-configura os agentes para autenticar usuários usando a autenticação Microsoft para acessar SharePoint fontes quando eles estão se conectando a um agente através Microsoft Teams, Power Apps, ou Microsoft 365 Copilot. No entanto, se você precisar configurar manualmente a autenticação, as etapas a seguir são necessárias para que as respostas generativas funcionem com fontes de dados do SharePoint.

Importante

Se a Pesquisa Restrita do SharePoint estiver ativada, o uso do SharePoint será bloqueado.

  • Para autenticar seu agente, consulte Autenticação.

  • Para obter instruções sobre como criar o registro de aplicativo do Microsoft Entra ID necessário, consulte Configurar autenticação de usuário com o Microsoft Entra ID. Ao criar esse registro, você ou seu administrador deve especificar os escopos Sites.Read.All e Files.Read.All no registro do aplicativo do Microsoft Entra ID.

  • Selecionar Sem autenticação especifica que seu agente não recupera informações do SharePoint.

  • Quando você configura a autenticação, os escopos controlam o acesso do usuário. Especifique Sites.Read.All e Files.Read.All no campo de escopos próximo aos valores profile e openid existentes no Copilot Studio. Esses escopos não dão aos usuários permissões maiores ao usar o agente, mas permitem que seu conteúdo permitido do SharePoint site seja configurado para respostas generativas.

  • Essa configuração é aplicada somente a respostas generativas e não é aplicada aos Conectores do Power Platform.

Problemas conhecidos

  • Para criadores sem a licença do Microsoft 365 Copilot no mesmo locatário do agente, devido a limitações de memória, as respostas generativas só podem usar arquivos do SharePoint com menos de 7 MB. Se um arquivo for maior que 7 MB, considere dividi-lo em vários arquivos menores. Para obter mais informações, consulte Suporte para tamanho de arquivo.
  • Recomendamos omitir https:// da URL. As URLs reconhecidas do SharePoint são do domínio sharepoint.com.
  • Páginas modernas são suportadas. No entanto, páginas modernas que contêm componentes SPFx não são suportadas.
  • Sites do SharePoint com menu de navegação do accordion ou CSS personalizado não são usados para gerar respostas.
  • Páginas ASPX clássicas no SharePoint não são usadas para gerar respostas.
  • Se desejar usar uma URL dinâmica SharePoint usando uma Power Fx fórmula, você deverá usar a opção Dados clássicos, que está disponível nas propriedades do nó de respostas generativas. Para obter mais informações sobre como usar SharePoint conteúdo com um nó de respostas generativas em um tópico, consulte Usar SharePoint conteúdo para respostas generativas.