Informe de conclusiones sobre agentes en SharePoint

El informe de conclusiones sobre agentes en SharePoint proporciona a los administradores de SharePoint información detallada sobre los agentes creados recientemente en todos los sitios de SharePoint y los sitios de OneDrive dentro de su organización. Este informe ayuda a los administradores a obtener información sobre los sitios con el mayor número de agentes creados. Con este informe, los administradores de SharePoint pueden controlar y mantener aún más la integridad del contenido usado por los agentes como datos de conexión a tierra.

El informe de conclusiones se basa en los datos de auditoría de Microsoft registrados para los agentes creados en SharePoint a través de los eventos FileCreated y FileRenamed.

Puede generar y administrar el informe de conclusiones del agente en el Centro de Administración de SharePoint o mediante Shell de administración de SharePoint Online.

Lo que necesita para acceder al informe de conclusiones del agente

Consulte Requisitos previos de Administración avanzada de SharePoint.

Cómo acceder al informe de conclusiones del agente en el Centro de Administración de SharePoint

1. Inicie sesión en el Centro de administración de SharePoint con las credenciales de administrador de SharePoint para su organización.

2. En el panel de navegación, expanda Informes y, a continuación, seleccione Agent Insights.

Creación de informes en el Centro de Administración de SharePoint

1. Como administrador de SharePoint, seleccione Crear un informe para crear el informe.

   

2. Escriba el nombre del informe. En Duración del informe, especifique el período de tiempo para el informe.

   

3. Seleccione Crear y ejecutar.

Ver el estado del informe en el Centro de Administración de SharePoint

Para comprobar si un informe está listo o cuándo se actualizó por última vez, consulte la columna Estado .

Ver informe en el Centro de Administración de SharePoint

Cuando un informe esté listo, selecciónelo para ver los datos. Puede ver los 100 registros principales que hospedan el mayor número de agentes. Puede buscar sitios o filtrar en la plantilla de sitio y las directivas de gobernanza.

Aplicación de directivas de gobernanza de contenido en el Centro de Administración de SharePoint

Puede aplicar directivas de gobernanza de contenido en los sitios desde el informe de conclusiones. Las directivas disponibles son Restringir la directiva de acceso al sitio y Restringir la directiva de detección de contenido.

Informe de conclusiones del agente en Shell de administración de SharePoint Online

Puede generar y administrar informes de conclusiones del agente mediante Shell de administración de SharePoint Online.

1. Si aún no lo ha hecho, descargue e instale la versión más reciente de Shell de administración de SharePoint Online.

2. Conéctese a SharePoint Online como al menos un administrador de SharePoint en Microsoft 365. Para obtener más información, consulte Introducción a Shell de administración de SharePoint Online.

3. Para generar y ver estos informes, asegúrese de que la organización tiene la SKU del complemento administración avanzada de SharePoint o la licencia de Microsoft 365 Copilot.

Con permisos de al menos un administrador de SharePoint, puede generar y ver el informe de conclusiones mediante los siguientes comandos:

1. Para generar un informe para la duración predeterminada del informe de un día, ejecute el siguiente comando:

   Start-SPOCopilotAgentInsightsReport
   

2. Para generar un informe durante cualquier otra duración (7, 14 o 28 días), ejecute el siguiente comando:

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
   

   Por ejemplo, para generar un informe durante los últimos 28 días, ejecute el comando :

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
   

3. Para comprobar el estado de todos los informes activos y disponibles, ejecute el siguiente comando:

   Get-SPOCopilotAgentInsightsReport
   

4. Para comprobar el estado de un informe específico, ejecute el siguiente comando:

   Get-SPOCopilotAgentInsightsReport –ReportId
   

5. Para descargar y ver el informe, ejecute el siguiente comando:

   Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
   

   Nota:

   PowerShell muestra hasta 100 registros, pero los informes descargados pueden contener hasta un millón de registros.

   Get-SPOCopilotAgentInsightsReport –ReportId -Action View
   

6. Para ver informes más detallados, use las siguientes opciones:

   1. CopilotAgentsOnSites: proporciona el nombre de todos los agentes disponibles actualmente en todos los sitios. Este informe contiene hasta 1000 000 registros.

      Nota:

      El valor predeterminado del -Content parámetro es CopilotAgentsOnSites.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
      

   2. TopSites: proporciona una lista de 100 sitios con el número de agentes disponibles en cada sitio.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
      

   3. SiteDistribution: proporciona la vista resumida de los agentes en todos los tipos de sitios, como sitios de comunicación, sitios conectados del grupo de Microsoft 365, sitios de OneDrive, etc.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
      

Recopilación de datos para informes de información sobre agentes en SharePoint

Si no tiene una licencia de Administración avanzada de Microsoft SharePoint, debe habilitar la recopilación de datos. En esta sección se explica cómo habilitar y comprobar el estado de la recopilación de datos para el informe de Insights sobre los agentes en SharePoint.

Habilitar recopilación de datos

Este comando de PowerShell comienza a recopilar datos de auditoría para informes sobre actividades de los últimos 28 días.

Start-SPOAuditDataCollectionForActivityInsights  

Deshabilitación de la recopilación de datos

Este comando de PowerShell deja de recopilar datos de auditoría para informes sobre actividades de los últimos 28 días.

Stop-SPOAuditDataCollectionForActivityInsights  

Comprobación del estado de la recopilación de datos

Después de habilitar la recopilación de datos, puede generar los informes después de 24 horas. Para comprobar si puede generar informes, use el comando Get-SPOAuditDataCollectionStatusForActivityInsightsde PowerShell . El comando devuelve el estado de la recopilación de datos actual, que puede ser NotInitiated, InProgresso Paused. Puede generar informes cuando el estado es InProgress.

Get-SPOAuditDataCollectionStatusForActivityInsights 

Experiencias conocidas con informes de conclusiones de agente en SharePoint

Las siguientes experiencias se conocen con los informes de conclusiones del agente generados en el Centro de Administración de SharePoint o mediante Shell de administración de SharePoint Online:

• Puede volver a ejecutar un informe solo después de 24 horas desde que se generó el último informe.

• En los inquilinos grandes, los datos pueden tardar hasta 48 horas en estar disponibles.

• Solo puede existir un informe para cada valor de intervalo de informes (1, 7, 14 o 28 días). Esta limitación significa que puede ver un máximo de cuatro informes en un punto determinado.

• El informe recién generado reemplaza el informe creado anteriormente por el mismo intervalo de fechas. Para conservar el informe creado anteriormente, descargue primero el informe antes de crear un nuevo informe para el mismo intervalo de fechas.

• Estos informes usan datos de auditoría unificados de Microsoft 365 y es posible que no cubran todos los eventos de auditoría.

Artículos relacionados

• Restricción del acceso al sitio de SharePoint con grupos de Microsoft 365 y grupos de seguridad Microsoft Entra
• Restringir la detección de sitios y contenido de SharePoint
• Módulo Microsoft.Online.SharePoint.PowerShell