Bases de Datos
Tareas de Agentes
Asigna agentes de IA a registros de tu base de datos para ejecutar instrucciones en cada fila — al instante, programadas o cuando cambia un estado
Una tarea de agente es como pegar una nota adhesiva en una carpeta para un compañero: "resume esto", "puntúa esto", "redacta una respuesta". Eliges un agente, escribes qué debe hacer con el registro y eliges cuándo se ejecuta. El agente lee la fila, sigue tu instrucción y escribe los resultados de vuelta: actualiza el estado, completa campos, escribe en el cuerpo de la página o actualiza otro registro para activar al siguiente agente de la cadena.
Úsalas para el trabajo repetitivo que normalmente harías fila por fila: resumir leads entrantes, calificar negocios, redactar respuestas, puntuar postulaciones o dar seguimiento a conversaciones estancadas.
Image: Sección de tarea de agente en el panel del registro con el historial de ejecución
Antes de empezar
- Un agente guardado. Cualquier agente sirve: no existe un agente especial "de tareas". Créalo con Nuevo agente en el centro de Agentes.
- El agente conectado a esta base de datos, en la sección Bases de datos del agente, con un nivel de permiso: Lectura (solo mirar), Escritura (actualizar campos y el cuerpo de la página, lo que necesitan la mayoría de las tareas) o Totales (escritura más eliminar registros).
- Las Tareas de Agentes activadas para la tabla (abajo).
Con las tres listas, el agente aparece en el selector de cada registro de esa base de datos.
Activar o desactivar las Tareas de Agentes
- Abre la página de Crear Base de Datos o Editar Base de Datos de la tabla (o Configuración → Tareas de Agentes).
- Busca la tarjeta de Tareas de Agentes en la sección de Campos especiales y haz clic en Activar.
Esto agrega los campos ocultos Agente, Tarea, Ejecutar, Estado y Sesión a cada fila. En las vistas solo se muestra el agente, como un pequeño avatar con un punto de estado de color (azul parpadeante mientras se ejecuta, verde al terminar, rojo si falla) en Lista, Cuadrícula, Kanban y Calendario. El resto vive en el panel del registro. También puedes ajustar dos límites de la tabla:
| Ajuste | Por defecto | Qué hace |
|---|---|---|
| Máximo de tareas concurrentes | 3 | Cuántos registros pueden tener un agente trabajando al mismo tiempo. Las tareas de más esperan su turno. |
| Máximo de minutos de ejecución | 15 | Pasado este tiempo, una tarea en ejecución se marca como timeout. |
Para desactivarlas, haz clic en Desactivar en la misma tarjeta. Tras una confirmación, se cancelan las tareas pendientes o en cola y se eliminan los campos y ajustes de Tarea de Agente. Tus registros y sus demás datos quedan intactos.
Asignar una tarea a un registro
- Haz clic en el registro para abrir su panel de detalle y baja hasta la tarjeta de Tarea de Agente.
- Agente: elige uno de los agentes conectados a esta base de datos.
- Tarea: escribe la instrucción en lenguaje sencillo.
- Ejecutar: elige cuándo se ejecuta (abajo). Ejecutar ahora arranca de inmediato.
Image: Tarjeta de Tarea de Agente de un registro con un agente elegido, una instrucción escrita y Ejecutar configurado para correr ahora
Agente y Tarea se guardan solos; elegir una opción de Ejecutar es lo que inicia o programa la ejecución. El agente recibe todos los campos del registro más tu instrucción, y puede usar cualquier herramienta de base de datos a la que tenga acceso.
Una buena instrucción dice qué leer, qué hacer y dónde escribir el resultado, usando los nombres de las columnas:
Lee el nombre del lead, la empresa y la columna de notas. Escribe un correo de contacto amable en el cuerpo de la página y cambia el Estado a "Listo para enviar" cuando termines.
Mira la industria del contacto y su rango de ingresos. Puntúa del 1 al 5 en el campo Puntaje del Lead. Si el puntaje es ≥ 4, cambia el Estado a "Lead caliente".
Ejecuta una instrucción nueva una vez con Ejecutar ahora, revisa el registro de ejecución y ajústala hasta que te guste el resultado. Luego aplícala al resto.
Elegir cuándo se ejecuta
Image: El menú Ejecutar abierto, mostrando Ejecutar ahora, las opciones de programación y los detonantes por evento
| Opción | Cuándo se ejecuta el agente |
|---|---|
| Ejecutar ahora | De inmediato. El estado pasa por queued → running → completed (o failed). |
| En 1 / 3 / 6 / 12 horas | Una vez, dentro de esa cantidad de horas. El estado se queda en pending hasta entonces. |
| Elegir fecha y hora | Una vez, en la fecha y hora que elijas. |
| Por evento | Cuando una columna de Estado o Selección de este registro cambia al valor que elijas (por ejemplo, Estado → "Calificado"). Se queda en pending hasta entonces. |
Los detonantes por evento son la forma más limpia de construir embudos: una persona u otro agente puede mover el estado, y el siguiente agente continúa por su cuenta.
Seguir una tarea
| Estado | Qué significa |
|---|---|
pending | Esperando su hora programada o su evento |
queued | Por iniciar, esperando un cupo libre |
running | El agente está trabajando en este registro |
completed | Terminó con éxito |
failed / timeout | Encontró un error o superó el tiempo máximo de la tabla: usa Reintentar para una ejecución nueva |
cancelled | La cancelaste (posible mientras está pending o queued) |
Haz clic en Ver ejecución en una tarea terminada para abrir su registro: el contexto del registro que recibió el agente, su razonamiento paso a paso y las herramientas que usó. Úsalo para depurar y afinar tu instrucción. Para ver todas las tareas de un agente en todas las tablas, abre el agente en el centro de Agentes y ve a su pestaña Tareas del agente.
Image: Cuadro de diálogo del registro de ejecución del agente mostrando el contexto de la tarea y el razonamiento del agente
Encadenar agentes
Los agentes pueden actualizar otros registros. Combinado con los detonantes por evento, esto construye cadenas sin una automatización:
Un agente no puede volver a activarse a sí mismo: Nirvai bloquea nuevas tareas en filas que ya están en pending, queued o running. Las cadenas entre registros distintos sí están permitidas.
Créditos
Cada ejecución consume créditos igual que una conversación con ese agente, y se cobra al agente asignado. Un resumen rápido cuesta poco; los campos largos, las búsquedas web o el razonamiento de varios pasos cuestan más. Las tareas programadas y por evento solo gastan créditos cuando realmente se ejecutan: una tarea que nunca cumple su detonante no cuesta nada.
Solución de problemas
| Problema | Causa probable y solución |
|---|---|
| El agente que quiero no aparece en el selector | No está conectado a esta base de datos. Abre el agente con Editar, agrega la tabla en su sección Bases de datos y dale al menos permiso de lectura. |
| La tarea se ejecutó pero nada cambió | El agente solo tiene permiso de lectura. Súbelo a escritura o totales. |
El estado se queda en pending | Es lo esperado en tareas programadas y por evento: una tarea por evento corre solo cuando la columna detonante llega al valor exacto que configuraste. |
La tarea se queda en queued | La tabla está en su límite de tareas concurrentes. Espera, o sube el límite. |
| Una cadena no inició el siguiente agente | El primer agente necesita permiso de escritura o totales sobre el otro registro, y la columna y el valor detonante deben coincidir exactamente. |
La tarea terminó en timeout | Superó el máximo de minutos de ejecución. Simplifica la instrucción, o sube el límite para tareas pesadas. |
Qué sigue
- Referencia Técnica: cómo se comportan por dentro los registros, las vistas, los conectores y las tareas de agentes.
- Automatizaciones: para trabajo de varios pasos, con lógica de ramificación o detonantes externos.