Compartilhar via

Usar conteúdo do SharePoint para respostas generativas

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

Importante

As fontes de conhecimento definidas nos nós de respostas generativas têm prioridade sobre as fontes de conhecimento no nível agente. A função de origens em nível de agente funcionam como um fallback. Para obter instruções sobre como adicionar o SharePoint como uma fonte de conhecimento no nível do agente, consulte Adicionar SharePoint como uma fonte de conhecimento. As respostas de agente que usem o SharePoint como fonte de conhecimento no nível do tópico ou do agente não estão incluídas em transcrições de conversa.

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, 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 Microsoft Teams, Power Apps e Microsoft 365 Copilot.

Nota

É possível usar respostas generativas com dados do SharePoint em chats do Microsoft Teams, e não exigir autenticação manual. Para usar esse método para um agente publicado anteriormente, reconfigure o agente para usar Autenticar com Microsoft e publique-o novamente no Microsoft Teams. Pode levar algumas horas até que essa alteração entre em vigor. Se um usuário estiver no meio de uma conversa e a alteração não parecer ter tido efeito, ele pode digitar "recomeçar" no chat para forçar a conversa a reiniciar com a versão mais recente do agente. Essas alterações agora estão disponíveis para bate-papos do Teams 1:1 entre o usuário e o agente. Eles ainda não estão disponíveis para bate-papos 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

Usar o SharePoint em um nó de respostas generativas

Importante

Ao usar um nó de respostas generativas em um tópico, você pode encontrar um erro na tela de criação e no Verificador de Tópico quando a Segurança Integrada foi escolhida. Esse erro é favorável e não impede que o recurso funcione.

  1. No nó Criar respostas generativas para o tópico, selecione os três pontos (...) e depois selecione Propriedades.

    Nota

    Para uma lista de limites e funcionalidades com suporte do SharePoint, consulte limites do aplicativo Web do Copilot Studio no SharePoint.

  2. Em Fontes de conhecimento, selecione Adicionar conhecimento. Verifique se Pesquisar apenas fontes selecionadas está ativo.

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

    Captura de tela da caixa de diálogo Adicionar conhecimento, destacando a opção SharePoint.

  4. Forneça a URL do 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 Salvar na parte superior para salvar suas alterações de tópico.

  7. Teste seu agente com frases que você espera que retornem conteúdo.

    Nota

    Se a conta de usuário usada por você para entrar em copilotstudio.microsoft.com não tiver acesso ao site do SharePoint, você não obterá conteúdo nem poderá ver um erro do sistema.

Cenários de autenticação avançada

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

Importante

Se a Pesquisa do SharePoint restrita estiver habilitada, o uso do SharePoint será bloqueado.

  • As respostas generativas de fontes do SharePoint não estão disponíveis para usuários convidados em aplicativos habilitados por SSO.

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

  • Para obter instruções sobre como criar o registro de aplicativo do Microsoft Entra ID necessário, consulte Configurar autenticação do usuário com o Microsoft Entra ID. Ao criar esse registro, você ou o administrador deve especificar os escopos Sites.Read.All e Files.Read.All no registro do aplicativo do Microsoft Entra ID.

  • A seleção de Sem autenticação especifica que o agente não recupera informações do 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 de escopos próximo a valores profile e openid existentes no Copilot Studio. Esses escopos não dão aos usuários mais permissões ao usar o agente, mas permitem que o conteúdo permitido do site do SharePoint seja configurado para respostas generativas.

  • O SharePoint dá suporte à configuração Autenticar-se 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 segredos do cliente

  • O SharePoint não dá suporte à autenticação manual usando o Generic OAuth.

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

  • Last updated on