Partilhar via

Use conteúdos do SharePoint para respostas generativas

Os nós de respostas generativas que utilizam o SharePoint como fonte de conhecimento ao nível do tópico funcionam ao emparelhar o seu agente com um URL do SharePoint, como contoso.sharepoint.com/sites/policies. 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.

Importante

As fontes de conhecimento definidas nos nós de respostas generativas têm prioridade sobre as fontes de conhecimento no nível do agente. As fontes ao nível do agente funcionam como recurso alternativo. Para instruções sobre como adicionar SharePoint como fonte de conhecimento ao nível do agente, veja Add SharePoint como fonte de conhecimento. Respostas de agentes que usam SharePoint como fonte de conhecimento, seja ao nível do tema ou do agente, não são incluídas nas transcrições conversa.

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.

Nota

É possível usar respostas generativas com dados do SharePoint em chats do Microsoft Teams, sem necessidade de autenticação manual. Para usar este método para um agente previamente publicado, reconfigure o agente para usar Authenticate com Microsoft e depois publique-o novamente para Microsoft Teams. Pode demorar algumas horas até esta alteração entrar em vigor. Se um utilizador estiver no meio de uma conversação e a alteração não parecer ter tido efeito, poderá escrever "começar novamente" no chat para forçar o reinício da conversação com a versão mais recente do agente. Estas alterações já estão disponíveis para os chats 1:1 do Teams entre o utilizador e o agente. Ainda não estão disponíveis para chats 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.

Nota

Utilizar o SharePoint num nó de respostas generativas

Importante

Ao usar um nó de respostas generativas num tópico, pode encontrar um erro na tela de criação e no Verificador de Tópicos quando a Segurança Integrada tiver sido escolhida. Este erro é benigno e não impede o funcionamento da funcionalidade.

  1. Num tópico, adicione um nó de respostas generativas.

  2. No nó de respostas generativas do tópico relevante, abra o painel de configuração da fonte de dados a partir de um de dois locais:

    1. No nó Criar respostas generativas, selecione Editar sob Origens de dados.

      Captura de tela que mostra onde selecionar o painel Propriedades.

    2. Alternativamente, no nó Criar respostas generativas , selecione os três pontos (...), depois selecione Propriedades e selecione Fonte de dados.

  3. Em Fontes de conhecimento, selecione Adicionar conhecimento. Certifique-se de que a opção Pesquisar apenas fontes selecionadas está ativada.

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

    Captura de ecrã do diálogo Adicionar conhecimento, a destacar a opção SharePoint.

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

    Nota

    Para uma lista de limites e funcionalidades de SharePoint suportadas, veja Copilot Studio web app SharePoint limites.

  6. 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.

  7. Selecione Salvar na parte superior para salvar as alterações de tópico.

  8. Teste o seu agente com frases que espera que devolvam conteúdo.

    Nota

    Se a conta de utilizador em que usou para iniciar sessão copilotstudio.microsoft.com não tiver acesso ao site SharePoint, não recebe conteúdo ou pode ver um erro do sistema.

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.

Importante

Se o Restricted SharePoint Search estiver ativado, o uso de SharePoint é bloqueado.

  • 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. 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.

  • 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 do 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.

  • Last updated on