Arquiteturas do SWE-Agent e do OpenDevin

SWE-Agent e OpenDevin (agora OpenHands) são agentes de programação de código aberto de referência. Ler o código deles ensina o que os profissionais fazem.

O SWE-Agent introduziu o conceito de "Interface Agente-Computador" (ACI) — uma CLI cuidadosamente projetada para o agente manipular código.

• open / goto / scroll_up / scroll_down — visualizador de arquivos
• edit — edição por intervalo de linhas
• create — novos arquivos
• find_file / search_dir — pesquisa
• submit — concluir a tarefa

O SWE-Agent mostra ao modelo apenas uma "janela" de 100 linhas de um arquivo por vez. Isso força a rolagem explícita, o que, surpreendentemente, ajuda a manter o foco.

Após cada edição, o SWE-Agent executa um analisador estático. Se novos erros aparecerem, a edição será rejeitada e o modelo deverá tentar novamente.

OpenDevin (renomeado como OpenHands) é uma plataforma multiagente desenvolvida em torno de uma área isolada do Docker. Ela oferece suporte a vários mecanismos de agente (CodeAct, BrowsingAgent etc.).

• execute_bash — executar comandos do shell
• str_replace_editor — editor no estilo da Anthropic
• browse — ferramenta de navegador para pesquisa na web
• finish — tarefa concluída

O OpenHands modela explicitamente as etapas do agente como pares Ação -> Observação:

O CodeAct (UIUC) mostrou que permitir que o modelo emita PYTHON CODE para cada chamada de ferramenta (em vez de chamadas de ferramentas JSON fixas) frequentemente apresenta desempenho superior.

Motivo: o código permite composição naturalmente, e o modelo pode usar laços, condições e valores intermediários.

A OpenAI lançou o Codex CLI — sua implementação de referência de código aberto de um agente de programação. Padrão semelhante: editor, shell, pesquisa e conclusão.

1. Área de trabalho isolada no Docker para cada tarefa
2. Conjunto de ferramentas de leitura / edição / execução / pesquisa
3. Verificação a cada edição (análise estática ou teste)
4. Limites de etapas (50 a 100 iterações)
5. Registro de rastreamento de tudo

• Formato de edição: intervalo de linhas versus substituição de texto versus arquivo inteiro
• Visualizador de arquivos: rolagem em janelas versus salto para uma linha
• Memória: bloco de notas versus notas no prompt do sistema
• Frequência de verificação: a cada etapa versus no final

Você pode criar um agente de programação competitivo em 500 a 1.000 linhas de Python combinando:

• As ferramentas da Lição 2
• O ciclo de correção da Lição 3
• Uma etapa de planejamento da Lição 1
• O isolamento do Curso 23
• A avaliação do Curso 21

Tanto o SWE-Agent quanto o OpenHands estão disponíveis publicamente no GitHub. Passe uma tarde lendo seus ciclos principais — é a melhor formação em engenharia de agentes que você pode obter.

Qual é um padrão arquitetural quase universal entre os agentes de programação?

A ACI do SWE-Agent, o ciclo de ação e observação do OpenHands e o código como ação do CodeAct. Leia o código-fonte. Aproveite o que funciona. Crie sua própria versão mais enxuta.