As respostas generativas que apontam para as fontes do SharePoint não retornam resultados

As respostas generativas permitem que os criadores criem agentes que respondam a perguntas fundamentadas 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 uma resposta e, em vez disso, retorna algo como 'Não sei como ajudar com isso. Você pode tentar reformular?' (A mensagem real depende da implementação.)

Quando uma SharePoint fonte de dados é configurada, pode haver vários fatores diferentes impedindo que o nó Criar respostas generativas retorne uma resposta, como os descritos nas seções a seguir.

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 Microsoft Graph. Apenas os três principais resultados que retornam do Microsoft Graph são usados para resumir e gerar uma resposta. Se nenhum resultado voltar, o nó de respostas generativas não fornecerá uma resposta.

Para diagnosticar por que Copilot Studio não está retornando resultados do Microsoft Graph, você pode fazer chamadas diretas para o ponto de extremidade de pesquisa. Essa chamada simula a forma como o Copilot Studio funciona nos bastidores. As chamadas para o ponto de extremidade de pesquisa 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 o Microsoft 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

1. Certifique-se de que o nó Criar respostas generativas aponta para um local do SharePoint com conteúdo relevante.

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

   Observação

   Apenas páginas modernas do SharePoint são compatíveis.

3. É 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 Microsoft Graph. No mínimo, um usuário deve ter permissões de leitura nos sites e arquivos relevantes, ou a chamada para Microsoft Graph não retorna nenhum resultado.

Se o usuário estiver sem permissões, nenhum resultado será retornado, nem quaisquer 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 aos escopos necessários, nenhum resultado será retornado, nem quaisquer erros ou exceções. Para um usuário, 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 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é 7 MB de tamanho. Arquivos maiores podem ser armazenados e SharePoint retornados por uma pesquisa no Microsoft Graph, mas não são processados por respostas generativas. Como alternativa, arquivos de até 512 MB de tamanho 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

Quando geram respostas, Copilot Studio os agentes moderam 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 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 (Kusto Query Language) 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 um nível mais baixo de moderação de conteúdo pode 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.