Use conteúdos do SharePoint para respostas generativas

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

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.

Utilizar o SharePoint num nó de respostas generativas

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.

      

   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.

   

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

   Note

   Para uma lista de limites e funcionalidades suportadas pelo SharePoint, consulte Limites da aplicação web do SharePoint.

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 das quais espera que retornem conteúdo.

   Note

   Se a conta de utilizador que utilizou para iniciar sessão no copilotstudio.microsoft.com não tiver acesso ao site do SharePoint, não obtém conteúdo ou poderá ver um erro de sistema.

Usar variáveis como URLs

Use variáveis em URLs de fonte de conhecimento em sites públicos ou SharePoint para controlar dinamicamente o alcance do conteúdo que o seu agente utiliza.

Em vez de criar múltiplas fontes de conhecimento para diferentes cenários, defina uma única fonte de conhecimento e insira uma variável na URL. Durante a execução, o Copilot Studio resolve a variável e utiliza a URL resultante para referenciação.

Suporte variável

Quando adiciona ou edita um site público ou URL de fonte de conhecimento do SharePoint, pode inserir uma variável no campo do URL.

Use uma variável para:

• Adicionar um caminho a uma URL base

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

• Substituir toda a URL

  {variable}

Em tempo de execução, a variável é resolvida para um valor de string. A fonte de conhecimento está restrita ao URL resolvido.

Criar e definir uma variável

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

1. Cria uma variável string com âmbito global .

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

   • Entradas de tópicos
   • Propriedades do perfil do utilizador, como a linguagem
   • Variáveis de ambiente
   • Fluxos de agentes ou conectores

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

4. Teste o agente para confirmar se a variável se resolve no URL esperado.

Exemplo: Alcance por produto

Pode direcionar o conhecimento para diferentes áreas de produto com base na consulta do utilizador.

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

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

3. Use uma fórmula 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ó de definir valor da variável e use-o para criar uma nova variável global do tipo string chamada GlobalProductURL.

5. Na definição To value, selecione Fórmula e use uma função Power Fx para fazer uma consulta na tabela com base no valor do variável de entrada Product, Topic.Product, da seguinte forma:

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

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

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

O agente consulta apenas a secção específica do site durante a execução.

Cenários comuns

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

• Roteamento com base no produto: Filtrar consultas para a documentação específica do produto.

• Filtragem por região ou língua: Mapear User.Language para URLs localizadas (por exemplo, en-us, it-it).

• URLs específicas para cada ambiente: Navegar entre sites de desenvolvimento, teste e produção.

Considerações

• As fontes de conhecimento de sites públicos utilizam a pesquisa do Bing e baseiam-se em conteúdos indexados.
• Os limites de profundidade de URL continuam a aplicar-se quando usas variáveis.
• As variáveis mudam apenas a URL de destino. Não afetam a forma como o conteúdo é indexado ou recuperado.

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.