Quando pedimos ao Codex para concluir uma tarefa, geralmente o pensamos como um agente único. Mas se algumas tarefas são complexas o suficiente e envolvem vários tipos distintos de trabalho, o Codex tentará dividir o problema em tarefas menores e gerar agentes separados para trabalhar nelas. Esses agentes delegados são chamados de subagentes. Cada subagente trabalha em seu próprio thread e se concentra apenas em uma parte da tarefa original. Ao mesmo tempo, o agente principal coordena seu trabalho e produz a resposta final agregando os resultados dos subagentes. Como praticantes, isso naturalmente nos leva a esta pergunta: Como podemos usar subagentes deliberadamente para nossos próprios problemas? Neste post, exploraremos os subagentes do Codex através de um estudo de caso prático. Ao longo do caminho, veremos como definir e delegar trabalho a agentes especialistas, inspecionar seus threads individuais e deixar o agente principal combinar suas descobertas em um resultado final.

Aqui, consideramos uma tarefa de planejamento de viagem. Suponha que queremos planejar uma viagem solo de quatro dias a partir de Zurique. Temos um orçamento total de 1.200 francos suíços. Nossos destinos potenciais incluem Lisboa, Praga e Copenhague, e nos importamos com viagens convenientes, museus e comida local. Para esta tarefa, preparamos três agentes especialistas: Agente de logística de viagem, Agente de análise de orçamento e Agente de pesquisa de experiências. Cada especialista avaliará os três destinos de sua própria perspectiva. Em seguida, o agente principal coletará suas descobertas, comparará as compensações e recomendará um destino final.

O Codex nos permite definir agentes personalizados para um projeto específico. Podemos fazer isso adicionando arquivos TOML em .codex/agents/: Cada definição de agente requer três campos: nome, descrição e instruções do desenvolvedor. Um agente personalizado também pode especificar seu próprio modelo, esforço de raciocínio, configuração de sandbox, ferramentas e habilidades. Se não substituirmos essas configurações aqui, os três especialistas as herdarão da sessão principal do Codex. Além disso, adicionamos uma pequena configuração em nível de projeto em .codex/config.toml para permitir que até três threads de subagentes sejam executados simultaneamente.

No prompt, pedimos explicitamente ao agente principal que usasse nossos agentes especialistas definidos ao resolver a tarefa. Iniciamos o Codex a partir do diretório do projeto com a pesquisa na web habilitada, observando que só precisamos habilitar a pesquisa na web para a sessão principal. Os três subagentes herdam essa capacidade quando o Codex os gera. Vimos que o Codex iniciou os três agentes especialistas em paralelo. Podemos inspecionar seu progresso diretamente da CLI usando a visualização de threads de agentes, pois cada especialista tem seu próprio contexto, atividade de ferramentas e resultado eventual. Quando os três agentes terminam, suas descobertas são retornadas ao agente principal para síntese. Podemos então verificar o que produziram, e cada subagente retornou uma recomendação de sua própria perspectiva.

Entidades-chave: Locais: Zurique, Lisboa, Praga, Copenhague