Estabilización de Cron: Normalización y alineación de esquemas

Seguro te ha pasado: envías una petición a la API que parece correcta, pero falla porque el esquema no coincide exactamente con lo que el Gateway espera. Es frustrante lidiar con errores de validación cuando solo intentas programar una tarea básica, especialmente cuando las herramientas automáticas o los agentes envían datos con estructuras ligeramente distintas.

Hemos detectado que muchas llamadas a cron.add fallaban por falta de parámetros como sessionTarget o wakeMode, o por enviar objetos envueltos en capas adicionales. Para solucionar esto, hemos implementado una capa de normalización que hace el sistema mucho más tolerante y consistente.

Requisitos previos

• Acceso al Gateway para realizar peticiones cron.add o cron.update.
• Uso de herramientas de agentes (Agent tool calls) para programar tareas.
• Acceso a la Control UI para monitorizar el estado de los jobs.
• CLI actualizado para ver los nuevos proveedores.

Inicio rápido

Para empezar a aprovechar estas mejoras, no necesitas cambiar radicalmente tu flujo de trabajo. El Gateway ahora es más inteligente al procesar tus peticiones.

1. Envía tus peticiones cron.add: Ya no te preocupes si tus datos vienen envueltos en un objeto data o job. El Gateway los desempaqueta automáticamente.
2. Omite campos redundantes: Si no incluyes schedule.kind o payload.kind, el sistema los inferirá siempre que sea seguro.
3. Usa proveedores consistentes: Ahora puedes usar Discord, Slack, Signal e iMessage de forma uniforme en la CLI, la UI y el Gateway.
4. Verifica en la Control UI: Revisa el estado de tus tareas; ahora el contador de jobs mostrará la información correcta directamente desde el campo jobs del Gateway.

Solución de problemas

Si encuentras problemas al configurar tus cron jobs, revisa estos casos comunes basados en nuestros logs recientes:

• Error INVALID_REQUEST en cron.add: Esto solía ocurrir por esquemas malformados o payloads envueltos. Con la nueva normalización, el Gateway debería aceptar estas peticiones, pero asegúrate de que el contenido del job sea válido tras el desempaquetado.
• El contador de jobs no aparece en la UI: Si la Control UI no muestra el número de tareas, asegúrate de refrescar la página. Hemos corregido el mapeo para que la UI use el campo jobs en lugar de jobCount.

¿Necesitas ayuda con una configuración específica? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Cron jobs: Revisa la documentación actualizada sobre la estructura normalizada y los ejemplos de uso.