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 padrão, os agentes criados no Copilot Studio e no Microsoft Teams são configurados com a opção Autenticar com autenticação da Microsoft , que funciona em ambientes como Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Adicionar sites do SharePoint como fonte de conhecimento

Quando um usuário faz uma pergunta e o agente não tem um tópico para usar como resposta, o agente pesquisa a 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 do SharePoint como fonte de conhecimento, execute as seguintes etapas:

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 a 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 do 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 do SharePoint como fonte de conhecimento, você cria uma conexão em tempo real com a fonte, para que os dados mais atuais sejam usados para consultas e raciocínio. Os usuários são autenticados usando suas credenciais do SharePoint, o que garante que eles tenham permissão para acessar os dados antes que seu agente forneça 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 Em destaque, selecione SharePoint.

4. Selecione Explorar itens para encontrar a sua lista desejada, ou introduza o URL de um site SharePoint específico.

   

5. Quando você seleciona Procurar itens, a caixa de diálogo é preenchida automaticamente com Minhas Listas e Listas Recentes. Minhas Listas exibe apenas listas criadas no aplicativo Listas do SharePoint. Todas as outras listas aparecem nas Listas recentes. Se você não vir uma lista de que precisa, abra o SharePoint e acesse a lista, e a lista aparecerá 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.

   Observação

   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 padrão, o Copilot Studio pré-configura agentes para autenticar usuários usando a autenticação da Microsoft para acessar fontes do SharePoint quando eles estão se conectando a um agente por meio do 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 fontes de dados do 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 obter instruções sobre como criar o registro necessário do aplicativo Microsoft Entra ID, consulte Configurar a autenticação do usuário com o 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 seu agente não recupera 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 escopos próximo aos valores profile e openid existentes 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.

• 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 a Power Platform Connectors.

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 construído 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 sua fonte do SharePoint.

2. Selecione os três pontos (…) para a fonte 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 do SharePoint. Você pode basear o filtro em uma das seguintes seleções:

   • Title
   • Author
   • Modificado por
   • Modificado em

5. Você 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 você quiser filtrar sua fonte do SharePoint, você deve desativar as seguintes configuraçõ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

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