Adicionar SharePoint como uma fonte de conhecimento

SharePoint como uma fonte de conhecimento funciona emparelhando seu agente com uma URL de SharePoint ou listas de SharePoint. Este artigo aborda a funcionalidade completa de integração SharePoint fornecida selecionando a opção SharePoint na caixa de diálogo Add knowledge.

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 em Microsoft Teams são configurados com a opção de autenticação Authenticate com a Microsoft, que funciona em ambientes como Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Adicionar sites SharePoint como uma fonte de conhecimento

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.

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

1. Abra o agente.

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

3. Na seção Featured, selecione SharePoint.

   

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

5. Adicione um nome e uma descrição. A descrição deve ser o mais detalhada possível, especialmente se IA generativa estiver habilitada, pois ajuda na orquestração generativa.

6. Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

Adicionar listas de SharePoint como uma fonte de conhecimento

SharePoint listas são uma maneira popular de armazenar dados tabulares e fornecer acesso rápido e fácil às informações. Seu agente pode usar essas listas como fonte de conhecimento. Ao adicionar uma lista de SharePoint como uma fonte de dados de conhecimento, você cria uma conexão em tempo real com a origem, de modo que os dados mais atuais são usados para consultas e raciocínio. Os usuários são autenticados usando suas credenciais de SharePoint, o que garante que eles tenham permissão para acessar os dados antes que o agente forneça uma resposta.

1. Abra o agente.

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

3. Na seção Featured, selecione SharePoint.

4. Selecione itens Browse para localizar a lista desejada ou insira a URL de uma lista de SharePoint específica.

   

5. Quando você seleciona Procurar itens, a caixa de diálogo é preenchida automaticamente com Minhas Listas e Listas Recentes. My Lists exibe apenas listas criadas no aplicativo listas de SharePoint. Todas as outras listas aparecem nas Listas Recentes. Se você não vir uma lista de que precisa, abra SharePoint e acesse a lista e a lista aparecerá em Recent Lists.

   

   É possível selecionar até 15 listas de cada vez. Cada lista é adicionada às fontes de conhecimento do agente como itens individuais. Para adicionar mais listas ao agente, use novamente esses passos e selecione mais listas.

   Observação

   Se você quiser usar uma lista de SharePoint com acesso compartilhado, mas ela não for exibida nas listas Recent, cole a URL da lista na seleção de URL.

6. Depois de selecionar suas listas desejadas, selecione Confirmar seleção.

7. Adicione um nome e uma descrição. A descrição deve ser o mais detalhada possível, especialmente se IA generativa estiver habilitada, pois ajuda na orquestração generativa.

8. Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

Cenários de autenticação avançada

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

• Respostas generativas de fontes SharePoint não estão disponíveis para usuários guest em aplicativos habilitados para SSO.

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

• Para obter instruções sobre como criar o registro de aplicativo Microsoft Entra ID necessário, consulte Configure user authentication with Microsoft Entra ID. Ao criar esse registro, você ou seu administrador devem especificar os escopos Sites.Read.All e Files.Read.All no registro do aplicativo Microsoft Entra ID.

• Selecionar No authentication especifica que o agente não recupera informações de 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 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 o conteúdo permitido do site SharePoint, conforme configurado para respostas gerativas.

• SharePoint dá suporte à configuração Authenticate manualmente com os seguintes provedores de serviços de autenticação:

  • Microsoft Entra ID
  • Microsoft Entra ID V2 com credenciais federadas
  • Microsoft Entra ID V2 com certificados
  • Microsoft Entra ID V2 com credenciais secretas do cliente

• SharePoint não dá suporte à autenticação manual usando o OAuth Genérico.

• Essa configuração só se aplica a respostas generativas, e não se aplica aos conectores do Power Platform.

Filtrar sua fonte de SharePoint

Os criadores podem melhorar o desempenho da fonte de conhecimento do SharePoint do agente especificando parâmetros de consulta de pesquisa. Esses parâmetros de consulta definem o que é pesquisado dentro da fonte de conhecimento. Por exemplo, você pode especificar que só quer buscas por itens que foram modificados nos últimos seis meses. Esse tipo de filtro seria construído como:

Criar condições de filtro

Depois de adicionar uma fonte de conhecimento SharePoint, você pode definir condições de pesquisa.

1. Na página Knowledge, selecione sua origem SharePoint.

2. Selecione o ícone de três pontos (…) para a fonte do SharePoint e selecione Editar.

3. Selecione Configurações avançadas.

4. Crie seus filtros para incluir ou excluir informações de sua fonte de conhecimento SharePoint. Você pode fundamentar o filtro em uma das seguintes seleções:

   • Título
   • Autor
   • Modificado por
   • Modificado em

5. Você pode definir o valor da condição para um dos seguintes valores:

   • Um valor estático
   • Uma entrada variável que o usuário fornece durante a conversa com o agente, que é salva como uma variável global personalizada
   • Uma variável do sistema

6. Selecione Salvar quando terminar de configurar seus filtros.

Mais configurações para melhorar a pesquisa

Se você quiser filtrar sua fonte de SharePoint, desative as seguintes configurações:

• Pesquisa na Web
• No nível do agente, a configuração Usar conhecimento geral nas configurações de IA generativa do agente
• No nível do tópico, permita que a IA use seu próprio conhecimento geral (versão prévia) no nó de respostas generativas

Desativar essas configurações garante que o agente responda com "nenhuma resposta" se não conseguir encontrar um resultado na fonte de conhecimento SharePoint filtrada.