Eventos de Agente, Explicados: O Contrato de Execução por Trás de Agentes de IA Confiáveis

A resposta final de um agente diz a você o que o usuário viu. Seus eventos dizem à sua aplicação o que aconteceu, o que ainda está acontecendo, o que precisa de um humano e como recuperar quando a conexão cai.

1. Por que uma API de resposta final é insuficiente para agentes

Uma chamada de modelo convencional tem um formato tranquilizador: envie a entrada, receba a saída. Mesmo quando a resposta é transmitida via stream, a aplicação geralmente está reconstruindo uma única resposta. A execução de agentes é diferente. Uma execução pode fazer várias chamadas de modelo, solicitar ferramentas, aguardar aprovação, autenticar em um servidor MCP, criar um sandbox, delegar para subagentes e retomar em uma solicitação posterior.

Se o runtime expõe apenas a última resposta de texto, a aplicação perde a estrutura necessária para operar esse fluxo de trabalho. Ela não consegue responder de forma confiável a perguntas básicas:

• O agente está pensando, invocando uma ferramenta, aguardando um humano ou terminou?
• Qual mensagem do modelo propôs esta chamada de ferramenta?
• Quais eventos pertencem a um subagente em vez do agente raiz?
• Quais fragmentos já foram renderizados?
• Após uma desconexão, o cliente deve reconectar à execução ativa ou reconstruir a partir do estado persistido?

É por isso que os eventos são importantes. Eles são a interface entre a execução oculta e tudo o que precisa responder a ela: a interface do usuário, o serviço de aprovação, o console de operações, o depurador e o avaliador.

2. O que "evento" significa no TrueForge

O TrueForge organiza a execução como Agente → Sessão → Turno → Evento → Delta. Cada nível responde a uma pergunta diferente:

O agente é uma definição, não um processo em execução contínua. Uma sessão mantém o contexto entre turnos. Um turno representa um ciclo de solicitação, e apenas um turno é executado por vez dentro de uma sessão. Eventos são os registros tipados produzidos dentro desse turno. Alguns eventos — mais visivelmente as mensagens do modelo — podem ser montados incrementalmente por meio de deltas.

Essa hierarquia evita dois erros comuns de design. Primeiro, o histórico da sessão não deve ser tratado como uma transcrição ilimitada: os turnos fornecem limites naturais de execução. Segundo, um delta transmitido via stream não deve ser armazenado ou avaliado como se fosse o evento semântico final.

3. A taxonomia de eventos é a máquina de estados do runtime

A união de eventos documentada da TrueForge abrange diversas categorias. O ponto principal não é a quantidade de tipos de eventos, mas sim o fato de que cada categoria implica um comportamento de aplicação diferente.

‍

‍