Obter AX Code · GrátisDocumentação
AX Code.
pt-BR
English繁體中文简体中文日本語한국어FrançaisDeutschBahasa IndonesiaItalianoPortuguês (Brasil)РусскийEspañolTürkçeTiếng Việt
Começar

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

Evidência de execução

Status: Ativo Escopo: estado atual Última revisão: 2026-08-25 Responsável: runtime do AX Code

Cada sessão do AX Code é gravada enquanto roda. Esta página cobre os comandos que transformam essa gravação em algo que você pode revisar, comparar, exportar e desfazer.

Use-a quando um agente tiver terminado e você precisar responder: o que ele fez, qual era o risco, como se comparou com outra tentativa e como voltar?

O que é gravado

Durante uma execução, o AX Code grava duas coisas independentes:

  • Um log de eventos tipado — decisões de roteamento, atividade do modelo, limites de passo, chamadas de ferramenta e resultados de ferramenta. Esta é a fonte de graph, replay, compare, trace e audit.
  • Instantâneos de arquivo — capturados em um armazenamento de objetos Git que vive fora do seu repositório, no diretório de dados do AX Code, usando refs/snapshots/<hash>. A árvore de trabalho e o .git/ do projeto não são modificados para armazená-los.

Os dois são locais. Nada é enviado para fora.

Reconstruir uma execução

ax-code graph <sessionID>

Reconstrói a sessão como um grafo de execução: duração, resumo de risco, contagens de tokens, agentes usados e cada passo com as chamadas de ferramenta e os tempos.

## Session ses_01H8XK

Duration: 9m 54s | Risk: HIGH (53/100) | Tokens: 167,650 in / 18,494 out
Agents: architect

### Step 1 (8s) | tokens: 12263/587

- read: api.ts → ok (5ms)
- grep: rateLimit → ok (12ms)

--format seleciona saídas alternativas, inclusive Mermaid e uma vista de topologia, quando você quer o grafo em outra ferramenta.

Observe que este é o grafo de execução da sessão — o que o agente fez. Não é o grafo de código do repositório; esse é ax-code index e a camada de inteligência de código.

Comparar duas execuções

ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep

Relata o delta de risco, os arquivos alterados, as contagens de falha de ferramenta, o caminho de decisão de cada execução e as contagens por tipo de evento. --deep acrescenta análise de divergência no nível do passo por comparação de replay.

Isto compara execuções, não código-fonte. Responde “a segunda tentativa pontuou pior — onde divergiu”, e não “mostre o diff de código”.

Um uso típico é decidir entre duas estratégias para a mesma tarefa:

  Risk Comparison
  ----------------------------------------
  Score: 53 → 93 (+40) ↑
  Level: HIGH → CRITICAL
  Files: 8 → 25
  Failures: 0 → 15

Inspecionar o log de eventos gravado

ax-code session replay <sessionID> --mode summary
ax-code session replay <sessionID> --mode verify
ax-code session replay <sessionID> --mode reconstruct
ax-code session replay <sessionID> --mode export

verify confere a consistência do log gravado. reconstruct reconstrói o fluxo de passos a partir dos eventos. export grava um pacote de replay portátil.

O replay reconstrói; ele não reexecuta. Não roda de novo os modelos, não invoca de novo as ferramentas nem reproduz estado externo. O modo execute prepara um fluxo reconstruído para comparação programática com o original e destina-se a testes, não a reexecutar o trabalho.

Ler os sinais de risco

ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json

A pontuação é uma heurística determinística derivada de sinais gravados, inclusive quantos arquivos mudaram, se a mudança atravessa várias áreas de nível superior, quantas chamadas de ferramenta falharam, se a validação rodou, se existe um instantâneo de diff, quanta superfície de API é afetada, como a execução terminou (um gate de conclusão bloqueado ou um término por limite de passos ou por estagnação, ambos acrescentam peso) e se caminhos sensíveis à segurança foram tocados. Cada fator que contribui aparece com o peso, junto com mitigações sugeridas.

É um auxílio de revisão. Não é uma probabilidade, uma confiança calibrada nem uma afirmação de que o código é seguro. Uma pontuação LOW em uma mudança não verificada ainda significa que a mudança não está verificada.

Desfazer com precisão

Instantâneos de arquivo funcionam em repositórios Git e em diretórios comuns de projeto quando o Git está instalado e snapshot está ativado. O AX Code mantém o armazenamento Git de instantâneos fora do projeto; ele não cria um diretório de projeto .git. Regras de ignorar e exclusões de caminho sem suporte continuam valendo.

O Revert da TUI desfaz mensagens e mudanças de arquivo capturadas. Com snapshot: false, ou para turnos antigos que nunca capturaram uma linha de base, só é possível desfazer mensagens; as edições de arquivo permanecem no disco. Ativar instantâneos agora não reconstrói o conteúdo anterior dos arquivos. Um turno capturado sem mudanças de arquivo também não tem o que restaurar.

ax-code session rollback <sessionID> --list      # show recoverable points
ax-code session rollback <sessionID> --dry-run   # show what would change
ax-code session rollback <sessionID> --step 4    # restore one step
ax-code session rollback <sessionID>             # restore the whole session

--list combina eventos duráveis de passo com o detalhe do grafo de execução, para que você possa mirar um passo específico em vez de reverter a execução inteira. --dry-run usa o mesmo planejador de reversão que apply e lista as sessões delegadas cujo registro de arquivos contribui para o resultado.

A reversão segue sessões filhas aninhadas quando elas escreveram no diretório de trabalho exato do pai. Ela restaura as mudanças de arquivo posteriores ao limite e mantém as transcrições. Descendentes em execução em outro worktree ou diretório ficam de fora, e a reversão falha fechada se alguma sessão incluída ainda estiver em execução.

Limites que vale conhecer antes de confiar nela: a reversão restaura a partir de instantâneos tirados durante a execução. Um arquivo que nunca teve instantâneo — porque mudou fora da sessão, ou não estava em estado recuperável — não pode ser restaurado deste modo. Use --dry-run primeiro em qualquer coisa de consequência.

Experimentar outra estratégia

ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>

Bifurca o estado armazenado da sessão, para que uma segunda tentativa comece de um ponto escolhido em vez de do zero.

Isto bifurca o estado da sessão — mensagens e metas. Não é um ramo Git nem um worktree. Para candidatos Git isolados, veja Mudanças verificadas de vários modelos.

Diagnosticar

ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs

Diagnóstico apoiado em replay, com uma linha do tempo pontuada por risco. --logs muda para a análise legada de arquivo de log, em vez de eventos de replay, o que é útil quando você investiga um problema operacional em vez de revisar uma mudança.

Exportar a evidência

ax-code audit export --all --since 2026-08-01     # JSON Lines
ax-code audit export --all --risk HIGH            # filter by minimum risk
ax-code audit report <sessionID>                  # Markdown report
ax-code audit otlp <sessionID>                    # OpenTelemetry spans
ax-code audit prune --days 90                     # delete old events

JSONL e OTLP tornam o registro da execução consumível pelo seu próprio pipeline de revisão ou de observabilidade. O relatório Markdown destina-se a pessoas que anexam evidência a um PR ou a um registro de mudança.

Navegar

ax-code run-report                 # latest session
ax-code run-report --index         # session index

Abre o relatório local da execução em um navegador, com o resumo da execução, a linha do tempo, as mudanças, o estado de validação, o detalhe de risco, a informação de ramo e os pontos de reversão. O servidor se vincula apenas a loopback.