agentfdr

agentfdr

agentfdr, da kamihork, é uma ferramenta de depuração para agentes de IA que revela logs de execução passo a passo após o fato. Identifica loops, desvios de objetivo e desperdício de tokens sem instrumentação, funcionando localmente.

depuração de agentes de IAlogs de execuçãodetecção de desperdício de tokensanálise de desvio de objetivoferramenta de debugging local
Open site
image for agentfdrOpen site

O que é o agentfdr?

O agentfdr é uma ferramenta de depuração para agentes de IA que revela logs de execução turno a turno após o fato. Ele identifica loops, desvio de objetivo e desperdício de tokens sem necessidade de instrumentação, operando localmente. Pense nele como um gravador de voo para sessões de agentes autônomos — capturando cada chamada de ferramenta, composição da janela de contexto e token de saída para que você possa analisar falhas depois que elas ocorrem. Foi projetado para ajudar engenheiros a "projetar um loop que você possa ver", transformando o comportamento invisível do agente em uma linha do tempo inspecionável.

Application scenarios

  • Depuração de loops infinitos

    Capture agentes presos em um ciclo "Editar → teste falha → mesma edição" que roda por 40 minutos.

  • Detecção de desvio de objetivo

    Identifique quando um agente solicitou uma correção de bug, mas refatorou o roteador.

  • Análise de desperdício de tokens

    Identifique quando grandes resultados de ferramentas sobrecarregam a janela de contexto, causando perda de cache e releituras de 200 mil tokens por turno.

  • Investigação de aterrissagens ruins

    Entenda por que um agente diz "Pronto!" com testes falhando ou nunca para.

  • Monitoramento de pipeline de CI

    Coloque um alarme em pipelines autônomos com `agentfdr assert` para bloquear loops ou uso excessivo de tokens.

  • Rastreamento de custos

    Agregue transcrições entre projetos para monitorar o uso por modelo e custos estimados em relação aos planos de assinatura.

  • Relatórios pós-mortem

    Gere relatórios de autópsia em Markdown prontos para colar em rastreadores de issues ou threads do Slack.

Core Features

  • Visualizador de linha do tempo

    Veja a sessão inteira em uma tela — cada turno com chamadas de ferramenta, composição da janela de contexto, tokens de saída, com marcadores de prompt e compactação.

  • Detecção de anomalias

    Sinaliza automaticamente loops de ferramentas, sequências de erros, inchaço de contexto, picos de tokens, thrash de cache, rotatividade de arquivos e recusas — um clique a partir da evidência.

  • Dissecação de turno

    Um painel lateral redimensionável mostrando a divisão de uso, duração de cada chamada de ferramenta, tamanho do resultado e trecho. Navegue pelos turnos com as teclas ←/→.

  • Modo de observação ao vivo

    `agentfdr watch` acompanha uma sessão ainda em execução, mostrando o aumento do contexto em tempo real.

  • Portão de CI

    `agentfdr assert --no-loops --max-tokens 2M` sai com código 1 em caso de violação, atuando como um alarme para pipelines autônomos.

  • Autópsia em Markdown

    `agentfdr blame` renderiza toda a análise como Markdown, pronta para colar em uma issue ou thread do Slack.

  • Rastreamento de uso

    Agrega todas as transcrições de projetos no mesmo formato da medição de assinatura — janela atual de 5 horas, histórico diário, semana contínua — com divisão por modelo e custo estimado.

  • Calibração de orçamento

    Detecta automaticamente seu nível de plano, define orçamentos, calibre uma vez contra a tela de /uso do Claude Code e obtenha barras de aviso antes de atingir os limites.

Usuários-alvo

Engenheiros de software e desenvolvedores de IA que constroem ou mantêm sistemas de agentes autônomos. Especificamente, aqueles que trabalham com loops de agentes, depuração de comportamento imprevisível ou gerenciamento de custos de tokens em pipelines de produção. Também útil para engenheiros de QA que configuram portões de CI em fluxos de trabalho de agentes e líderes de equipe que precisam de relatórios pós-mortem para falhas de agentes.

Como usar o agentfdr?

O agentfdr é uma ferramenta de linha de comando. Os comandos principais incluem:
  • agentfdr – abre a linha do tempo da sessão mais recente
  • agentfdr list – lista todas as sessões gravadas entre projetos
  • agentfdr watch – acompanha ao vivo uma sessão em execução
  • agentfdr blame 35cb18 – gera uma autópsia em Markdown para uma issue específica
  • agentfdr usage – visualiza o consumo do plano (janela de 5 horas, diário, semanal)
  • agentfdr assert --no-loops --max-tokens 2M – portão de CI que sai com código 1 em caso de violação

Não há menção a cadastro ou interface web; ele opera localmente via comandos de terminal.

Análise de resultados

O agentfdr aborda um ponto de dor real: a invisibilidade das falhas de agentes autônomos. O conjunto de recursos é abrangente para uma ferramenta de depuração — cobrindo visualização de linha do tempo, detecção de anomalias, monitoramento ao vivo, integração com CI e rastreamento de custos. A interface de linha de comando sugere que é projetado para desenvolvedores que já trabalham em ambientes de terminal. Embora nenhum feedback de usuário ou métricas de qualidade sejam fornecidos no site, o foco da ferramenta em zero instrumentação e operação local a torna prática para depuração em produção sem adicionar sobrecarga. Para equipes que lutam com engenharia de loops de agentes, esta parece ser uma solução focada e direta.

Frequently Asked Questions

O que é o agentfdr?
O agentfdr é uma ferramenta de depuração para agentes de IA que gera registros detalhados de execução passo a passo após o fato, ajudando a identificar loops, desvios de objetivo e desperdício de tokens sem exigir qualquer instrumentação.
Como o agentfdr funciona?
Ele opera localmente e analisa retroativamente os registros de execução do agente, revelando cada etapa. Isso permite que você veja onde ocorreram loops ou desvios de objetivo sem precisar modificar o código do seu agente.
Preciso instrumentar meu agente para usar o agentfdr?
Não, o agentfdr não requer instrumentação alguma. Ele funciona com registros existentes para fornecer insights de depuração após a execução.
Que problemas o agentfdr pode me ajudar a resolver?
Ele ajuda a identificar loops infinitos, desvios de objetivo (quando o agente se afasta do objetivo pretendido) e desperdício de tokens, tornando seus agentes de IA mais eficientes e confiáveis.
O agentfdr é gratuito?
Sim, o agentfdr é uma ferramenta de código aberto disponível gratuitamente, conforme indicado em seu repositório GitHub sob kamihork.
O agentfdr pode ser usado com qualquer framework de agente de IA?
Sim, como ele trabalha com registros de execução após o fato, é independente de framework e pode ser usado com qualquer agente de IA que produza saída de log.

agentfdr - AI Tool Detail

agentfdr, da kamihork, é uma ferramenta de depuração para agentes de IA que revela logs de execução passo a passo após o fato. Identifica loops, desvios de objetivo e desperdício de tokens sem instrumentação, funcionando localmente.

Category：Agents

Visit Link：https://kamihork.github.io/agentfdr/

Tags：depuração de agentes de IA、logs de execução、detecção de desperdício de tokens、análise de desvio de objetivo、ferramenta de debugging local