# Conceptos de referencia

[← Índice](readme.md)

Glosario de términos usados en el sistema y en este manual.

---

## Tipo de trabajo

Plantilla reutilizable que define qué agente procesa los elementos, cómo se construye el mensaje para el agente y qué contexto adicional recibe. Se configura una vez y se reutiliza en múltiples ejecuciones.

## Trabajo (job)

Una ejecución concreta de un tipo de trabajo sobre una lista de elementos. Cada vez que se lanza un trabajo se crea un nuevo registro con su propio identificador, estado y log de resultados.

## Elemento

Cada fila o registro de la lista de datos. Es la unidad mínima de procesamiento — el agente recibe un elemento a la vez y decide qué hacer con él.

## Lote

Subconjunto de elementos que procesa un trabajador. Cuando la lista es grande el sistema la divide en varios lotes que se procesan en paralelo para reducir el tiempo total. El administrador no necesita configurar esto — el sistema lo gestiona automáticamente según sus límites operativos.

## Trabajador

Proceso interno que recorre un lote elemento a elemento y llama al agente por cada uno. El administrador no interactúa directamente con los trabajadores.

## Agent ID

Identificador único del Agente IAE configurado en la plataforma. Se obtiene desde la configuración del agente.

## Token del agente (`agent_token`)

Credencial que el sistema usa para autenticarse contra el webservice del agente IAE en cada llamada. Solo lo conoce el backend — nunca se expone a los operadores ni a sistemas externos.

## Token de encolamiento (`token`)

Credencial que protege el endpoint de inicio de trabajos para este tipo de trabajo. Debe conocerlo quien quiera lanzar trabajos programáticamente (webhooks, conectores, sistemas externos). La app operativa lo usa de forma transparente.

## Canal

Identificador lógico libre que el sistema envía al agente en cada llamada. Sirve para agrupar y filtrar las conversaciones generadas en la auditoría de conversaciones de la plataforma IAE. No tiene relación con el canal de mensajería (WhatsApp, webchat, etc.).

## Tema (`chat_topic`)

Valor que el agente usa para activar contexto estático preconfigurado en su prompt. El mismo tema se envía para todos los elementos del lote. Debe coincidir con un tema configurado en el agente para tener efecto.

## Campo de contexto variable (`context_var_field`)

Nombre de un campo del elemento cuyo valor el sistema pasa al agente como identificador de contexto variable. El agente lo usa para consultar información dinámica desde un endpoint externo — por ejemplo, el estado de cuenta de un cliente dado su clave.

## Destino de datos / instrucciones

Define en qué campo del payload del agente va cada contenido:

- **message** — rol `user` en el LLM. Es el turno del usuario en la conversación.
- **context** — rol `system` en el LLM. Son instrucciones al agente que enmarcan su comportamiento.

## Modo `stateless`

El sistema envía cada elemento al agente indicándole que no considere el historial de la conversación al procesarlo. Esto garantiza que el costo por elemento sea constante — el agente solo ve el elemento actual, aunque el historial quede registrado para auditoría.

## Purger

Proceso automático que elimina los datos de ejecuciones antiguas según el periodo de retención configurado. Libera espacio en la base de datos sin intervención manual.

## Auditoría de conversaciones

Herramienta de la plataforma IAE que registra todas las conversaciones del agente. Las conversaciones generadas por el procesador se pueden filtrar por canal y tema para revisar qué respondió el agente a cada elemento.

---

[← Log de ejecuciones](07-log.md) · [Inicio →](readme.md)