Existe una ironía en el mundo de los informes de TI: cuanto más útiles, más trabajo dan. Recopilar, montar, formatear y enviar — cada semana. El Agente de Informes del Portal Nyverra ITSM existe para transformar ese ciclo en una operación automática, disparada por playbooks.

Esta guía explica qué hace el módulo, cómo disparar y reejecutar informes y por qué el historial de ejecuciones es esencial para confiar en el proceso.

Interfaz del módulo en el Portal Nyverra ITSM.

Qué es el Agente de Informes

Es el componente del Portal que ejecuta el trabajo de los informes: dispara un playbook (un guion de generación), monta los informes y registra cada ejecución. En lugar de que una persona haga clic en “generar”, el agente se encarga del ciclo.

Concepto	Qué es
Playbook	Guion que describe lo que el agente debe generar
Ejecución	Una ronda del agente (manual o programada)
Historial	Registro de las ejecuciones y sus resultados

Para qué sirve en el día a día

• Informes recurrentes: generar periódicamente los mismos conjuntos de datos.
• Distribución: integrarse a los informes programados y enviar por correo electrónico.
• Reejecución: rehacer una generación que falló, sin esperar el próximo ciclo.
• Visibilidad: seguir lo que se ejecutó, cuándo y con qué resultado.

Recursos del módulo

Recurso	Qué hace
Disparar playbook	Inicia una ejecución del agente
Reejecutar	Repite una generación específica
Historial de ejecuciones	Lista rondas, estado y resultados
Integración	Se conecta a los informes programados y al historial de informes

Quién lo usa

Perfil	Uso típico
Administrador	Configurar el agente y los playbooks
Gestor	Recibir informes recurrentes automáticamente
Operación	Reejecutar generaciones que fallaron

Cómo usar: paso a paso

1. Configure el agente y los informes que debe producir.
2. Dispare el playbook (o déjelo programado).
3. Siga las ejecuciones en el historial del módulo.
4. Reejecute en caso de fallo o necesidad puntual.
5. Combine con informes programados para la rutina de distribución.

Reglas de negocio y cuidados

Punto	Explicación
Fallos	Una ejecución puede fallar (datos, permisos, integración) — supervise.
Reejecución	Útil para recuperar generaciones sin esperar el próximo ciclo.
Datos	Los números reflejan la base de datos en el momento de la ejecución.
Ventana	Las generaciones pesadas deben ejecutarse en horario de menor carga.

Buenas prácticas

• Supervise los fallos para no dejar informes pendientes silenciosamente.
• Use la reejecución para recuperar rápidamente una generación con error.
• Combine agente + informes programados para automatizar la entrega.
• Programe ejecuciones pesadas en ventana de baja carga.
• Mantenga un inventario de qué playbooks generan qué informes.

Errores comunes

Situación	Qué hacer
El informe no llegó	Verifique el historial de ejecuciones y la auditoría de entregas.
La ejecución falló	Revise el error y use la reejecución después de corregir.
Generación lenta	Reprograme para horario de menor carga.

Preguntas frecuentes

¿El agente sustituye los informes programados?
Complementa: el agente genera; la programación distribuye.

¿Puedo reejecutar solo un informe?
Sí, mediante la acción de reejecución.

¿Cómo sé si se ejecutó?
Por el historial de ejecuciones del módulo.

Automatice mediante API

El agente está expuesto mediante API (/api/report-agent y correlatos), lo que permite disparar y supervisar ejecuciones. Referencia en developer.nyverra.com.

Escenarios de uso: información en piloto automático

1. Informes recurrentes. Cada lunes, el playbook genera los informes de la semana y la programación los entrega. El gestor comienza el día con información, sin que nadie “monte” nada.

2. Recuperación de fallos. Una generación falla por error de integración. Corregido el problema, la reejecución rehace el informe sin esperar el próximo ciclo.

3. Auditoría de ejecuciones. El historial muestra qué se ejecutó, cuándo y con qué resultado — útil para demostrar que los informes obligatorios fueron generados.

KPIs del agente

Indicador	Qué revela
Ejecuciones con éxito vs fallo	Confiabilidad del proceso
Tiempo medio de ejecución	Eficiencia
Reejecuciones necesarias	Estabilidad
Informes generados por período	Cobertura de la automatización

Cómo operar bien el agente

Supervise los fallos — una generación que falla en silencio es un informe que “desapareció”. Programe ejecuciones pesadas en ventana de baja carga. Mantenga el inventario de qué playbooks generan qué informes. Y combine con los informes programados: el agente es la fábrica, la programación es la entrega. Juntos, eliminan el trabajo manual que suele convertir la “gestión de informes” en tiempo perdido cada semana.

Lista de verificación del agente

1. Configure los playbooks e informes.
2. Programe o dispare manualmente.
3. Supervise el historial de ejecuciones.
4. Reejecute en caso de fallo.
5. Programe cargas pesadas en baja demanda.
6. Combine con informes programados.

Preguntas frecuentes adicionales

¿El agente sustituye la programación?
Complementa: el agente genera; la programación distribuye.

¿Cómo recupero una generación que falló?
Mediante la reejecución.

¿Dónde veo el resultado?
En el historial de ejecuciones y en el historial de informes.

Conclusión

Con el Agente de Informes, el Portal Nyverra ITSM entrega información en piloto automático. Menos tiempo montando informes, más tiempo usando lo que revela — y un historial que muestra, en cada ejecución, que el proceso funcionó.