Relatório do Insights sobre agentes no SharePoint

O relatório de insights sobre agentes no SharePoint fornece aos administradores do SharePoint informações valiosas sobre os agentes criados recentemente em todos os sites do SharePoint e sites do OneDrive em sua organização. Esse relatório ajuda os administradores a saber mais sobre os sites com o maior número de agentes criados. Ao usar este relatório, os administradores do SharePoint podem controlar e manter ainda mais a integridade do conteúdo usado pelos agentes como dados fundamentais.

O relatório de insights é baseado nos dados de auditoria da Microsoft registrados para os agentes criados no SharePoint por meio dos eventos FileCreated e FileRenamed.

Você pode gerar e gerenciar o relatório de insights do agente no Centro de Administração do SharePoint ou usando o Shell de Gerenciamento do SharePoint Online.

O que você precisa para acessar o relatório de insights do agente

Consulte os pré-requisitos do Gerenciamento Avançado do SharePoint.

Como acessar o relatório de insights do agente no Centro de Administração do SharePoint

1. Entre no Centro de administração do SharePoint com as credenciais de administrador do SharePoint para sua organização.

2. No painel de navegação, expanda Relatórios e selecione Agent Insights.

Como criar relatórios no Centro de Administração do SharePoint

1. Como administrador do SharePoint, selecione Criar um relatório para criar o relatório.

   

2. Insira o nome do relatório. Em Duração do relatório, especifique o período de tempo para o relatório.

   

3. Selecione Criar e executar.

Exibir o status do relatório no Centro de Administração do SharePoint

Para marcar se um relatório está pronto ou quando foi atualizado pela última vez, consulte a coluna Status.

Exibir relatório no Centro de Administração do SharePoint

Quando um relatório estiver pronto, selecione-o para exibir os dados. Você pode exibir os 100 principais registros que hospedam o maior número de agentes. Você pode pesquisar sites ou filtrar pelo modelo de site e políticas de governança.

Aplicar políticas de governança de conteúdo no Centro de Administração do SharePoint

Você pode aplicar políticas de governança de conteúdo nos sites do relatório de insights. As políticas disponíveis são a política de restrição de acesso ao site e a política de restrição de descoberta de conteúdo.

Relatório de insights do agente no Shell de Gerenciamento do SharePoint Online

Você pode gerar e gerenciar relatórios de insights do agente usando o Shell de Gerenciamento do SharePoint Online.

1. Se você ainda não tiver feito isso, baixe e instale a versão mais recente do Shell de Gerenciamento do SharePoint Online.

2. Conecte-se ao SharePoint Online como pelo menos um administrador do SharePoint no Microsoft 365. Para obter mais informações, consulte Introdução ao Shell de Gerenciamento do SharePoint Online.

3. Para gerar e exibir esses relatórios, verifique se a organização tem a SKU do complemento Gerenciamento Avançado do SharePoint ou a licença do Microsoft Copilot.

Com permissões de pelo menos um administrador do SharePoint, você pode gerar e exibir o relatório de insights usando os seguintes comandos:

1. Para gerar um relatório para a duração padrão do relatório de um dia, execute o seguinte comando:

   Start-SPOCopilotAgentInsightsReport
   

2. Para gerar um relatório para qualquer outra duração (7, 14 ou 28 dias), execute o seguinte comando:

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
   

   Por exemplo, para gerar um relatório para os últimos 28 dias, execute o comando:

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
   

3. Para marcar o status de todos os relatórios ativos e disponíveis, execute o seguinte comando:

   Get-SPOCopilotAgentInsightsReport
   

4. Para marcar o status de um relatório específico, execute o seguinte comando:

   Get-SPOCopilotAgentInsightsReport –ReportId
   

5. Para baixar e exibir o relatório, execute o seguinte comando:

   Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
   

   Observação

   O PowerShell exibe até 100 registros, mas os relatórios baixados podem conter até 1 milhão de registros.

   Get-SPOCopilotAgentInsightsReport –ReportId -Action View
   

6. Para exibir relatórios mais detalhados, use as seguintes opções:

   1. CopilotAgentsOnSites: fornece o nome de todos os agentes atualmente disponíveis em todos os sites. Este relatório contém até 1.000.000 de registros.

      Observação

      O valor padrão para o -Content parâmetro é CopilotAgentsOnSites.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
      

   2. TopSites: fornece uma lista de 100 sites com o número de agentes disponíveis em cada site.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
      

   3. SiteDistribution: fornece a visão resumida dos agentes em todos os tipos de sites, como sites de comunicação, sites conectados do Grupo do Microsoft 365, sites do OneDrive e muito mais.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
      

Coleta de dados para relatório de insights sobre agentes no SharePoint

Se você não tiver uma licença do Microsoft Gerenciamento Avançado do SharePoint, precisará habilitar a coleta de dados. Esta seção explica como habilitar e marcar o status da coleta de dados para o relatório de insights sobre agentes no SharePoint.

Habilitar coleta de dados

Esse comando do PowerShell começa a coletar dados de auditoria para relatórios sobre atividades dos últimos 28 dias.

Start-SPOAuditDataCollectionForActivityInsights  

Desabilitar coleta de dados

Esse comando do PowerShell interrompe a coleta de dados de auditoria para relatórios sobre atividades dos últimos 28 dias.

Stop-SPOAuditDataCollectionForActivityInsights  

Verifique o status da coleta de dados

Depois de habilitar a coleta de dados, você poderá gerar os relatórios após 24 horas. Para marcar se você pode gerar relatórios, use o comando Get-SPOAuditDataCollectionStatusForActivityInsightsPowerShell. O comando retorna o status atual da coleta de dados, que pode ser NotInitiated, InProgressou Paused. Você pode gerar relatórios quando o status for InProgress.

Get-SPOAuditDataCollectionStatusForActivityInsights 

Experiências conhecidas com relatórios de insights de agentes no SharePoint

As seguintes experiências são conhecidas com relatórios de insights do agente gerados no Centro de Administração do SharePoint ou usando o Shell de Gerenciamento do SharePoint Online:

• Você pode executar novamente um relatório somente após 24 horas desde o último relatório gerado.

• Em locatários grandes, pode levar até 48 horas para que os dados estejam disponíveis.

• Somente um relatório pode existir para cada valor de intervalo de relatório (1, 7, 14 ou 28 dias). Essa limitação significa que você pode ver no máximo quatro relatórios em um determinado ponto.

• O relatório recém-gerado substitui o relatório criado anteriormente pelo mesmo intervalo de datas. Para preservar o relatório criado anteriormente, baixe o relatório antes de criar um novo relatório para o mesmo intervalo de datas.

• Esses relatórios usam dados de auditoria unificada do Microsoft 365 e podem não abranger todos os eventos de auditoria.

Artigos relacionados

• Restringir o acesso ao site do SharePoint com grupos do Microsoft 365 e grupos de segurança do Microsoft Entra
• Restringir a descoberta de sites e conteúdo do SharePoint
• Módulo Microsoft.Online.SharePoint.PowerShell