Quando o Copilot no Microsoft 365 não encontra e-mails, eventos de calendário ou anexos recentes de uma caixa postal específica, o serviço pode estar usando dados de indexação desatualizados. Isso acontece quando a indexação subjacente do Microsoft Graph para essa caixa postal não foi atualizada após uma importação grande de dados, migração de caixa postal ou alteração de permissão. Este artigo explica como acionar uma solicitação de reindexação para uma única caixa postal para que o Copilot possa acessar o conteúdo correto. Você aprenderá as etapas exatas para enviar um comando de reindexação usando o PowerShell do Exchange Online e verificar o resultado.
Principais Conclusões: Forçar a Reindexação do Copilot para uma Única Caixa Postal
- Cmdlet Start-MailboxAssistant do PowerShell do Exchange Online: Aciona o Assistente de Caixa Postal para processar uma solicitação de reindexação para uma caixa postal especificada.
- Centro de Administração do Copilot > Fontes > Conectores do Graph: Mostra o status de indexação das fontes de dados conectadas, incluindo caixas postais.
- Parâmetro -IndexOnly: Instrui o Assistente de Caixa Postal a reindexar a caixa postal sem executar outras tarefas de manutenção.
Por que o Copilot Não Encontra o Conteúdo da Caixa Postal
O Copilot depende do serviço de indexação do Microsoft Graph para recuperar conteúdo de caixas postais do Exchange Online. Quando uma caixa postal é provisionada pela primeira vez ou após uma migração, o serviço de indexação cria um índice pesquisável de todos os itens. Se o índice ficar desatualizado ou incompleto, o Copilot retorna nenhum resultado ou respostas desatualizadas para consultas sobre essa caixa postal.
O índice é mantido pelo Assistente de Caixa Postal do Exchange Online, um processo em segundo plano que é executado em um agendamento. Por padrão, o assistente reindexa as caixas postais aproximadamente a cada 24 a 48 horas. No entanto, após importações em massa de dados, movimentações de caixa postal ou grandes alterações de permissão, o assistente pode não detectar a alteração rapidamente. Nesses casos, você deve forçar a reindexação manualmente.
O que a Solicitação de Reindexação Faz
A solicitação de reindexação envia um comando ao Assistente de Caixa Postal para reconstruir o índice de pesquisa de uma única caixa postal. Isso não afeta outras caixas postais ou serviços. O processo é executado em segundo plano e geralmente é concluído em 15 a 60 minutos, dependendo do tamanho da caixa postal e do número de itens.
Pré-requisitos para Forçar a Reindexação
- Módulo PowerShell do Exchange Online: Você deve ter o módulo Exchange Online PowerShell V2 instalado. Instale-o com
Install-Module -Name ExchangeOnlineManagementem uma janela do PowerShell elevada. - Função de administrador: Você precisa da função de Administrador do Exchange ou de uma função personalizada que inclua o cmdlet
Start-MailboxAssistant. - Identidade da caixa postal: Saiba o Nome Principal do Usuário ou GUID da caixa postal de destino.
Etapas para Forçar a Reindexação do Serviço Copilot para uma Caixa Postal
- Conecte-se ao PowerShell do Exchange Online
Abra o Windows PowerShell como administrador. ExecuteConnect-ExchangeOnline -UserPrincipalName admin@seudominio.com. Faça login com uma conta que tenha privilégios de Administrador do Exchange. - Verifique se a caixa postal existe e está ativa
ExecuteGet-Mailbox -Identity usuario@seudominio.com | fl RecipientTypeDetails, IsDisabled. Confirme seRecipientTypeDetailsmostraUserMailboxeIsDisabledéFalse. - Execute o comando de reindexação
ExecuteStart-MailboxAssistant -Identity usuario@seudominio.com -IndexOnly. O parâmetro-IndexOnlyinstrui o assistente a reconstruir apenas o índice de pesquisa e pular outras tarefas, como processamento de retenção. - Verifique a saída do comando
O cmdlet retorna uma mensagem de confirmação:Mailbox assistant started for mailbox usuario@seudominio.com with operation IndexOnly. Se você vir um erro, verifique a identidade da caixa postal e suas permissões. - Monitore o status da indexação no Centro de Administração do Copilot
Vá para Centro de Administração do Microsoft 365 > Copilot > Fontes > Conectores do Graph. Encontre a entrada da caixa postal e verifique a coluna Última Sincronização. O valor é atualizado após a conclusão da reindexação. - Teste a resposta do Copilot após a atualização do índice
Aguarde pelo menos 15 minutos. No Copilot no Outlook, faça uma pergunta sobre um e-mail recente da caixa postal de destino. Por exemplo: Encontre o e-mail de João sobre o relatório de orçamento. Se o Copilot retornar o e-mail correto, a reindexação foi bem-sucedida.
Se a Solicitação de Reindexação Não For Concluída
Copilot Ainda Retorna Nenhum Resultado Após a Reindexação
Se a atualização do índice não resolver o problema, verifique as permissões da caixa postal. O Copilot só pode indexar itens aos quais o usuário tenha pelo menos acesso de Leitura. Verifique se as permissões da caixa postal do usuário permitem que o Copilot leia o conteúdo. No Exchange Online, execute Get-MailboxFolderStatistics -Identity usuario@seudominio.com -FolderScope All | Select Name, ItemsInFolder para confirmar que a caixa postal contém itens.
Comando de Reindexação Falha com Erro de Permissão
O cmdlet Start-MailboxAssistant requer a função de Administrador do Exchange. Se você receber um erro de acesso negado, peça ao seu Administrador Global para atribuir a função de Administrador do Exchange à sua conta. Após a atribuição da função, desconecte e reconecte-se ao PowerShell do Exchange Online.
Caixa Postal com Grande Número de Itens e o Índice Leva Horas
Caixas postais com mais de 500.000 itens podem levar várias horas para serem reindexadas. Durante esse período, o Copilot pode retornar resultados parciais. Você pode verificar o progresso da indexação executando Get-MailboxAssistant -Identity usuario@seudominio.com. A propriedade LastSuccessfulIndexTime mostra quando o último índice foi construído. Se o valor for superior a 24 horas, a reindexação ainda está em execução.
Start-MailboxAssistant vs Reconstrução Manual no Outlook: Principais Diferenças
| Item | Start-MailboxAssistant -IndexOnly | Reconstrução Manual no Outlook |
|---|---|---|
| Escopo | Única caixa postal no lado do servidor | Apenas arquivo OST local do Outlook |
| Efeito no Copilot | Atualiza o índice do Microsoft Graph usado pelo Copilot | Nenhum efeito na indexação do Copilot |
| Exigência de administrador | Sim, função de Administrador do Exchange necessária | Não, qualquer usuário pode fazer |
| Tempo de conclusão | 15 a 60 minutos para a maioria das caixas postais | Minutos a horas dependendo do tamanho da caixa postal |
| Persistência | Índice persiste no servidor | Índice é reconstruído cada vez que o Outlook abre |
Para que o Copilot reconheça conteúdo novo ou alterado da caixa postal, você deve usar o método do lado do servidor Start-MailboxAssistant. A reconstrução local do Outlook afeta apenas a experiência de pesquisa do lado do cliente.
Agora você pode forçar a reindexação do serviço Copilot para qualquer caixa postal em seu locatário. Use o comando Start-MailboxAssistant -Identity usuario@dominio.com -IndexOnly para acionar o processo. Monitore o Centro de Administração do Copilot para ver o horário de sincronização atualizado. Se a reindexação não resolver o problema, verifique as permissões da caixa postal e a contagem de itens. Para caixas postais com mais de 500.000 itens, aguarde até 4 horas para a conclusão do índice.