Monitoriza a los agentes usando el Inventario de Agentes en el Kit de Agentes de Copilot

La función Inventario de Agentes ofrece a los administradores una visibilidad a nivel de inquilino sobre todos los agentes personalizados y declarativos de Copilot Studio en la organización, en distintos entornos. Los datos de inventario de agentes incluyen metadatos del ciclo de vida y de la propiedad, señales de configuración y adopción de capacidades, indicadores de gobernanza y métricas de uso.

Note

Este artículo describe la experiencia actual del inventario de agentes. La experiencia previa está documentada en el repositorio Copilot Agent Kit en GitHub en el archivo AGENT_INVENTORY_V1.md.

Panel de control

El panel Inventario de agentes le ofrece un resumen en todo el inquilino y una navegación detallada en el inventario. Selecciona un mosaico, gráfico o elemento de la lista para abrir una vista filtrada en la cuadrícula de agentes.

Contexto del inventario

La fila de estado en la parte superior del panel muestra el estado actual del inventario:

Ya sea que el inventario esté actual, vacío o que haya una sincronización en curso.
El porcentaje de registros enriquecidos con configuraciones detalladas.
Número de agentes con detalles limitados.
El número de entornos sincronizados.
El último tiempo de sincronización exitoso, cuando está disponible.

Métricas del portafolio

Las casillas métricas te ayudan a saltar directamente a segmentos importantes del inventario:

Número de agentes
Impulsado por
Agentes autónomos
Agentes de redacción
Agentes con conocimiento

Selecciona un mosaico para abrir la cuadrícula de agentes filtrada por ese segmento. The Powered by tile agrupa a los agentes en categorías como Estándar, GitHub Copilot y Copilot Chat.

Analítica y gobernanza

El panel también incluye gráficos y listas que te ayudan a detectar patrones y riesgos:

Crecimiento de cartera con rangos de seis y doce meses.
Distribución de autenticación .
Prioridades de gobernanza que requieren revisión de los administradores.
Distribución del estado de la cartera .
Adopción de capacidades en agentes enriquecidos.
Entornos principales clasificados por número de agentes.
Agentes que supervisan los registros que requieren atención.

Los porcentajes dependen de los entornos para los que las identidades de conexión configuradas pueden recuperar datos de agentes y configuraciones detalladas. Aprende más sobre los modos de recopilación de datos.

Ver todos los agentes

Selecciona Ver inventario completo desde el panel de control para abrir la cuadrícula del agente. Utiliza la cuadrícula para encontrar, agrupar y exportar datos de inventario.

Puedes filtrar, ordenar y agrupar por cualquier columna, añadir o eliminar columnas para adaptar la cuadrícula a tus necesidades, y exportar la vista actual a Excel.

Detalles del agente

Selecciona el nombre de un agente en la cuadrícula para abrir los detalles del agente. El encabezado muestra la identidad del agente, el contexto del entorno, el estado del ciclo de vida, la propiedad y las acciones disponibles. Un banner de información te indica si el registro tiene enriquecimiento completo de Dataverse o solo detalles limitados de configuración.

Pestaña Visión general

La pestaña Resumen muestra el resumen del agente y la información del entorno, la postura de gobernanza y las señales, y una instantánea de uso cuando existe el historial de uso. Si las descripciones generadas por IA están habilitadas y el agente es un agente elegible de GitHub agente de Copilot, también se muestra una descripción generada por IA.

Pestaña de componentes

La pestaña Componentes aparece solo cuando hay datos de componentes disponibles para el agente. Utiliza esta pestaña para explorar la arquitectura del agente en la vista del mapa de Componentes , navegar por el contenido categorizado en la vista de grupo de Componentes , expandir un grupo de componentes poblado a la vez, activar el modo Raw para inspeccionar el JSON o copiar el JSON de los componentes para investigación o soporte.

Pestaña Uso

La pestaña de Uso aparece solo cuando existen registros de uso para el agente. Incluye:

Los rangos de mes hasta la fecha, los dos meses naturales anteriores, los últimos tres meses y los últimos seis meses. Los últimos seis meses se seleccionan por defecto.
Total de créditos de Copilot y media de créditos por semana activa.
Usuarios reportados y función de uso principal.
Tendencias semanales de crédito.
Resumen de uso, créditos por reportaje y canal, y registros recientes de uso.
Una exportación de Excel específica para agentes.

Pestaña de metadatos

La pestaña de Metadatos está siempre disponible. Utilízalo para inspeccionar valores técnicos como el ID del agente y el nombre del esquema, ID y URL del entorno, identificadores de ubicación y fuente, y los campos de inventario en bruto usados para diagnósticos e integración.

Sincronizar o actualizar los datos de inventario

El Inventario de Agentes separa la sincronización de la actualización del panel.

Agentes de sincronización

Selecciona Sincronizar agentes cuando necesites volver a recopilar el inventario del inquilino. La sincronización sigue los filtros, grupos de entorno, modo de recogida de datos, configuración de uso y programación guardados en Configurar Inventario de Agentes.

Mientras se ejecuta una sincronización:

El estado del inventario cambia a Sincronización en proceso.
Los agentes de sincronización están deshabilitados para evitar operaciones duplicadas.
No hay opciones que puedan cambiar la configuración de sincronización activa.
El panel de control recarga los detalles del agente, el historial de uso, el estado de sincronización y la información de última sincronización una vez que se estabiliza la sincronización.

Actualizar datos del panel de control

Seleccione Actualizar datos del panel para recargar los datos ya almacenados en las tablas de Detalles del Agente e Historial de Uso . Refresh no inicia una sincronización de agentes ni redescubre entornos ni agentes. Úsalo después de una sincronización completa, o cuando el panel muestre datos almacenados en caché obsoletos.

Importante

La sincronización de agentes no usa créditos de Copilot. Los créditos se usan solo cuando se habilitan las descripciones generadas por IA y se visita una página de detalles de GitHub agente de Copilot elegible.

Acciones de gobernanza

El Inventario de Agentes soporta acciones de Reasignación, Cuarentena y Descuarentena . Las acciones solo aparecen cuando cada agente seleccionado es elegible.

Disponibilidad de acciones

La columna de Estado en la cuadrícula se rellena durante la última sincronización de inventario y refleja el valor que proviene del centro de administración de Power Platform (datos de One Inventario). Qué acciones se muestran dependen de cuántos registros selecciones y de su estado.

Action	Regla de selección	Oculto cuando
Reasignar	Se puede seleccionar uno o varios registros (hasta un máximo de 50).	Ningún agente seleccionado es elegible para una reasignación.
Cuarentena	Se puede seleccionar uno o varios registros en estado de Borrador o Disponible (hasta un máximo de 50).	Cualquier agente seleccionado está bloqueado o no es elegible para cuarentena.
Quitar cuarentena	Se puede seleccionar uno o varios registros en estado Bloqueado (hasta un máximo de 50).	Cualquier agente seleccionado es Borrador, Disponible o no es elegible para quitar la cuarentena.

Si algún registro seleccionado es incompatible con una operación, esa operación queda oculta en la barra de comandos. Los registros cuyo contexto del centro de administración de Power Platform no coincide con el entorno de inventario no reciben acciones de gobernanza no soportadas.

En la página de detalles del agente , la disponibilidad de cuarentena y descuarentena se basa en el estado en activo del agente, en lugar del estado sincronizado que se muestra en la cuadra.

Volver a asignar

Algunas organizaciones exigen que los agentes tengan propietarios para fines de cumplimiento. El propietario puede editar el agente, publicar actualizaciones, eliminarlo o compartirlo con sus compañeros según sus permisos.

Selecciona Reasignar y elige un usuario que tenga una licencia Microsoft 365 Copilot. Para la reasignación masiva, el diálogo muestra los entornos seleccionados, agentes, propietarios actuales y estado de operaciones. Una vez completada la reasignación, el estado de la reasignación se muestra como completado para cada agente procesado con éxito.

Cuarentena y descuarentena

La cuarentena bloquea a un agente elegible. Quitar cuarentena restaura un agente bloqueado apto. El diálogo de confirmación identifica a los agentes, entornos y estados afectados antes de que se envíe una operación.

Las acciones masivas soportan hasta 50 agentes por operación y solo están disponibles cuando cada registro seleccionado es elegible.

Configuración del inventario del agente

Selecciona Configuración desde el encabezado del panel para abrir la configuración de sincronización de agentes. Úsalo para controlar qué entornos y tipos de agentes se recopilan, ajustar las opciones de inventario y establecer el calendario de sincronización y el modo de recogida.

Note

Estos ajustes dentro de la app asumen que las referencias de conexión necesarias para la solución ya están configuradas. Aprende más sobre cómo cablear las referencias de conexión en Configurar Inventario de Agentes.

Tipos de entorno

Elige qué tipos de entorno se escanean:

Desarrollador
Predeterminado
Sandbox
Producción
Prueba
Teams

Si no seleccionas un tipo de entorno, el sistema incluye todos los tipos de entorno.

Tipos de agente

Elige si el inventario incluye:

Agentes personalizados
Agentes declarativos

Si no seleccionas un tipo de agente, el inventario incluye todos los tipos de agentes.

Grupos ecologistas

Los grupos de entornos proporcionan ámbitos de sincronización reutilizables. Como administrador, puede hacer lo siguiente:

Crea y edita un grupo.
Selecciona los entornos miembros utilizando filtros de tipo de entorno y región.
Activa o desactiva el grupo.
Elimina un grupo que ya no necesites.

Si no activas un grupo, todos los entornos permitidos por las demás configuraciones están incluidos.

Opciones de inventario

Configura las siguientes opciones para controlar lo que el sistema recoge durante la sincronización:

Excluir agentes del sistema: Evita los agentes del sistema proporcionados por Microsoft durante la sincronización.
Habilitar la descripción generada por IA para agentes de GitHub Copilot: Permite la generación de descripciones cuando se visita una página de detalles de un agente elegible.
Incluir métricas de uso: Recoge la ventana de uso retenida de 180 días durante la sincronización.

Sincronización de horario y modo de recolección

Elige cómo se ejecuta la sincronización y qué modo de recogida de datos usar:

One Inventory (centro de administración Power Platform): Combina el inventario del centro de administración con datos del entorno para un descubrimiento más amplio y metadatos más ricos.
Estándar (solo entornos): Recupera el inventario directamente de entornos accesibles.
Activar sincronización automática diaria: Ejecuta el inventario del agente según el horario configurado del día.

Seleccione Guardar para aplicar los cambios. Guardar está deshabilitado cuando no se ha cambiado ninguna configuración, cuando hay un guardado en curso o cuando la configuración no está disponible durante una sincronización activa.

Tip

Utiliza Actualizar los datos del panel después de que se complete una sincronización cuando el panel de control necesite recargar los datos existentes de la tabla. Usa agentes de Sync solo cuando la recogida de inventario deba ejecutarse de nuevo. Mantenga los filtros de entorno y agente lo más limitados posible en inquilinos muy grandes, y deshabilite la recopilación de uso cuando no se requieran análisis de uso de 180 días.

Modos de recopilación de datos

El modo de recogida de datos determina cómo el sistema descubre y recopila los registros de los agentes.

Modo de One Inventory (recomendado)

Cuando configuras el modo de recogida en One Inventory, Agent Inventory utiliza los datos de One Inventary:

Recupera los datos de los agentes de One Inventory a través del centro de administración de Power Platform.
Lista los entornos utilizando la referencia de conexión Copilot Agent Kit - Power Platform for Admins V2.
Combina los datos del agente One Inventory con la lista de entornos para construir los detalles del entorno.
Para cada entorno, carga los detalles del agente en el Inventario de Agentes fusionando los agentes obtenidos del entorno con los datos correspondientes de One Inventario.

Utiliza este modo cuando necesites un descubrimiento de inquilinos más amplio y metadatos más ricos del centro de administración de Power Platform. Los agentes detectados a través del centro de administración, aunque no sean accesibles en su entorno, se siguen agregando con información limitada.

Modo estándar

Cuando se configura el modo de recogida en Estándar, Agent Inventory utiliza el enfoque estándar de recogida de datos:

Enumera todos los entornos mediante la referencia de conexión (V1) de Copilot Agent Kit - Power Platform for Admins.
Recoge agentes para cada entorno.
Carga los datos del agente en el Inventario del Agente.

Usa este modo cuando quieras que la colección dependa solo de entornos accesibles.

En ambos modos, Agent Inventory utiliza la referencia de conexión Copilot Agent Kit - Dataverse para conectarse a cada entorno y recopilar información detallada sobre el agente, incluyendo metadatos, uso de funciones y configuración. El sistema solo recupera información detallada para entornos donde la cuenta configurada tiene acceso de administrador del sistema.

Descubre más sobre la lista completa de conectores utilizados en todo el kit en Requisitos de conectores.

Métricas de uso

El Inventario del Agente puede conservar y mostrar hasta 180 días de datos de uso del agente. Para habilitar la analítica de uso:

Asegúrate de que las conexiones necesarias a la solución estén configuradas y permitidas por las políticas de datos.
Abre Configuración de sincronización del agente.
Activa Incluir métricas de uso.
Haga clic en Guardar.
Selecciona Sincronizar agentes o espera a la sincronización automática diaria.

Los datos de uso se almacenan en las tablas de Detalles del Agente e Historial de Uso . La pestaña de Uso de un agente aparece solo cuando hay registros de historial de uso coincidentes.

Configurar el HTTP con la conexión Microsoft Entra ID

Las métricas de uso dependen del HTTP con conector Microsoft Entra ID (preautorizado). Los valores de conexión dependen de la nube en la que esté alojado tu inquilino. Utiliza la URL de Recurso Base y el URI de Recurso de Microsoft Entra ID que coincidan con tu nube cuando crees la conexión.

Cloud	Dirección URL del recurso base	URI de recurso de Microsoft Entra ID
Comercial	`https://licensing.powerplatform.microsoft.com/`	`https://licensing.powerplatform.microsoft.com/`
GCC	`https://gov.licensing.powerplatform.microsoft.us/`	`https://gov.licensing.powerplatform.microsoft.us/`
GCC High	`https://high.licensing.powerplatform.microsoft.us/`	`https://high.licensing.powerplatform.microsoft.us/`

Permisos y requisitos de conectores

Las referencias de conexión en la solución limitan y controlan la visibilidad para los agentes. Para una visibilidad completa a nivel de tenant, configura las referencias de conexión con una cuenta que tenga el rol de administrador de Power Platform . Para recuperar todos los detalles a nivel de funcionalidad, esa cuenta también necesita acceso de administrador de sistemas a los entornos relevantes. Puede usar otras cuentas, pero la visibilidad del inventario del agente se limita a los entornos en los que el usuario tiene acceso de administrador del sistema.

El Inventario de Agentes se basa en los siguientes conectores, que las políticas de datos aplicadas al entorno deben permitir:

Microsoft Dataverse
Power Platform para administradores
Power Platform para administradores V2
HTTP con Microsoft Entra ID (autenticado previamente)