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). Para usar uma variável em vez de um URL estático, selecione o ícone seletor de variáveis ao lado do campo URL e escolha uma variável Personalizada, Sistema ou Ambiente .

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.

   Note

   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.

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.