Usar conteúdo do SharePoint para respostas generativas

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

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

Uso do SharePoint em um nó de respostas generativas

1. Em um 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 dos dois lugares:

   1. No nó Criar respostas generativas, selecione Editar em Fontes de dados.

      

   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. Verifique se a opção Somente as fontes selecionadas está ativada.

4. Na seção Featured, selecione SharePoint.

   

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

   Note

   Para obter uma lista de limites e funcionalidade do SharePoint com suporte, consulte os limites do aplicativo Web do SharePoint.

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

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

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

   Note

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

Usar variáveis como URLs

Use variáveis em URLs de fontes de conhecimento do site público ou do SharePoint para controlar dinamicamente o escopo do conteúdo que seu agente utiliza.

Em vez de criar várias fontes de conhecimento para cenários diferentes, defina uma única fonte de conhecimento e insira uma variável na URL. Em tempo de execução, o Copilot Studio resolve a variável e usa a URL resultante para fundamentação.

Suporte a variáveis

Ao adicionar ou editar uma URL de site público ou uma fonte de conhecimento do SharePoint, você pode inserir uma variável no campo de URL.

Use uma variável para:

• Acrescentar um caminho a uma URL base

  https://www.contoso.com/{variable}

• Substituir a URL inteira

  {variable}

Em runtime, a variável é resolvida para um valor de cadeia de caracteres. A fonte de conhecimento é delimitada pela URL resolvida.

Criar e definir uma variável

Para usar uma variável em um site público ou em uma fonte de conhecimento do SharePoint:

1. Crie uma variável de cadeia de caracteres com escopo global .

2. Defina o valor da variável usando uma das seguintes opções:

   • Entradas de tópico
   • Propriedades de perfil do usuário, como idioma
   • Variáveis de ambiente
   • Fluxos ou conectores do agente

3. Insira a variável no campo URL selecionando {x} (inserir variável).

4. Teste o agente para confirmar que a variável resulta na URL esperada.

Exemplo: Escopo por produto

Você pode definir o escopo do conhecimento para diferentes áreas do produto com base na consulta do usuário.

1. Use uma entrada de tópico para capturar o nome do produto como uma variável chamada Product.

2. Adicione um nó de valor de variável Set após o nó Gatilho e crie uma nova variável chamada ProductTable.

3. Use uma fórmula do Power Fx para definir e mapear os nomes dos produtos para caminhos de URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Adicione outro nó definir valor de variável e use-o para criar uma nova variável global do tipo string chamada GlobalProductURL.

5. Na configuração Para valor, selecione Fórmula e use uma função Power Fx para executar uma pesquisa na tabela com base no valor da variável de entrada Product, Topic.Product, da seguinte maneira:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Use a variável na URL da fonte de dados de conhecimento:

   https://www.microsoft.com/en-us/{GlobalProductURL}

O agente consulta apenas a seção com escopo do site em tempo de execução.

Cenários comuns

Use variáveis em fontes de conhecimento do site público para:

• Roteamento baseado em produto: direcione consultas para a documentação específica do produto.

• Filtragem de região ou idioma: mapear User.Language para URLs localizadas (por exemplo, en-us, ). it-it

• URLs específicas do ambiente: alternar entre sites de desenvolvimento, teste e produção.

Considerações

• As fontes de conhecimento do site público usam a pesquisa do Bing e dependem do conteúdo indexado.
• Os limites de profundidade de URL ainda se aplicam quando você usa variáveis.
• As variáveis alteram apenas a URL de destino. Eles não afetam a forma como o conteúdo é indexado ou recuperado.

Cenários de autenticação avançada

Por padrão, o Copilot Studio pré-configura agentes para autenticar usuários usando a autenticação da Microsoft para acessar SharePoint fontes quando estiverem se conectando a um agente por meio de 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 SharePoint fontes de dados.

• Respostas geradas a partir de fontes do SharePoint não estão disponíveis para usuários guest em aplicativos habilitados para SSO.

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

• Para obter instruções sobre como criar o registro de aplicativo Microsoft Entra ID necessário, consulte Configure user authentication with Microsoft Entra ID. Ao criar esse registro, você ou seu administrador devem especificar os escopos Sites.Read.All e Files.Read.All no registro do aplicativo Microsoft Entra ID.

• Selecionar No authentication especifica que o agente não recupera informações de 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 escopos próximo aos 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.

• SharePoint dá suporte à configuração Authenticate 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 credenciais secretas do cliente

• SharePoint não dá suporte à autenticação manual usando o OAuth Genérico.

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