iFixAi audita agentes de IA em 120 segundos e dá nota A–F
Projeto Python mede se um agente cumpre sua função, não apenas se responde rápido.
Projeto Python mede se um agente cumpre sua função, não apenas se responde rápido.
Quem mantém um agente de IA precisa descobrir se ele cumpre o trabalho esperado. O iFixAi faz essa auditoria em menos de 120 segundos e entrega uma nota de A a F. A ferramenta, criada pelo repositório ifixai-ai/iFixAi em 2026-04-27, executa 32 inspeções em cinco pilares. Serve para equipes que precisam testar agentes contra objetivos de negócio, riscos e pontos cegos.
O iFixAi roda como uma ferramenta de linha de comando escrita em Python. O fluxo guiado escolhe o sistema, o juiz e a suíte; verifica a conexão; salva a configuração; executa as inspeções; e grava os resultados em ./ifixai-results/. O usuário recebe relatórios em JSON e Markdown, além de um placar no terminal.
A execução acontece na máquina do usuário, mas os modelos testados e os juízes dependem de provedores configurados. O README permite testar qualquer provedor ou o endpoint real do agente, usando chaves detectadas no ambiente. A ferramenta guarda em ifixai.yaml apenas o nome da variável de ambiente, nunca o segredo.
O projeto também oferece dois caminhos além do assistente guiado. Flags explícitas permitem rodar lotes em CI e automatizar auditorias; plugins e skills deixam o próprio agente descobrir a configuração, montar a fixture, executar os testes e explicar o placar. O pacote instala extras para provedores como OpenAI, Anthropic e Gemini.
A versão v3.2.2 adicionou o provedor atlascloud, compatível com a API da OpenAI. O código também passou a remover credenciais, conectou o provedor ao juiz e ao agregador e incluiu documentação específica. A versão envia o prompt de sistema configurado em probes de turno único B26, B30, B31 e B32, junto com um nonce da execução.
O usuário instala o pacote com pip install "ifixai[openai]", troca o extra conforme o provedor e executa ifixai setup. O assistente detecta chaves disponíveis, pede provedor, modelo, juiz e suíte e grava o arquivo de configuração. Depois, ifixai run inicia a auditoria sem exigir novas flags.
Sem chave, o programa informa qual variável de ambiente deve ser exportada. Se ela continuar ausente, o assistente pede a credencial antes da primeira chamada de API. No Windows, quem não encontrar ifixai no PowerShell precisa ajustar o caminho da pasta Scripts do Python ou usar python -m ifixai.
A versão também aplica no YAML os campos on_topic_examples, b06_probes e case_id_prefixes, que antes eram ignorados. Isso muda quais exemplos, probes e prefixos entram na execução. O resultado combina uma nota geral com um placar dos pilares avaliados.
O projeto tinha 5.234 estrelas, 677 forks e 2 issues abertas. A idade registrada era de 99 dias, com último commit em 2026-08-04 e versão mais recente publicada em 2026-07-26. O interesse no GitHub cresceu rápido, mas esse histórico curto ainda não mostra manutenção prolongada.
A licença Apache-2.0 permite usar, modificar e redistribuir o código, inclusive em produtos comerciais, desde que os termos e avisos da licença sejam preservados. A ferramenta não serve para quem exige uma auditoria totalmente offline, porque os testes dependem de um provedor ou endpoint configurado. Também não substitui métricas de latência, custo ou eficiência de tokens: seu foco é verificar se o agente faz o trabalho esperado.