Adicionar o SharePoint como uma fonte de conhecimento

O SharePoint como fonte de conhecimento ao nível do agente para respostas generativas funciona emparelhando o seu agente com um URL do SharePoint ou listas do SharePoint. Esta opção fornece o suporte completo do SharePoint no Copilot Studio.

Quando publica o seu agente, as chamadas que utilizam respostas generativas são feitas em nome do utilizador que conversa com o agente, utilizando as definições de autenticação configuradas no agente. Por predefiniçã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 o Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Adicionar sites do SharePoint como uma 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, um 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 do SharePoint como fonte de conhecimento, efetue os seguintes passos:

1. Abra o agente.

2. Selecione Adicionar conhecimento a partir das páginas Descrição geral ou Conhecimento, ou das Propriedades de um nó de respostas generativas.

3. Na secção Destaques, selecione SharePoint.

   

4. Forneça o URL do SharePoint. Separe vários URLs com quebras de linha manuais (utilize 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 ativada, pois a descrição ajuda a orquestração generativa.

6. Selecione Adicionar para terminar de adicionar a fonte de conhecimento.

Adicionar listas do SharePoint como uma fonte de conhecimento

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

1. Abra o agente.

2. Selecione Adicionar conhecimento a partir das páginas Descrição geral ou Conhecimento, ou das Propriedades de um nó de respostas generativas.

3. Na secção Destaques, selecione SharePoint.

4. Selecione Procurar itens para encontrar a lista pretendida, ou introduza o URL de uma lista do SharePoint específica.

   

5. Quando seleciona Procurar itens, o diálogo é automaticamente preenchido com As minhas listas e Listas Recentes. A opção As Minhas Listas só mostra as listas criadas na aplicação Listas do SharePoint. Todas as outras listas aparecem em Listas Recentes. Se não vir a lista de que necessita, abra o SharePoint e aceda à lista, e esta será apresentada 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 pretender utilizar uma lista do SharePoint à qual tem acesso partilhado, mas que não é apresentada em Listas Recentes, cole o URL da lista na seleção de URL.

6. Depois de selecionar as listas pretendidas, 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 ativada, pois a descrição ajuda a orquestração generativa.

8. Selecione Adicionar para terminar de adicionar a fonte de conhecimento.

Cenários avançados de autenticação

Por predefinição, o Copilot Studio pré-configura os agentes para autenticar utilizadores utilizando a autenticação da Microsoft para aceder a fontes do SharePoint quando estes 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, os seguintes passos são necessários para que as respostas generativas funcionem com origens de dados do SharePoint.

• As respostas generativas de origens do SharePoint não estão disponíveis para utilizadores convidados em aplicações preparadas para SSO.

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

• Para obter instruções sobre como criar o registo de aplicações necessário do Microsoft Entra ID, consulte Configurar a autenticação de utilizador com o Microsoft Entra ID. Ao criar este registo, o utilizador ou o seu administrador têm de especificar os âmbitos Sites.Read.All e Files.Read.All no registo de aplicações do Microsoft Entra ID.

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

• Ao configurar a autenticação, os âmbitos controlam o acesso do utilizador. Especifique Sites.Read.All e Files.Read.All no campo de âmbitos junto aos valores existentes profile e openid no Copilot Studio. 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.

• O SharePoint suporta a definição Autenticar manualmente com os seguintes fornecedores de serviços de autenticação:

  • Microsoft Entra ID
  • O Microsoft Entra ID V2 com credenciais federadas
  • O Microsoft Entra ID V2 com certificados
  • O Microsoft Entra ID V2 com segredos do cliente

• O SharePoint não suporta autenticação manual utilizando 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 SharePoint

Os criadores podem melhorar o desempenho da origem de conhecimento do SharePoint do seu agente especificando parâmetros de consulta de pesquisa. Estes parâmetros de consulta definem o que será pesquisado na fonte de conhecimento. Por exemplo, pode especificar que só quer pesquisas por itens que tenham sido modificados nos últimos 6 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 Conhecimento, selecione a sua fonte do SharePoint.

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

3. Selecione Definições avançadas.

4. Crie os seus filtros para incluir ou excluir informações da sua fonte de conhecimento do SharePoint. Pode basear o filtro numa das seguintes seleções:

   • Título
   • Autor
   • Modificada 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 utilizador fornece durante a conversação com o agente, que é depois guardada como uma variável global personalizada
   • Uma variável de sistema

6. Selecione Guardar quando terminar de configurar os seus filtros.

Mais definições para melhorar a pesquisa

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

• Pesquisa na Web
• Ao nível do agente, a definição Utilizar conhecimento geral nas definições de IA generativa do agente
• 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

Desativar estas definições garante que o agente responde com "sem resposta" se não conseguir encontrar um resultado na fonte de conhecimento filtrada do SharePoint.