OpenCode: OpenCode Agent Mode
Última atualização: 2026-08-31
--- title: Agentes do OpenCode description: Compreenda o sistema de agentes com agentes integrados, agentes personalizados e configuração de sub-agentes order: 13 lang: pt-br
Agentes são assistentes de IA especializados no OpenCode, cada um configurável com prompts, modelos, ferramentas e permissões independentes.
1. O Que Você Vai Aprender
- Tipos de agente: primário e sub-agente
- Agentes integrados
- Configuração de agentes personalizados
- Métodos de uso de agentes
2. Tipos de Agente
| Tipo | Descrição | Alternância |
|---|---|---|
| Agente primário | Assistente principal para interação direta | Tecla Tab |
| Sub-agente | Assistente especializado chamado pelo primário | @nome_agente ou chamada automática |
3. Agentes Integrados
| Agente | Tipo | Descrição |
|---|---|---|
| Build | Primário | Agente padrão com todas as ferramentas habilitadas |
| Plan | Primário | Análise e planejamento apenas — edit/bash configurados como ask |
| General | Sub-agente | Ferramentas completas, pode modificar arquivos |
| Explore | Sub-agente | Somente leitura, não pode modificar arquivos |
Agentes de sistema (ocultos): Compaction, Title, Summary
4. Alternar e Chamar Agentes
- Alternar primário: Tab / Shift+Tab
- Chamar sub-agente:
@explore encontre todo uso de Redis - Navegar sub-sessões: Leader+→ / Leader+← / Leader+↑
5. Configuração de Agente Personalizado
JSON:
{
"agent": {
"code-reviewer": {
"description": "Reviews code for best practices",
"mode": "subagent",
"model": "anthropic/claude-sonnet-4-20250514",
"prompt": "You are a code reviewer. Focus on security and performance.",
"tools": { "write": false, "edit": false }
}
}
}
Markdown:
Coloque em ~/.config/opencode/agents/ (global) ou .opencode/agents/ (projeto). O nome do arquivo vira o nome do agente.
6. Opções de Configuração
| Opção | Descrição |
|---|---|
description |
Descrição da função (obrigatório) |
mode |
primary / subagent / all |
model |
Especificar modelo (provider/model-id) |
prompt |
Prompt do sistema, suporta {file:./path} |
temperature |
Aleatoriedade da saída (0.0-1.0) |
steps |
Máximo de iterações |
tools |
Permissões de acesso a ferramentas |
permission |
Controle granular de permissões |
hidden |
Ocultar do menu @ |
color |
Cor de exibição na UI |
disable |
Desabilitar agente |
7. Criação Rápida
opencode agent create
Criação interativa guiada de agente.
❓ FAQ
P: Quando usar Plan em vez de Build?
R: Quando quiser que a IA analise e aconselhe sem modificar arquivos. Plan tem edit/bash configurados como ask.
P: Sub-agentes podem chamar sub-agentes?
R: Sim, via ferramenta Task. Evite chamadas circulares. Use permission.task para controlar.
📖 Resumo
- Agentes: primário (Tab alternar) e sub-agente (@ chamar)
- 4 agentes integrados usáveis + 3 de sistema
- Configuração via JSON ou Markdown
- Especifique modelo, prompt, ferramentas, temperature por agente
- Crie rapidamente com
opencode agent create
📝 Exercícios
-
Básico: Alterne entre Build e Plan no TUI usando Tab.
-
Intermediário: Crie um agente de revisão de código somente leitura com temperature baixa e permissões adequadas.
-
Avançado: Prolete um sistema completo de agentes (primário + sub-agentes) para um fluxo de desenvolvimento.
