文档
Documentação em Português
Agentes

Agentes

Agentes são assistentes de IA especializados configurados para tarefas e fluxos de trabalho específicos. Eles permitem ferramentas focadas com prompts personalizados, modelos e acesso a ferramentas.

Tipos de Agentes

Agentes Primários

Assistentes principais para interação direta. Alterne entre eles com a tecla Tab.

  • Build: Agente padrão com todas as ferramentas habilitadas
  • Plan: Agente restrito para planejamento e análise

Subagentes

Assistentes especializados invocados por agentes primários ou via menções @.

  • General: Propósito geral para tarefas de múltiplos passos
  • Explore: Exploração rápida do código base

Métodos de Configuração

Configuração JSON

{
  "agent": {
    "review": {
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Configuração Markdown

Coloque em ~/.config/opencode/agent/ ou .opencode/agent/:

---
description: Reviews code for quality
mode: subagent
temperature: 0.1
tools:
  write: false
  edit: false
---
You are in code review mode. Focus on quality and security.

Opções de Configuração

OpçãoPropósito
descriptionDescrição breve (obrigatória)
temperatureAleatoriedade da resposta (0.0-1.0)
maxStepsLimitar iterações agênticas
modelSubstituir modelo global
toolsHabilitar/desabilitar ferramentas
permissionControle de acesso a ferramentas
modeprimary, subagent ou all

Criar Agentes

opencode agent create

Casos de Uso Comuns

  • Agente build: Desenvolvimento completo
  • Agente plan: Análise sem alterações
  • Agente review: Revisão de código (somente leitura)
  • Agente debug: Investigação
  • Agente docs: Escrever documentação