Adicionar o SharePoint como fonte de conhecimento

O SharePoint, como fonte de conhecimento, funciona emparelhando o seu agente com uma URL do SharePoint ou listas do SharePoint. Este artigo cobre toda a funcionalidade de integração SharePoint fornecida ao selecionar a opção SharePoint no diálogo Adicionar conhecimento.

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

Adicionar sites SharePoint como fonte de conhecimento

Quando um utilizador faz uma pergunta e o agente não tem um tópico para responder, o agente pesquisa o URL e todos os subcaminhos. Por exemplo, uma URL como contoso.sharepoint.com/sites também inclui subcaminhos como contoso.sharepoint.com/sites/policies. As respostas generativas resumem este conteúdo numa resposta direcionada.

Para adicionar um site SharePoint como fonte de conhecimento, execute os seguintes passos:

1. Abra o agente.

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

3. Na secção Em destaque, selecione SharePoint.

   

4. Forneça o URL do SharePoint. Separe vários 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 a IA generativa estiver habilitada, pois a descrição auxilia a orquestração generativa.

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

Adicionar listas SharePoint como fonte de conhecimento

As listas SharePoint são uma forma popular de armazenar dados tabulares e fornecer acesso rápido e fácil à informação. O seu agente pode utilizar estas listas como fonte de conhecimento. Ao adicionar uma lista SharePoint como fonte de conhecimento, cria-se uma ligação em tempo real à fonte, de modo que os dados mais atuais são usados para consultas e raciocínio. Os utilizadores são autenticados usando as suas credenciais SharePoint, o que garante que têm permissão para aceder aos dados antes de o seu agente fornecer uma resposta.

1. Abra o agente.

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

3. Na secção Carregar ficheiros , selecione SharePoint.

4. Selecione Navegar por itens para encontrar a lista desejada, ou introduza o 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. Minhas Listas só mostra listas criadas na aplicação SharePoint Listas. Todas as outras listas aparecem nas Listas recentes. Se não vir uma lista de que precisa, abra SharePoint e aceda à lista, e a lista aparece então em Listas Recentes.

   

   Pode 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, utilize novamente estes passos e selecione mais listas.

   Nota

   Se quiseres usar uma lista de SharePoint com acesso partilhado mas ela não estiver mostrada no Listas Recentes, cola o URL da lista na seleção do URL.

6. Depois de selecionar as 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 a IA generativa estiver habilitada, pois a descrição auxilia a orquestração generativa.

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

Cenários avançados de autenticação

Por defeito, o Copilot Studio pré-configura os agentes para autenticarem utilizadores usando autenticação Microsoft para aceder às fontes SharePoint quando se ligam a um agente através do Microsoft Teams, Power Apps ou Microsoft 365 Copilot. No entanto, se precisar de configurar manualmente a autenticação, são necessários os seguintes passos para que as respostas generativas funcionem com fontes de dados SharePoint.

• Respostas generativas de fontes SharePoint não estão disponíveis para utilizadores convidados em aplicações com SSO.

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

• Para instruções sobre como criar a Microsoft Entra ID necessária para o registo da aplicação, consulte Configure autenticação de utilizador com Microsoft Entra ID. Ao criar este registo, você ou o seu administrador devem especificar os escopos Sites.Read.All e Files.Read.All no registo da aplicação Microsoft Entra ID.

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

• Ao configurar a autenticação, os âmbitos controlam o acesso do utilizador. No Copilot Studio, especifique Sites.Read.All e Files.Read.All no campo de âmbitos perto dos valores existentes de profile e openid. Estes âmbitos não dão aos utilizadores permissões adicionais ao usar o agente, mas permitem o seu conteúdo admissível do site do SharePoint, tal como configurado para respostas generativas.

• SharePoint suporta a definição Autenticar manualmente com os seguintes fornecedores 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 segredos de cliente

• O SharePoint não suporta autenticação manual usando o Generic OAuth.

• Esta configuração aplica-se apenas a respostas generativas, e não se aplica aos Conectores do Power Platform.

Filtre a sua fonte do SharePoint

Os criadores podem melhorar o desempenho da base de conhecimento SharePoint do agente especificando parâmetros de consulta de pesquisa. Estes parâmetros de consulta definem o que é pesquisado dentro da fonte de conhecimento. Por exemplo, pode especificar que só quer pesquisas por itens que foram modificados nos últimos seis meses. Este tipo de filtro seria criado como:

Criar condições de filtro

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

1. Na página Knowledge, selecione a sua fonte SharePoint.

2. Selecione os três pontos (…) para a fonte SharePoint e selecione Editar.

3. Selecione Configurações avançadas.

4. Constrói os teus filtros para incluir ou excluir informação da tua fonte de conhecimento do SharePoint. Pode basear o filtro numa das seguintes seleções:

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

5. Pode definir o valor da condição para um dos seguintes valores:

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

6. Selecione Salvar quando terminar de configurar seus filtros.

Mais definições para melhorar a pesquisa

Se quiser filtrar a sua fonte SharePoint, deve desativar as seguintes definições:

• Pesquisa na Web
• No nível do agente, na configuração Utilizar conhecimento geral nas configurações do agente de IA generativa
• Ao nível do tópico, a opção Permitir que a IA utilize o seu próprio conhecimento geral (pré-visualização) no nó de respostas gerativas

Desligar estas definições garante que o agente responde com "sem resposta" caso não encontre um resultado na fonte de conhecimento filtrada do SharePoint.