Report di Insights sugli agenti in SharePoint

Il report Insights sugli agenti in SharePoint fornisce agli amministratori di SharePoint informazioni dettagliate sugli agenti creati di recente in tutti i siti di SharePoint e OneDrive all'interno dell'organizzazione. Questo report aiuta gli amministratori a scoprire quali sono i siti con il maggior numero di agenti creati. Usando questo report, gli amministratori di SharePoint possono controllare e mantenere ulteriormente l'integrità dei contenuti usati dagli agenti come dati di base.

Il report di approfondimenti si basa sui dati di controllo Microsoft registrati per gli agenti creati in SharePoint tramite gli eventi FileCreated e FileRenamed.

È possibile generare e gestire il report sulle informazioni dettagliate agente in SharePoint Amministrazione Center o usando SharePoint Online Management Shell.

Cosa serve per accedere al report di approfondimenti agente

Vedere i prerequisiti di gestione avanzata di SharePoint.

Importante

Se non si ha una licenza di Gestione avanzata di Microsoft SharePoint, viene chiesto di abilitare la raccolta dei dati in modo che siano raccolti i dati di controllo pertinenti per creare il report. Una volta abilitati, i report possono essere generati 24 ore dopo 24 ore e conterranno i dati dal punto di raccolta. I dati vengono conservati per 28 giorni. Se non si generano report almeno una volta ogni tre mesi, la raccolta dei dati viene sospesa e deve essere abilitata di nuovo. Per abilitare la raccolta dei dati per questi report, consulta la sezione Raccolta dei dati per il report Insights sugli agenti in SharePoint (in questo articolo).

Come accedere al report Dati analitici agente nell'interfaccia di amministrazione di SharePoint

  1. Accedere all'interfaccia di amministrazione di SharePoint con le credenziali di amministratore di SharePoint per l'organizzazione.

  2. Nel riquadro di spostamento espandere Report e quindi selezionare Informazioni dettagliate agente.

Come creare report nell'interfaccia di amministrazione di SharePoint

  1. Gli amministratori di SharePoint possono selezionare Crea un report per creare il report.

    Screenshot che mostra come creare un report sui dati analitici dell'agente di SharePoint.

  2. Immettere il nome del report. In Durata rapporto specificare l'intervallo di tempo per il rapporto.

    Screenshot che mostra come specificare l'intervallo di tempo del report.

  3. Selezionare Crea ed esegui.

Nota

È possibile creare un report per gli ultimi 1, 7, 14 o 28 giorni.

Visualizzare lo stato del report nell'interfaccia di amministrazione di SharePoint

Per verificare se un report è pronto o quando è stato aggiornato l'ultima volta, vedere la colonna Stato .

Screenshot che mostra lo stato del report.

Visualizzare il report nell'interfaccia di amministrazione di SharePoint

Quando un report è pronto, selezionarlo per visualizzare i dati. Puoi visualizzare i primi 100 record che ospitano il maggior numero di agenti. È possibile cercare siti o filtrare in base al modello di sito e ai criteri di governance.

Screenshot che mostra il report dell'agente.

Applicare criteri di governance del contenuto nell'interfaccia di amministrazione di SharePoint

È possibile applicare criteri di governance del contenuto ai siti dal report di informazioni dettagliate. I criteri disponibili sono Limita i criteri di accesso al sito e Limita i criteri di individuazione del contenuto.

Screenshot che mostra come applicare il DMC.

Nota

Dopo aver applicato un criterio al sito dal report di informazioni dettagliate, lo stato dei criteri nel report esistente non viene aggiornato. Per visualizzare lo stato aggiornato del criterio nel sito, selezionare il criterio per visualizzare lo stato più recente o accedere al pannello Sito attivo e rivedere le impostazioni del sito.

Report informazioni dettagliate agente in SharePoint Online Management Shell

È possibile generare e gestire report di approfondimenti agente tramite SharePoint Online Management Shell.

  1. Se non è ancora stato fatto, scaricare e installare la versione più recente di SharePoint Online Management Shell.

  2. Connettersi a SharePoint Online almeno come amministratore di SharePoint in Microsoft 365. Per ulteriori informazioni, vedere Introduzione a SharePoint Online Management Shell.

  3. Per generare e visualizzare questi report, assicurarsi che l'organizzazione disponga dello SKU del componente aggiuntivo Gestione avanzata SharePoint o della licenza di Microsoft Copilot.

Con le autorizzazioni di almeno un amministratore di SharePoint, è possibile generare e visualizzare il report di approfondimenti usando i comandi seguenti:

  1. Per generare un report per la durata predefinita del report di un giorno, esegui il comando riportato di seguito:

    Start-SPOCopilotAgentInsightsReport
    
  2. Per generare un report per qualsiasi altra durata (7, 14 o 28 giorni), eseguire il comando seguente:

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
    

    Ad esempio, per generare un report degli ultimi 28 giorni, eseguire il comando:

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
    
  3. Per controllare lo stato di tutti i report attivi e disponibili, eseguire il comando seguente:

    Get-SPOCopilotAgentInsightsReport
    
  4. Per controllare lo stato di un report specifico, eseguire il comando seguente:

    Get-SPOCopilotAgentInsightsReport –ReportId
    
  5. Per scaricare e visualizzare il report, eseguire il comando seguente:

    Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
    

    Nota

    PowerShell visualizza fino a 100 record, ma i report scaricati possono contenere fino a 1 milione di record.

    Get-SPOCopilotAgentInsightsReport –ReportId -Action View
    
  6. Per visualizzare report più dettagliati, utilizza le opzioni seguenti:

    1. CopilotAgentsOnSites: fornisce il nome di tutti gli agenti attualmente disponibili su tutti i siti. Questo report contiene fino a 1.000.000 di record.

      Nota

      Il valore predefinito per il -Content parametro è CopilotAgentsOnSites.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
      
    2. TopSites: fornisce un elenco di 100 siti con il numero di agenti disponibili in ogni sito.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
      
    3. SiteDistribution: fornisce la visualizzazione riepilogata degli agenti in tutti i tipi di siti, ad esempio i siti di comunicazione, i siti connessi ai gruppi di Microsoft 365, i siti di OneDrive e altro ancora.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
      

Report sulla raccolta dei dati per gli approfondimenti sugli agenti in SharePoint

Se non si ha una licenza di Gestione avanzata di Microsoft SharePoint, è necessario abilitare la raccolta dei dati. Questa sezione spiega come abilitare e controllare lo stato della raccolta dei dati per il report Insights sugli agenti in SharePoint.

Abilitare la raccolta dei dati

Questo comando di PowerShell avvia la raccolta dei dati di controllo per i report sulle attività degli ultimi 28 giorni.

Start-SPOAuditDataCollectionForActivityInsights  

Disabilitare la raccolta dati

Questo comando di PowerShell interrompe la raccolta dei dati di controllo per i report sulle attività degli ultimi 28 giorni.


Stop-SPOAuditDataCollectionForActivityInsights  

Controllare lo stato della raccolta dati

Dopo aver abilitato la raccolta dei dati, è possibile generare i report dopo 24 ore. Per verificare se è possibile generare report, utilizzare il comando Get-SPOAuditDataCollectionStatusForActivityInsightsPowerShell . Il comando restituisce lo stato corrente della raccolta dati, che può essere NotInitiated, InProgress, o Paused. È possibile generare report quando lo stato è InProgress.

Get-SPOAuditDataCollectionStatusForActivityInsights 

Esperienze note con i report di informazioni dettagliate degli agenti in SharePoint

Le esperienze seguenti sono note con i report di informazioni dettagliate sugli agenti generati nell'interfaccia di Amministrazione di SharePoint o tramite SharePoint Online Management Shell:

  • È possibile eseguire nuovamente un report solo dopo 24 ore dall'ultimo report generato.

  • Nei tenant di grandi dimensioni, potrebbero essere necessarie fino a 48 ore prima che i dati siano disponibili.

  • Per ogni valore di intervallo di report (1, 7, 14 o 28 giorni) può esistere un solo report. Questa limitazione significa che è possibile visualizzare un massimo di quattro report in un determinato momento.

  • Il report appena generato sostituisce quello creato in precedenza con lo stesso intervallo di date. Per mantenere il report creato in precedenza, scaricarlo prima di crearne uno nuovo per lo stesso intervallo di date.

  • Questi report usano i dati di controllo unificato di Microsoft 365 e potrebbero non coprire tutti gli eventi di controllo.