Voltar para a documentaçãoGuia multiagente do Codex

Orquestre agentes Sol e Terra no DCC

Use o GPT-5.6 Sol como agente principal, delegue trabalhos independentes para subagentes Terra e supervisione todo o fluxo pelo chat do DCC.

Como a orquestração funciona

O Sol continua responsável por entender o pedido, tomar decisões, integrar todos os resultados necessários e entregar a resposta final. Quando o trabalho pode ser dividido com segurança, ele pode iniciar subagentes Terra em paralelo.

  • Delegue pesquisas, revisões, testes e implementações delimitadas e independentes.
  • Mantenha tarefas pequenas, sequenciais ou muito acopladas no agente principal.
  • Use a menor equipe útil para evitar demora e consumo desnecessários.

Instale o preset de orquestração

O preset é instalado por projeto e compilado para o worktree ativo.

  1. 1Abra o projeto no DCC.
  2. 2Abra Skills.
  3. 3Clique em Preset de orquestração.
  4. 4Mantenha os valores padrão e confirme que Codex está selecionado em Agentes alvo.
  5. 5Deixe Desativar invocação pelo modelo desligado.
  6. 6Clique em Salvar skill.
  7. 7Crie uma nova sessão depois que o botão mostrar Orquestração instalada.
Ao salvar, o DCC cria a skill dcc-orchestration e a compila automaticamente. Uma sessão que já estava aberta pode ter carregado o catálogo de skills anterior.

Ativação automática e explícita

Selecione GPT-5.6 Sol no seletor de modelo do chat. Você não precisa mencionar a skill em todo prompt.

Automática

O Sol pode invocar a skill quando a delegação melhorar a velocidade, a qualidade ou o isolamento de contexto. Uma tarefa simples pode continuar no agente principal.

Exemplo de prompt

Analise separadamente a arquitetura do frontend e do backend, identifique riscos e apresente uma recomendação consolidada. Não altere arquivos.

Explícita

Cite a skill e solicite a delegação quando quiser usar a orquestração em uma tarefa específica.

Exemplo de prompt

Use $dcc-orchestration e delegue as partes independentes para agentes Terra.

Você também pode pedir que o Sol delegue sem citar a skill. Mencioná-la explicitamente elimina a ambiguidade sobre o fluxo desejado.

Configure os subagentes simultâneos

Abra Configurações → Provedores → Codex → Subagentes simultâneos. A configuração vale para novas sessões e não conta o Sol.

Automático (Codex)

O DCC não envia um limite e deixa o próprio Codex decidir.

Limite numérico

Restringe quantos subagentes podem ficar abertos ao mesmo tempo.

O preset normalmente inicia de um a três subagentes e sempre respeita o limite configurado.

Teste rápido: confirme Sol → Terra

Use este fluxo somente de leitura para validar a delegação sem alterar arquivos do projeto.

  1. 1Instale o preset.
  2. 2Crie uma nova sessão.
  3. 3Selecione GPT-5.6 Sol no chat.
  4. 4Envie o prompt de teste abaixo.
  5. 5Expanda Árvore de agentes na resposta.

Exemplo de prompt

Use $dcc-orchestration. Inicie dois agentes Terra em paralelo: um deve analisar somente a arquitetura do frontend e o outro somente a arquitetura do backend. Não altere arquivos. Aguarde os dois e entregue uma conclusão consolidada.

Resultado esperado

  • Agente principal — GPT-5.6 Sol.
  • Dois subagentes Terra com nomes e caminhos próprios.
  • Trabalhando enquanto cada subagente estiver executando.
  • Concluído ou Falhou quando cada subagente terminar.
  • O chat é liberado depois que o Sol entrega a resposta final.

Teste a ativação automática

Depois que o teste explícito funcionar, crie outra sessão com o Sol e envie um pedido complexo sem mencionar delegação nem a skill.

Exemplo de prompt

Faça uma avaliação independente da arquitetura do frontend, do backend e da estratégia de testes. Compare os resultados e recomende as três melhorias mais importantes. Não altere arquivos.

Se nenhum subagente aparecer em um pedido pequeno, isso não representa necessariamente uma falha. Use o teste rápido explícito para separar uma decisão do modelo de um problema de infraestrutura.

Acompanhe e supervisione

A Árvore de agentes mostra cada subagente iniciado pelo Sol e mantém o agente principal visível.

  • Use Instruir para enviar uma orientação adicional a um subagente ativo.
  • Use Interromper para solicitar que um subagente ativo pare.
  • Acompanhe o modelo, o caminho e o estado de cada agente.
  • Aguarde o Sol integrar os resultados necessários e concluir a resposta principal.
Sessões antigas que não registraram o evento final de um subagente podem mostrar Encerrado. Esse estado histórico neutro evita afirmar incorretamente que um agente continua trabalhando.

Se nenhum subagente aparecer

Confira a sessão e o preset antes de considerar o comportamento uma falha do runtime.

  1. 1Confirme que GPT-5.6 Sol está selecionado no chat.
  2. 2Confirme que Skills mostra Orquestração instalada.
  3. 3Confirme que Codex está entre os agentes alvo.
  4. 4Deixe Desativar invocação pelo modelo desligado no teste automático.
  5. 5Crie uma nova sessão depois de salvar a skill ou alterar a concorrência.
  6. 6Execute o prompt explícito do teste rápido.
O DCC detecta se o Codex CLI instalado oferece suporte à capacidade de orquestração usada pela sessão. Quando ela não está disponível, o DCC preserva o comportamento anterior em vez de quebrar a sessão. Atualize o Codex CLI quando houver uma versão compatível e teste novamente em uma nova sessão.