Cómo automatizar reportes con scheduled tasks

Las scheduled tasks o tareas programadas en Antigravity son una funcionalidad subestimada que te permite automatizar procesos que corren en segundo plano, como generar reportes cada hora sin intervención manual. Si trabajas con microservicios y quieres que ciertas acciones se ejecuten solas de forma recurrente, esto te va a interesar.

Antes de crear cualquier tarea programada, necesitas un servicio que la ejecute. Por eso el primer paso es levantar el microservicio Report Service, que será el encargado de generar los reportes de gastos automáticamente.

Cómo se crea el microservicio Report Service antes de programar tareas

Todo empieza con el scaffold del microservicio. Se copia un prompt específico desde el archivo asociado a la clase, se pega en Antigravity usando la plantilla de Gemini y se ejecuta con Enter [00:29].

Este proceso genera la estructura base del Report Service. Y aquí viene lo importante: hay que esperar a que termine por completo antes de crear la tarea programada, porque ese microservicio es justamente el que se va a encargar de correr el schedule [01:38].

¿Qué hace el Report Service? Es el microservicio que genera reportes de gastos. Suma las transacciones registradas por categoría, las compara contra los presupuestos actuales y guarda el resultado, indicando explícitamente cuándo una categoría excede su presupuesto.

El prompt del reporte recurrente describe exactamente esto: cada hora genera un reporte de gastos, agrupa transacciones por categoría, las contrasta con el budget y marca cualquier exceso.

Qué son las scheduled tasks y cómo agregarlas al proyecto

Una scheduled task es una acción que se ejecuta de forma automática y recurrente en momentos que tú defines. En Antigravity existen dos formas de crearlas.

La primera es a través de la interfaz gráfica, donde defines sobre qué proyecto corre la tarea y en qué horarios específicos [00:57]. Es la manera más simple y directa.

La segunda opción, que es la que se usa en la práctica, se hace desde las conversaciones. Aquí conviene tener claras las diferencias entre ambos métodos:

• Desde la interfaz gráfica seleccionas el proyecto, le das un nombre, eliges la frecuencia y escribes el prompt.
• Desde la conversación aprovechas el contexto que ya construiste con el agente.
• Cuando programas desde el menú superior, no necesitas indicar en el texto cada cuánto se ejecuta, porque la frecuencia se configura aparte.

Esa distinción define dónde vas a ver los resultados después, algo clave para el alcance de la tarea.

Cómo se ejecuta una scheduled task desde el chat con acciones

Dentro del chat puedes llamar distintas acciones escribiendo una barra vertical. Al hacerlo, aparecen varias opciones, incluyendo componentes como servidores MCP [02:41].

La acción que se usa aquí es Schedule. Presionas Enter, pegas el prompt del reporte recurrente y ejecutas. Aunque el ejemplo corre cada hora, en la vida real este tipo de procesos suele configurarse con menor frecuencia, como una vez al día o una vez por semana.

¿Dónde veo una scheduled task corriendo? En el Overview, en la esquina inferior derecha aparece un background task. Esa es la tarea que corre continuamente y, en este caso, genera un reporte cada hora.

Los reportes dentro de Antigravity también son artifacts, así que pueden generarse en distintos formatos según lo que pidas.

Por qué importa el alcance de una tarea programada

El detalle más importante es el scope o alcance. Una tarea creada desde el chat vive solo dentro de esa conversación o sesión con el agente [04:04].

Si quieres una tarea que cubra todo el proyecto, tienes que crearla desde el menú superior. Ahí seleccionas el proyecto, le pones nombre, defines frecuencia y escribes el prompt de la misma forma.

Cuando la creas a nivel proyecto, los reportes ya no aparecen en la sesión. Para verlos vas a la opción Schedule Task, haces clic en tu schedule y los eventos empiezan a listarse en la parte inferior [04:33].

¿Cuál es la diferencia entre una tarea de sesión y una de proyecto? La de sesión solo funciona dentro de la conversación donde la creaste y sus resultados aparecen ahí mismo. La de proyecto cubre todo el proyecto y sus eventos se consultan desde la opción Schedule Task.

Esta diferencia decide si tu automatización es temporal o permanente.

Hasta dónde llegan las scheduled tasks: sidecar y triggers

Aunque suele pasar desapercibida, esta funcionalidad es extremadamente poderosa. Hace unos meses Google presentó 93 agentes trabajando en tándem al mismo tiempo, todo gracias a este tipo de tareas [04:58].

Eso significa que puedes escalar o reducir la cantidad de scheduled tasks de forma masiva. Y Antigravity no se queda en los cron jobs tradicionales.

Aquí es donde entra un objeto llamado Sidecar, que permite configuraciones mucho más avanzadas:

• Puedes crear triggers basados en acciones, no solo en horarios.
• El archivo sidecar.json abre la puerta a configuraciones más complejas.
• No se usa en el curso, pero es un reto abierto para que experimentes por tu cuenta.

El cron job programa por tiempo, mientras que un trigger de sidecar reacciona a eventos, y esa flexibilidad cambia por completo lo que puedes automatizar.

Con esto ya tienes una tarea corriendo en segundo plano cada hora. Si te animas a investigar sidecar.json y a probar tus propios triggers, cuéntame en los comentarios qué lograste automatizar.