Saltar al contenido principal
Las tareas son trabajos programados que un agente o Maya ejecuta por ti, una sola vez o con un intervalo repetido. Puedes usarlas para generar informes diarios, revisar fuentes de datos, enviar recordatorios o lanzar acciones en aplicaciones conectadas. Las tareas siguen funcionando aunque no estés conectado, y se mantienen en todas las versiones publicadas de un agente. Puedes ver todas tus tareas en la página Tareas. Para configurar las tareas de un agente concreto, abre el agente, ve a Configurar y selecciona Tareas.

Tipos de tareas y disparadores

Una tarea empieza a partir de una programación o de un evento de una aplicación. En las tareas programadas puedes definir una fecha de inicio, una hora de fin opcional y días excluidos. Las tareas por evento de integración empiezan cuando la aplicación conectada lanza su disparador. Describes la tarea en lenguaje natural, igual que un mensaje de chat, y el agente la lleva a cabo.

Estados y filtros

Cada tarea aparece con un estado para que veas de un vistazo cómo está.

Activa

La tarea está activada y se ejecutará a su próxima hora programada o cuando se lance su disparador.

En pausa

La tarea está desactivada y no se ejecutará hasta que la vuelvas a activar.

Requiere atención

La tarea ha fallado cinco ejecuciones seguidas, o su destino ya no es válido. Corrige la causa y después reanúdala.

Completada

Aquí aparecen las tareas de una sola vez que ya se han ejecutado.
En la página Tareas, usa el filtro de estado para elegir qué tareas ver: Activos, En pausa, Requieren atención, Completados o Todos.

Historial de ejecuciones y transcripciones

Cada tarea guarda un historial de ejecuciones. Selecciona una tarea para abrir su panel de detalles y ver las ejecuciones recientes, sus marcas de tiempo y sus resultados. En cualquier ejecución, puedes abrir la transcripción para leer los mensajes exactos que produjo el agente. Esto es útil para depurar, auditar resultados o confirmar que una tarea terminó como esperabas.

Destinos de entrega

Cuando una tarea termina, puedes enviar sus resultados a uno o varios destinos. Si no eliges ningún destino, la tarea se ejecuta igualmente y sus resultados se guardan en el historial de ejecuciones. Los destinos disponibles incluyen:
  • Un chat de la aplicación web de Kolmena, incluidos los chats de enjambres
  • Una conversación de Telegram
  • Un canal de Discord
  • Una URL de webhook
Si se elimina un chat de destino o se desvincula una aplicación conectada, la tarea mostrará Requiere atención. Edita la tarea y elige un destino válido para reanudarla.

Límites y comportamiento

  • 25 tareas abiertas por usuario (activas o en pausa)
  • Una ejecución a la vez por tarea. Si una ejecución sigue en curso cuando debería empezar la siguiente, la nueva se omite.
  • El intervalo mínimo es de 15 minutos.
  • Cinco fallos consecutivos pausan la tarea automáticamente. Reanúdala después de corregir la causa.
  • Las tareas se mantienen en todas las versiones publicadas de un agente. No necesitas volver a crearlas cuando publicas una versión nueva.

Errores habituales y qué hacer

Próximos pasos

Crea una tarea

Sigue paso a paso cómo crear una tarea programada o activada por un evento.

Configura tu agente

Aprende cómo funciona la publicación y por qué las tareas se mantienen entre versiones.