Estado, sessão e checkpoint

Estado é tudo o que o agente sabe sobre a tarefa em andamento: o histórico, os resultados das ferramentas, as variáveis intermediárias. Sessão é a unidade de interação que carrega esse estado, do início ao fim de uma tarefa ou conversa. Checkpoint é uma cópia do estado salva em um ponto seguro, que permite retomar a execução após uma falha, auditar o que aconteceu e reverter se necessário. Sem checkpoint, uma falha no passo 7 obriga a refazer os passos 1 a 6, com todo o custo e tempo envolvidos.

Em Produto, para agentes com passos caros ou irreversíveis, vale exigir checkpoints antes de cada ação com efeito externo. É o que permite recuperar de falhas sem repetir trabalho e sem executar ações duas vezes. Checkpoints também são o mecanismo por trás dos pontos de aprovação: o agente salva o estado, pede a aprovação humana e, quando ela chega, retoma exatamente do ponto em que parou. Um cuidado: o estado pode conter dados pessoais. É preciso definir por quanto tempo ele é guardado e quando é apagado.

Use estado em memória para sessões curtas, que cabem em uma conversa. Use estado persistido com checkpoints para tarefas longas, caras ou que envolvem aprovação humana. Use memória de longo prazo quando informações precisam sobreviver entre sessões diferentes. Uma forma simples de diferenciar: estado é o que o agente sabe agora; checkpoint é uma foto desse estado; memória é o que ele lembra depois.

Conceitos de sistemas distribuídos e bancos de dados; aplicados a agentes por frameworks como LangGraph (2024).

LangGraph documentation, Persistence and checkpointing