SharePoint fontes de conhecimento não retornam resultados em Copilot Studio

Resumo

Este artigo ajuda você a solucionar problemas em que SharePoint fontes de conhecimento não retornam resultados em Microsoft Copilot Studio. Quando você configura uma fonte de dados SharePoint, vários fatores podem impedir que o agente forneça uma resposta. Esses fatores incluem resultados de pesquisa ausentes, permissões de usuário, conteúdo protegido, problemas de registro de aplicativo, limitações de tamanho do arquivo, condições de filtro ou filtragem de moderação de conteúdo. Nesses casos, o agente pode retornar uma mensagem como "Não sei como ajudar com isso. Você pode tentar reformular?

Copilot Studio fornece duas maneiras de configurar SharePoint como uma fonte de conhecimento e este artigo aborda ambos os métodos:

• Fonte de conhecimento no nível do agente. Adicione por meio da caixa de diálogo Adicionar conhecimento nas páginas Visão Geral, Conhecimento ou Propriedades do agente. Esse caminho dá suporte a SharePoint sites (URLs) e listas de SharePoint, corte de rótulo de confidencialidade e condições de filtro. Para obter mais informações, consulte Adicionar SharePoint como uma fonte de conhecimento.
• Fonte de conhecimento no nível do tópico. Adicione dentro de um nó Criar respostas gerativas em um tópico. Esse caminho emparelha o nó com uma URL de SharePoint. Para obter mais informações, consulte Usar SharePoint conteúdo para respostas generativas.

Os resultados da pesquisa estão ausentes do SharePoint

Quando Copilot Studio pesquisa SharePoint, ele usa apenas os três principais resultados de pesquisa para resumir e gerar uma resposta. Se nenhum resultado da pesquisa for retornado, o agente não fornecerá uma resposta. Copilot Studio depende Pesquisa da Microsoft indexação e impõe restrições específicas nos layouts de página, componentes e formatos de arquivo que são usados para gerar respostas.

Corrigir resultados de pesquisa de SharePoint ausentes

1. Verifique se o SharePoint fonte de conhecimento (origem no nível do agente ou criar nó de respostas generativas) aponta para um local SharePoint com conteúdo relevante.

2. Somente documentos em formatos suportados são usados para gerar respostas.

3. Verifique se as páginas SharePoint que você espera que o agente use atendam às seguintes restrições:

   • Páginas modernas: Há suporte apenas para páginas de SharePoint modernas. Não há suporte para páginas modernas que contêm componentes Estrutura do SharePoint (SPFx).
   • Páginas clássicas: O conteúdo de páginas clássicas .aspx em SharePoint não é usado para gerar respostas.
   • Para obter uma lista completa de limites técnicos, consulte SharePoint limites do aplicativo Web.

4. É possível que os documentos tenham sido carregados recentemente no SharePoint e ainda não tenham sido indexados. Também é possível que algumas configurações impeçam que alguns sites apareçam nos resultados da pesquisa. Para obter mais informações, consulte Resultados da pesquisa ausentes no SharePoint Online.

   Como verificar

   • Na barra de pesquisa do portal SharePoint, insira uma palavra-chave exclusiva do documento de destino e verifique se o arquivo aparece nos resultados da pesquisa. Se o arquivo não aparecer, a indexação estará incompleta.

   Como corrigir

   • Aguarde a conclusão do ciclo de indexação automatizado.
   • Para atualizações urgentes, SharePoint administradores de site podem disparar manualmente um reindex. Nas configurações de SharePoint, vá para Exibição de Informações> do Siteem todas as configurações> do site Pesquisar e sitede re indexação de> offline. Para obter mais informações, consulte Rastreamento de solicitação manual e reindexação de um site, uma biblioteca ou uma lista.

Permissões de usuário ausentes para SharePoint

Copilot Studio respeita Segurança do Microsoft 365 corte. No mínimo, um usuário deve ter permissões de leitura nos sites e arquivos relevantes ou nenhum resultado da pesquisa é retornado.

Se o usuário não tiver permissões, o sistema não retornará resultados nem erros ou exceções. Para um usuário sem permissões, parece que nenhum documento foi encontrado.

Verificar SharePoint permissões de usuário

1. Fazer com que o usuário afetado vá diretamente para o caminho exato do documento SharePoint para verificar se ele pode abrir o arquivo.
2. Teste a consulta usando a mesma conta de usuário no Microsoft 365 Copilot Chat. Se Microsoft 365 Copilot Chat não conseguir recuperar uma resposta, ele confirmará uma permissão ou uma barreira de indexação de pesquisa.

Corrigir permissões de usuário ausentes no SharePoint

Altere as permissões para que os usuários possam acessar os sites e arquivos relevantes. Para obter mais informações, consulte Compartilhamento e permissões na experiência moderna do SharePoint.

O conteúdo é protegido por rótulos de confidencialidade, DKE ou uma senha

A fonte de conhecimento SharePoint no nível do agente respeita os rótulos de confidencialidade para o corte de permissões e apenas exibe o conteúdo permitido pelo rótulo para o usuário conectado. No entanto, o agente não pode extrair ou aterrar em conteúdo cuja proteção criptografa o arquivo. Essa limitação inclui etiquetas de sensibilidade que aplicam criptografia, Criptografia de Dupla Chave (DKE) e arquivos protegidos por senha.

Esses documentos podem ser mostrados como Prontos na lista de fontes de dados de conhecimento e podem ser abertos pelo usuário em SharePoint, mas ainda retornam "nenhuma resposta" quando o agente é questionado sobre seu conteúdo.

Verificar o conteúdo de SharePoint protegido

1. Abra o arquivo diretamente no SharePoint ou em seu aplicativo da área de trabalho e verifique se ele solicita uma senha, indica a proteção DKE ou mostra um rótulo de confidencialidade de criptografia.
2. Pergunte sobre o conteúdo que é conhecido por aparecer apenas em arquivos desprotegidos na mesma origem. Se essas consultas forem bem-sucedidas enquanto as consultas com escopo para arquivos protegidos não retornarem resposta, a proteção será a causa.

Corrigir o conteúdo de SharePoint protegido

• Remova o rótulo de confidencialidade de criptografia, a proteção contra DKE ou a senha do arquivo, se as políticas da sua organização permitirem isso.
• Publique uma cópia desprotegida do conteúdo necessário em um SharePoint local que o agente possa acessar.
• Aponte a fonte de conhecimento para um local SharePoint que não contém conteúdo criptografado.

O link de origem do SharePoint é interrompido após uma renomeação

Se você renomear um site ou pasta SharePoint que uma fonte de conhecimento no nível do agente usa, o link de origem existente poderá interromper e causar uma lacuna de permissão. Quando isso acontece, o agente pode não acessar a base de dados de conhecimento e não retornar nenhuma resposta.

Corrigir um link de origem de SharePoint desfeito

1. Peça ao Administrador do SharePoint que conceda as permissões apropriadas no local renomeado e gere um novo link de origem.
2. Abra o agente e atualize a fonte de conhecimento SharePoint com o link recém-gerado.

O registro ou agente do aplicativo está configurado incorretamente para SharePoint

Quando os administradores configuram SharePoint fontes de conhecimento, eles precisam configurar a autenticação usando um registro de aplicativo Microsoft Entra ID e configurar escopos extras. No mínimo, o registro do aplicativo deve especificar os escopos e Sites.Read.All os Files.Read.All escopos e adicionar esses escopos às configurações de autenticação do agente ao lado profile e openid. Se os escopos estiverem ausentes do registro do aplicativo ou das configurações de autenticação do agente ou se o consentimento não for concedido aos escopos necessários, o agente não retornará nenhum resultado, nem erros ou exceções. Para um usuário, parece que nenhum documento foi encontrado.

Corrigir registro de aplicativo configurado incorretamente ou autenticação de agente

Adicione os escopos necessários ao registro do aplicativo e às configurações de autenticação do agente e conceda consentimento.

O exemplo a seguir é uma referência a um registro de aplicativo bem configurado:

O exemplo a seguir mostra as configurações de autenticação necessárias no Copilot Studio:

Limites de tamanho de arquivo para respostas generativas do SharePoint

Para fontes do SharePoint, se você não tiver uma licença do Microsoft 365 Copilot no mesmo locatário do seu agente, as respostas generativas só poderão processar arquivos de até 7 MB. Você também deve desativar o aterramento do grafo locatário com a configuração de pesquisa semântica .

Se você tiver uma licença do Microsoft 365 Copilot no mesmo locatário que seu agente, o tamanho máximo do arquivo será de 200 MB. Você também deve ativar o aterramento de grafo de locatário com configuração de pesquisa semântica .

Arquivos maiores podem ser armazenados no SharePoint e retornados por uma pesquisa no Microsoft Graph, mas não são processados por respostas generativas. Como alternativa, você pode carregar seus próprios arquivos, que podem ter até 512 MB.

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

Corrigir problemas de tamanho do arquivo nas respostas generativas do SharePoint

Se os arquivos relevantes para sua experiência de IA conversacional excederem a limitação de tamanho, convém explorar arquiteturas alternativas, como usar a Indexação Semântica do Microsoft 365 ou conectar seus dados ao OpenAI do Azure para obter Respostas generativas.

SharePoint list fonte não retorna resultados

Para fontes de conhecimento no nível do agente que usam listas de SharePoint, vários fatores específicos da lista podem fazer com que o agente não retorne nenhuma resposta, mesmo que a lista contenha dados relevantes.

• A pesquisa do Dataverse é necessária. Copilot Studio agentes exigem que a pesquisa do Dataverse use um SharePoint list como fonte de conhecimento. Se a pesquisa do Dataverse estiver desativada no ambiente, a lista não poderá ser consultada e nenhum resultado será retornado. Para obter mais informações sobre como ativar a pesquisa do Dataverse, consulte Configurar a pesquisa do Dataverse para seu ambiente.
• O tamanho da lista afeta a qualidade e a latência. Listas que contêm mais de 35.000 linhas podem degradar a qualidade dos resultados e aumentar a latência, o que pode apresentar como nenhuma resposta para consultas válidas de outra forma.
• Muitas listas em um agente. Você pode selecionar até 10 listas por vez e, para obter os melhores resultados, usar no máximo 10 listas por agente. Adicionar mais listas aumenta a chance de que o conteúdo relevante não seja exibido.
• A lista não aparece em Listas Recentes. Se um SharePoint list com acesso compartilhado não aparecer em Minhas Listas ou Listas Recentes no navegador, abra a lista em SharePoint uma vez para que ela apareça em Listas Recentes ou cole a URL da lista diretamente na seleção de URL ao adicionar a origem.

Corrigir SharePoint list problemas de origem

1. Peça ao administrador para ativar a pesquisa do Dataverse no ambiente em que o agente é executado.
2. Reduza o número de linhas na lista ou divida listas grandes em listas com foco menor.
3. Reduza o número de listas anexadas ao agente para 10 ou menos, mantendo apenas as listas relevantes para os tópicos aos quais o agente dá suporte.
4. Adicione novamente listas colando sua URL quando elas não aparecerem automaticamente em Listas Recentes.

As condições de filtro excluem o conteúdo esperado

Ambos os caminhos de configuração permitem restringir qual SharePoint conteúdo que o agente pode usar. Se esses filtros forem muito restritivos ou configurados incorretamente, o agente não retornará nenhuma resposta mesmo quando houver conteúdo correspondente.

• Origem no nível do agente, filtros de configurações avançadas. Em uma fonte de conhecimento SharePoint no nível do agente, filtros baseados em Título, Autor, Modificado ou Modificado podem excluir o conteúdo que o usuário está perguntando. Filtros associados a uma variável personalizada, variável do sistema ou variável de ambiente podem ser resolvidos para um valor não intencional em runtime.
• Nó de respostas gerativas no nível do tópico, pesquisar somente fontes selecionadas. Quando as fontes selecionadas da Pesquisa são ativadas apenas para um nó Criar respostas generativas , somente as fontes selecionadas nesse nó são usadas. Se a fonte de SharePoint esperada não estiver na seleção, o agente não retornará nenhuma resposta em vez de voltar para outras fontes de conhecimento.

Verificar condições de filtro

1. Na página Conhecimento, selecione sua origem de SharePoint e selecione Editar>Configurações Avançadas para examinar quaisquer condições de filtro ativas e os valores que eles resolverem.
2. No tópico que hospeda o nó Criar respostas gerativas, abra afonte de dados> do nó e confirme a configuração de fontes selecionadas somente pesquisa e as fontes específicas selecionadas.

Corrigir condições de filtro

• Relaxe ou remova condições de filtro que excluam o conteúdo esperado.
• Se um filtro usar uma variável, adicione uma etapa de depuração na conversa para confirmar se a variável é resolvida para o valor esperado no runtime.
• No nó no nível do tópico, adicione a fonte de SharePoint esperada às fontes selecionadas ou desative somente as fontes selecionadas para que fontes de conhecimento no nível do agente também sejam consultadas.

Conteúdo bloqueado pela moderação de conteúdo no Copilot Studio

Quando geram respostas, os agentes do Copilot Studio moderam o conteúdo que se enquadra nas categorias de danos. Quando o conteúdo é moderado, as respostas gerativas não fornecem uma resposta ou uma indicação de que o conteúdo foi moderado. No entanto, os eventos de moderação são registrados quando o agente é configurado para enviar dados de telemetria para o Azure Applications Insights.

Depois de conectar seu agente ao Azure App Insights, você pode usar a seguinte consulta KQL (Linguagem de Consulta Kusto) para descobrir se o conteúdo foi filtrado:

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

No exemplo a seguir, a consulta KQL destaca uma tentativa de usar respostas generativas filtradas pela moderação de conteúdo:

Corrigir o bloqueio de respostas generativas pela moderação de conteúdo

• Tente ajustar a moderação de conteúdo, mas lembre-se de que um nível mais baixo de moderação de conteúdo pode resultar em respostas menos precisas ou relevantes.

• Se você achar que seu conteúdo não deve ser moderado, entre em contato Microsoft suporte ao cliente.

Conteúdo relacionado

• Adicionar o SharePoint como uma fonte de conhecimento
• Usar SharePoint conteúdo para respostas generativas
• Configurar respostas generativas por SharePoint
• SharePoint limites do aplicativo Web
• Compartilhamento e permissões na experiência moderna do SharePoint
• Resolver erros de filtro de conteúdo de IA responsável