Eventos de agente, explicados: el contrato de ejecución detrás de agentes de IA fiables

La respuesta final de un agente le indica lo que vio el usuario. Sus eventos le dicen a su aplicación qué sucedió, qué está sucediendo, qué requiere intervención humana y cómo recuperarse cuando se interrumpe la conexión.

1. Por qué una API de respuesta final es insuficiente para los agentes

Una llamada a un modelo convencional tiene una forma tranquilizadora: enviar entrada, recibir salida. Incluso cuando la respuesta se transmite en streaming, la aplicación suele reconstruir una única respuesta. La ejecución de agentes es diferente. Una ejecución puede realizar varias llamadas a modelos, solicitar herramientas, esperar aprobación, autenticarse en un servidor MCP, crear un entorno aislado (sandbox), delegar en subagentes y reanudarse en una solicitud posterior.

Si el tiempo de ejecución solo expone la última respuesta de texto, la aplicación pierde la estructura necesaria para gestionar ese flujo de trabajo. No puede responder de forma fiable a preguntas básicas:

• ¿El agente está pensando, invocando una herramienta, esperando a un humano o ha terminado?
• ¿Qué mensaje del modelo propuso esta llamada a la herramienta?
• ¿Qué eventos pertenecen a un subagente en lugar de al agente raíz?
• ¿Qué fragmentos ya se han renderizado?
• Tras una desconexión, ¿debe el cliente reconectarse a la ejecución en vivo o reconstruirse a partir del estado persistido?

Por esto son importantes los eventos. Son la interfaz entre la ejecución oculta y todo lo que debe responder a ella: la interfaz de usuario, el servicio de aprobación, la consola de operaciones, el depurador y el evaluador.

2. Qué significa "evento" en TrueForge

TrueForge organiza la ejecución como Agente → Sesión → Turno → Evento → Delta. Cada nivel responde a una pregunta diferente:

El agente es una definición, no un proceso que se ejecuta continuamente. Una sesión mantiene el contexto entre turnos. Un turno representa un ciclo de solicitud, y solo un turno se ejecuta a la vez dentro de una sesión. Los eventos son los registros tipados producidos dentro de ese turno. Algunos eventos —los más visibles son los mensajes del modelo— pueden ensamblarse de forma incremental mediante deltas.

Esta jerarquía evita dos errores de diseño comunes. En primer lugar, el historial de la sesión no debe tratarse como una transcripción ilimitada: los turnos proporcionan límites de ejecución naturales. En segundo lugar, un delta transmitido en streaming no debe almacenarse ni evaluarse como si fuera el evento semántico final.

3. La taxonomía de eventos es la máquina de estados del tiempo de ejecución

La unión de eventos documentada de TrueForge abarca varias categorías. La cuestión no es el número de tipos de eventos, sino que cada categoría implica un comportamiento de aplicación diferente.

‍

‍