Correção de Falhas em Execuções de QA de Agente

Visão Geral

Corrigir uma execução falha de QA de Agente a partir de evidências registradas e do código-fonte local relevante. Trate o classificador como uma hipótese, faça a menor alteração justificada e verifique o comportamento mais restrito afetado, sem reescrever um teste apenas para ocultar um defeito real.

Quando Usar

• Uma execução falha de QA de Agente já foi triada e agora requer uma correção de código ou YAML.
• Artefatos e logs apontam para um defeito em um teste, hook, produto, runtime ou comportamento do agente.
• Uma correção proposta deve ser verificada com a execução mais restrita de QA de Agente ou teste unitário.
• O usuário solicita auto-correção ou atualização de uma definição de QA de Agente desatualizada com base em evidências.

Pré-requisitos e Limites de Aprovação

• Confirme o repositório, o ambiente de trabalho, o ambiente de destino e os arquivos que o usuário autoriza você a modificar.
• Inspecione os efeitos colaterais externos do teste planejado antes de executá-lo novamente; obtenha confirmação explícita para ações voltadas para produção, destrutivas ou irreversíveis.
• Preserve alterações não relacionadas do usuário e mantenha o patch limitado à falha evidenciada.
• Não exponha credenciais ou dados sensíveis da aplicação a partir de artefatos e logs.

Fluxo de Trabalho

1. Comece com a coleta de evidências:
   • agent_qa_get_run
   • agent_qa_get_run_steps
   • agent_qa_get_run_artifact
   • agent_qa_get_run_logs
   • agent_qa_get_run_execution_logs
2. Chame agent_qa_classify_failure e trate sua categoria como uma hipótese, não como um veredito.
3. Identifique a superfície de falha: definição de teste, hook, aplicação sob teste, infraestrutura de runtime ou comportamento do agente.
4. Inspecione os arquivos locais relevantes diretamente. Não infira patches apenas a partir de artefatos.
5. Explique o vínculo entre a evidência e a alteração, em seguida, aplique a menor alteração de código ou YAML que justifique a evidência.
6. Valide qualquer definição de QA de Agente alterada antes da execução.
7. Reexecute o teste de QA de Agente, suíte, hook ou teste unitário mais restrito afetado dentro do ambiente aprovado.
8. Relate a causa raiz, os arquivos alterados, o comando de verificação ou a ação do MCP, o resultado e o risco restante.

Regras de Correção

• Não invente seletores, estados de tela, capturas de tela, logs ou arquivos de origem.
• Não reescreva um teste apenas para fazê-lo passar quando o artefato mostrar um defeito de produto ou runtime.
• Preserve os IDs canônicos de QA de Agente ao editar testes, suítes, hooks ou arquivos de memória.
• Prefira agent_qa_validate_test, agent_qa_validate_suite e agent_qa_validate_definition antes de executar novamente o YAML editado.
• Quando o MCP não estiver disponível, use as APIs REST do painel ou artefatos e estado locais de .agent-qa e declare que as evidências do MCP não estavam disponíveis.
• Pare e relate o bloqueio quando as evidências não puderem distinguir entre correções materialmente diferentes.

Exemplo

User: Fix the failed staging checkout run, but do not touch production.

Expected handling: collect the failed run evidence, classify it, inspect the implicated local
definition and application code, patch only the evidenced cause, validate, rerun the single
staging test, and report changed files plus remaining uncertainty.

Limitações

• Requer acesso às evidências de execução relevantes e ao código-fonte local; artefatos sozinhos podem não estabelecer a causa raiz.
• Não pode garantir que uma falha intermitente de navegador, dispositivo, rede ou provedor seja corrigida após uma única execução bem-sucedida.
• Não autoriza alterações de produção, mutação de dados, instalação de dependências ou refatoração mais ampla além do escopo aprovado pelo usuário.
• Uma execução restrita que passa não substitui a suíte de testes normal do repositório ou a revisão humana.