As respostas generativas que apontam para as fontes do SharePoint não retornam resultados
Respostas generativas permitem que os criadores criem agentes que respondam a perguntas baseadas em fontes de dados, como sites públicos ou SharePoint, apontando o agente para essas fontes de dados. No entanto, às vezes o agente não fornece um resposta e, em vez disso, retorna algo como 'Não tenho certeza de como ajudar com isso. Você pode tentar reformular?' (a mensagem real depende da implementação).
Por que o nó 'Criar respostas generativas' não responde?
Quando uma fonte de dados do SharePoint é configurada, pode haver vários fatores diferentes que impedem que as respostas generativas retornem uma resposta, como os seguintes fatores potenciais:
O usuário que acessa o agente não tem permissões suficientes no fonte de dados
O registro do aplicativo ou o agente estão configurados incorretamente
Observação
Antes de continuar, certifique-se de ter seguido as instruções sobre como configurar respostas generativas no SharePoint.
Estão faltando os resultados da pesquisa
As respostas generativas para uma fonte de dados do SharePoint dependem de fazer chamadas para o ponto de extremidade de pesquisa da API do Graph. Somente os três principais resultados retornados da API do Graph são usados para resumir e gerar uma resposta. Se nenhum resultado voltar da API do Graph, o nó de respostas generativas não fornecerá uma resposta.
Para diagnosticar se o Copilot Studio não está retornando resultados da API do Graph, você pode fazer chamadas diretas para o ponto de extremidade de pesquisa da API do Graph. Essa chamada simula a forma como o Copilot Studio funciona nos bastidores. As chamadas para o ponto de extremidade de pesquisa da API do Graph podem ser geradas usando o modelo a seguir com o Graph Explorer. Ao acessar o Graph Explorer, certifique-se de entrar usando as credenciais apropriadas para o locatário do SharePoint.
O modelo pode ser usado copiando o payload a seguir ou usando este link profundo, que abre o Graph Explorer com uma consulta preenchida.
POST https://graph.microsoft.com/v1.0/search/query
{
"requests": [{
"entityTypes": ["driveItem", "listItem"],
"query": {
"queryString": "SEARCH TERMS filetype:docx OR filetype:aspx OR filetype:pptx OR filetype:pdf path:\"https://DOMAIN.sharepoint.com/sites/SITENAME\""
},
"from": 0,
"size": 3,
"QueryAlterationOptions": {
"EnableModification": true,
"EnableSuggestion": true
}
}
]
}
Faltando resultados
Vamos supor que as respostas generativas estejam configuradas para fornecer respostas com base no conteúdo armazenado no https://<domínio do usuário>.sharepoint.com/sites/HR. No entanto, os usuários não estão recebendo respostas quando perguntam: "Qual é a nossa política em relação a vantagens e benefícios?"
Nos bastidores, as consultas dos usuários estão sendo reescritas, portanto, apenas as palavras-chave principais estão sendo enviadas para a API do Graph, resultando em uma consulta semelhante ao exemplo a seguir:
Se nenhum resultado for retornado ao ponto de extremidade da pesquisa, conforme mostrado na resposta a seguir, as respostas generativas também não fornecerão uma resposta.
Como corrigir
Certifique-se de que o nó Criar respostas generativas aponta para um local do SharePoint com conteúdo relevante.
Somente documentos em formatos suportados são usados para gerar respostas.
Observação
Apenas páginas modernas do SharePoint são compatíveis.
É possível que os documentos tenham sido carregados no SharePoint recentemente, mas ainda não foram indexados. Também é possível que existam configurações que impeçam que alguns sites apareçam nos resultados da pesquisa. Para obter mais informações, consulte Resultados da pesquisa ausentes no SharePoint Online.
Permissões de usuário ausentes
As respostas generativas no SharePoint dependem das permissões delegadas ao fazer chamadas para a API do Graph. No mínimo, um usuário deve ter permissões de leitura nos sites e arquivos relevantes, ou a chamada para a Graph API não retorna nenhum resultado.
Se o usuário não tiver permissões, nenhum resultado será retornado da API do Graph, nem erros ou exceções. Para um usuário sem permissões, parece que nenhum documento foi encontrado.
Como corrigir
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 registro do aplicativo ou agente estão configurados incorretamente
Quando os administradores configuram respostas generativas no SharePoint, espera-se que os administradores configurem a autenticação com uma Microsoft Entra ID e configurem escopos extras. Se os escopos estiverem ausentes no registro do aplicativo ou nas configurações de autenticação agente, ou se o consentimento não tiver sido concedido para os escopos necessários, nenhum resultado será retornado, nem erros ou exceções. Para um usuário final, parece que nenhum documento foi encontrado.
Como corrigir
Adicione os escopos necessários ao Registro do aplicativo e/ou às configurações de autenticação do agente e conceda o 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:
Suporte para tamanho de arquivo
Atualmente, para SharePoint fontes, as respostas generativas só podem processar arquivos de até 3 MB. Arquivos maiores podem ser armazenados no SharePoint e retornados por uma pesquisa na API do Graph, mas não são processados pelas respostas generativas. Como alternativa, arquivos de até 512 MB podem ser carregados.
Como corrigir
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.
Conteúdo bloqueado pela moderação de conteúdo
Ao gerar respostas, o Copilot Studio modera conteúdo prejudicial, malicioso, não compatível ou que viole direitos autorais. Quando o conteúdo é moderado, as respostas generativas 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 Copilot Studio é configurado para enviar dados de telemetria ao Azure Applications Insights.
Depois de conectar seu agente ao Azure App Insights, você pode usar a seguinte consulta Kusto Query Language (KQL) 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:
Como corrigir
Tente ajustar a moderação de conteúdo, mas lembre-se de que configurações mais baixas de moderação de conteúdo podem resultar em respostas menos precisas ou relevantes.
Se você acha que seu conteúdo não deve ser moderado, abra um caso com o suporte ao cliente.