> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolmena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción de las tareas: automatiza trabajos recurrentes y puntuales

> Descubre cómo las tareas permiten que los agentes y Maya ejecuten trabajos programados, cómo supervisar estados e historial de ejecuciones, y cómo enviar resultados a chats, Telegram, Discord o webhooks.

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](https://app.kolmena.ai/jobs). 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.

| Tipo de disparador | Qué inicia la tarea | Ejemplos |
| - | - | - |
| Programación | Una hora o un intervalo fijos | Una vez, cada hora, diaria, semanal, mensual o un intervalo personalizado |
| Evento de integración | Un evento de una aplicación conectada | Una fila nueva en una hoja de cálculo, el envío de un formulario o un webhook |

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á.

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

> [card] En pausa
>
> La tarea está desactivada y no se ejecutará hasta que la vuelvas a activar.

> [card] 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.

> [card] 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

> [!NOTE]
>
> 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

> [accordion] Límites de las tareas
>
> * **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

| Error | Causa | Qué hacer |
| - | - | - |
| El destino ya no es válido | Se eliminó el chat o se desvinculó la aplicación | Edita la tarea y elige un destino nuevo |
| El agente no respondió a tiempo | El agente estaba detenido o sobrecargado | Inicia el agente y vuelve a intentarlo en unos minutos |
| La ejecución alcanzó su límite de uso | La tarea consumió su presupuesto antes de terminar | Revisa tu plan y tu uso en [Planes y facturación](https://docs.kolmena.ai/es/account/plans-and-billing.md) |
| La ejecución anterior aún estaba en curso | El intervalo de la tarea es más corto que su duración | Alarga el intervalo o simplifica la tarea |
| La ejecución perdió su ventana | El programador no pudo iniciar la ejecución en la hora siguiente a la programada | Reanuda la tarea y comprueba si hubo interrupciones del servicio |

## Próximos pasos

> [card] [Crea una tarea](https://docs.kolmena.ai/es/jobs/create-a-job.md)
>
> Sigue paso a paso cómo crear una tarea programada o activada por un evento.

> [card] [Configura tu agente](https://docs.kolmena.ai/es/agents/versions-and-publishing.md)
>
> Aprende cómo funciona la publicación y por qué las tareas se mantienen entre versiones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.