Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Recapitulação da conversa

Status: Atual Escopo: recapitulações de conversa da TUI do AX Code Última revisão: 2026-09-26 Responsável: mantenedores do runtime do AX Code

Use /recap em uma sessão ociosa da TUI para se atualizar sobre a conversa recente, inclusive depois de retomar uma sessão salva. O AX Code resume até oito turnos recentes do usuário em uma faixa curta: o objetivo, o progresso confirmado, a verificação e o próximo passo ou o bloqueio. A faixa permanece enquanto você digita e some quando você inicia outro turno, muda de sessão ou a conversa muda. /recap espera a árvore inteira da sessão: enquanto o modo de objetivo ou subagentes de tarefa ainda estão em execução, ele pede que você espere, em vez de resumir trabalho incompleto.

A recapitulação usa um modelo e pode estar incompleta ou inexata. Ela privilegia o pedido mais recente e os resultados quando a conversa ultrapassa o orçamento de entrada. Confira a transcrição para os resultados exatos. Recapitulações não modificam a transcrição, não executam ferramentas e não mudam o status da tarefa.

O AX Code também gera uma recapitulação automaticamente quando a árvore inteira da sessão se estabilizou — o turno está completo e nenhum subagente ainda está em execução — e o prompt ficou em silêncio por cinco segundos. Digitar pausa a contagem; limpar o prompt a reinicia. A geração começa pouco antes da marca de atraso (pregenerate, padrão true), para que a faixa possa aparecer na marca, e não uma latência de modelo depois dela. Uma recapitulação pré-gerada é descartada em silêncio se você digitar antes da marca. Sessões que usaram subagentes recebem uma recapitulação no escopo da conversa; sessões simples recebem uma recapitulação do turno mais recente. Configure a exibição automática em tui.json:

{
  "idle_recap": {
    "enabled": true,
    "delay_ms": 5000,
    "pregenerate": true
  }
}

Defina enabled como false para desativar as recapitulações automáticas. /recap continua disponível. Defina pregenerate como false para gerar somente depois do atraso completo, o que evita uma chamada de modelo quando você volta a digitar dentro da janela. A geração usa o modelo configurado do agente de recapitulação, quando existe, depois o modelo pequeno do provedor e, por fim, o modelo da sessão. As recapitulações fazem uma requisição separada ao modelo e podem consumir a cota do provedor. Turnos com falha ou inacabados, e sessões administradas do AX Engine, não geram recapitulações. Pedidos manuais mostram um aviso quando não há recapitulação disponível; falhas automáticas ficam em silêncio e têm uma nova tentativa depois de trinta segundos, cancelada assim que você digita ou segue adiante. Use /recap para tentar de novo de forma explícita.

Cada sessão guarda a última recapitulação, então o seletor de sessão mostra uma prévia curta do que a sessão fez por último, antes de você retomá-la. A prévia armazenada é apenas uma dica de exibição: nunca é enviada ao modelo, nunca se torna uma mensagem da transcrição e é apagada quando você reverte a sessão.

/compact resume o histórico mais antigo para o modelo, a fim de liberar contexto. /summarize continua sendo o alias dele. Use /recap para uma faixa de atualização e /compact quando precisar comprimir o contexto.