🧩 Entender a estrategia: modelo certo para cada papel
Nem todo agente precisa do modelo mais caro. A estrategia inteligente e usar modelos potentes para tarefas criticas (orquestracao, planejamento) e modelos leves ou gratuitos para suporte (pesquisa, exploracao). A diferenca de custo pode ser 10x mantendo qualidade similar no resultado final.
💡 Tabela de estrategia recomendada
| Agente | Funcao | Modelo Recomendado | Custo |
|---|---|---|---|
| Sisyphus | Orquestrador | anthropic/claude-opus-4-6 | Pago |
| Prometheus | Planejador | anthropic/claude-sonnet-4-5 | Pago |
| Hephaestus | Executor | openai/gpt-5.3-codex | Pago |
| Oracle | Debug | opencode/big-pickle | Gratuito |
| Librarian | Pesquisa | opencode/gpt-5-nano | Gratuito |
| Explore | Explorador | opencode/gpt-5-nano | Gratuito |
📊 Por que heterogeneidade importa
- Anti-blindspot: Modelos de provedores diferentes encontram bugs que um unico provedor nao veria
- Custo otimizado: Agentes de suporte consomem tokens sem custo, economizando o orcamento para tarefas criticas
- Resiliencia: Se um provedor cair, apenas parte do swarm e afetada
📄 Passo 1: criar o arquivo de configuracao
O arquivo de configuracao e onde voce define qual modelo cada agente usa. Ele fica na raiz do seu projeto (ou na configuracao global) e usa o formato JSONC (JSON com comentarios).
💡 Criando o arquivo
# Criar a pasta de configuracao (se nao existir)
mkdir -p .opencode
# Criar o arquivo de configuracao
touch .opencode/oh-my-opencode.jsonc
# Agora abra este arquivo no seu editor favorito:
# VS Code: code .opencode/oh-my-opencode.jsonc
# Nano: nano .opencode/oh-my-opencode.jsonc
# Vim: vim .opencode/oh-my-opencode.jsonc✍️ Passo 2: definir os modelos
Agora vem a parte pratica: escrever o JSON com o mapeamento agente → modelo. Use os nomes exatos que voce anotou no Modulo 4.1.
💡 Configuracao completa (copie e cole)
{
// Configuracao de modelos por agente
// Use os nomes exatos do "opencode models"
"sisyphus": { "model": "anthropic/claude-opus-4-6" },
"hephaestus": { "model": "openai/gpt-5.3-codex" },
"prometheus": { "model": "anthropic/claude-sonnet-4-5" },
"oracle": { "model": "opencode/big-pickle" },
"librarian": { "model": "opencode/gpt-5-nano" },
"explore": { "model": "opencode/gpt-5-nano" }
}📊 Formato do arquivo
- JSONC: JSON com suporte a comentarios (linhas com //). Util para documentar suas escolhas
- Chaves: Nomes dos agentes em minusculo (sisyphus, hephaestus, prometheus...)
- Valores: Objeto com chave "model" e valor no formato "provedor/nome-do-modelo"
- Salve o arquivo e o OpenCode detecta a mudanca automaticamente
🔀 Passo 3: trocar modelos em tempo real
Uma das vantagens mais poderosas do oh-my-openagent e o hot-swap de modelos. Se durante uma execucao os creditos de um provedor acabarem, voce simplesmente edita o arquivo JSONC, salva, e o agente continua com o novo modelo — sem perder progresso, sem reiniciar.
💡 Como fazer hot-swap
# Cenario: creditos de Claude acabaram no meio da execucao
# 1. Abrir o arquivo de configuracao (em outro terminal)
nano .opencode/oh-my-opencode.jsonc
# 2. Trocar o modelo do Sisyphus:
# DE: "sisyphus": { "model": "anthropic/claude-opus-4-6" }
# PARA: "sisyphus": { "model": "openai/gpt-5.3-codex" }
# 3. Salvar o arquivo (Ctrl+O, Enter, Ctrl+X no nano)
# 4. O OpenCode detecta a mudanca automaticamente
# O Sisyphus continua trabalhando com o novo modelo!
# Nenhum progresso e perdido.📊 Caso real da aula
Na aula ao vivo, isso aconteceu de verdade: os creditos de Claude acabaram no meio de um projeto. Trocamos o modelo do Sisyphus para GPT em 10 segundos e a execucao continuou normalmente. O resultado final manteve a qualidade porque o plano ja estava feito.
💰 Passo 4: estrategia para quem so tem gratuitos
Se voce nao tem assinaturas pagas, nao se preocupe — o swarm funciona com modelos gratuitos. A qualidade sera menor (especialmente em tarefas complexas), mas voce consegue completar todo o curso e ter uma experiencia real com swarms.
💡 Configuracao 100% gratuita
{
// Estrategia 100% gratuita
// Funciona, mas qualidade significativamente menor
"sisyphus": { "model": "opencode/big-pickle" },
"hephaestus": { "model": "opencode/big-pickle" },
"prometheus": { "model": "opencode/big-pickle" },
"oracle": { "model": "opencode/gpt-5-nano" },
"librarian": { "model": "opencode/gpt-5-nano" },
"explore": { "model": "opencode/gpt-5-nano" }
}⚠️ Limitacoes dos modelos gratuitos
- •Tarefas complexas podem ter resultados incompletos ou com erros
- •O modo Prometheus pode fazer perguntas menos profundas na entrevista
- •A autocorrecao pode nao funcionar tao bem quanto com modelos pagos
- •Para projetos serios, investir em pelo menos uma assinatura Claude faz muita diferenca
✅ Checkpoint: configuracao validada
Hora de validar que tudo esta configurado corretamente. Abra o OpenCode e confirme que cada agente esta usando o modelo que voce definiu.
💡 Validando a configuracao
# 1. Abrir o OpenCode no projeto
cd ~/meu-primeiro-swarm
opencode
# 2. Verificar na interface que os modelos mudaram
# Cada agente deve mostrar o modelo que voce definiu
# 3. Teste rapido: envie uma mensagem simples para o Sisyphus
# "Ola, me diga qual modelo voce esta usando"
# Ele deve responder identificando o modelo configurado
# 4. Se os modelos estao corretos, voce esta pronto!
# Proximo passo: sua primeira execucao real (Modulo 4.4)📚 Resumo do Modulo
Proximo Modulo:
4.4 - Primeira execucao: modo linguagem natural