O papel do líder e dos subagentes
Nesta página
Uma hierarquia clara
A arquitetura multiagente do Grok assenta numa distinção fundamental entre dois tipos de agentes: o líder e os subagentes. Enquanto não compreender esta hierarquia, escreverá prompts direcionados à parte errada do sistema, questionando-se depois porque é que as suas instruções não foram seguidas.
O agente líder
O líder é o agente principal e o único que interage diretamente consigo. Desempenha três funções sequenciais. Primeiro, coordena, decompondo o seu pedido e distribuindo subtarefas pelos subagentes. De seguida, supervisiona, acompanhando a investigação de cada agente e orientando a discussão para as perspetivas que geram resultados. Por fim, sintetiza, compilando os contributos numa resposta estruturada.
Um ponto merece ser aceite exatamente como formulado: apenas as chamadas de ferramentas e a resposta do líder são devolvidas ao utilizador. Nunca vê diretamente o que os subagentes produzem, apenas o resultado final do líder. Na prática, se um subagente encontrar uma informação crucial mas o líder decidir que ela foge ao âmbito do seu pedido, essa informação não aparecerá em lado nenhum no que recebe.
Os subagentes
Os subagentes são os investigadores da equipa e cada um dispõe exatamente do mesmo conjunto de ferramentas que o líder. Um agente responsável pelo monitorização de produtos obterá anúncios oficiais com web_search e avaliará depois as reações no terreno com x_search, que pesquisa publicações no X. O agente que herda a parte do trabalho mais densa em números pode acionar code_execution para recalcular uma projeção em vez de a estimar mentalmente. collections_search consulta as suas coleções e as ferramentas MCP remotas que declarou também estão disponíveis para toda a equipa, não apenas para o líder.
Comunicam entre si e com o líder para afinar a sua investigação, o que lhes permite explorar um tema sob vários ângulos em simultâneo, sem que dois agentes refaçam o mesmo trabalho.
O raciocínio encriptado dos subagentes
O raciocínio interno dos subagentes permanece encriptado. Não pode ler o seu processo de pensamento, ao contrário do raciocínio visível que modelos mais antigos como o grok-3-mini expunham. Esta diferença surpreende frequentemente programadores habituados a inspecionar registos de raciocínio para compreender um resultado inesperado: essa porta está aqui fechada.
Daqui decorrem três consequências. Vê apenas o resultado final do líder, nunca as etapas intermédias. O estado do subagente só é acessível ativando o parâmetro use_encrypted_content=True. E mesmo com esse parâmetro, o conteúdo permanece encriptado: serve para o modelo manter a coerência da conversa ao longo das interações, não para ser lido por si. Esta opacidade é uma compensação deliberada — concede aos agentes liberdade para raciocinar sem restrições de exibição, ao custo de menor transparência para si.
A resposta final
Quando o líder recebe informação suficiente dos seus subagentes, produz a resposta final. Essa resposta incorpora os resultados da investigação encontrados pelos vários agentes, as chamadas de ferramentas efetuadas por qualquer um deles — pesquisa na web, execução de código — e a própria síntese estruturada do líder.
As chamadas de ferramentas merecem atenção especial: aparecem na resposta quer tenham sido feitas pelo líder quer por um subagente. É o único vislumbre que tem do trabalho dos subagentes. Se quiser verificar se uma pesquisa atingiu efetivamente as fontes corretas, é aí que deve olhar, e em mais lado nenhum.
O que isto significa para os seus prompts
Esta arquitetura altera a forma como formula um pedido. Uma vez que o líder trata da formatação, seja preciso quanto ao entregável que espera: uma tabela comparativa, uma nota de briefing, uma lista fundamentada — ele precisa de saber o que construir. Defina também o âmbito da investigação, porque os subagentes necessitam de limites claros, caso contrário dispersam-se; um pedido vago sobre “o mercado da IA” produzirá quatro explorações divergentes que o líder terá depois dificuldade em conciliar.
Dois hábitos completam este quadro. Peça explicitamente fontes se as quiser: os agentes sabem citar, mas nem sempre o fazem. E desista de tentar orientar subagentes a partir do seu prompt — escrever “faz o agente 3 verificar os preços” não tem efeito, já que o seu único contacto é o líder e a divisão do trabalho compete-lhe a ele.
Pontos-chave
- O líder coordena, supervisiona e sintetiza — é o seu único contacto
- Os subagentes realizam a investigação e a análise em paralelo
- Apenas a resposta do líder e as chamadas de ferramentas são devolvidas
- O raciocínio dos subagentes está encriptado e é inacessível
- Os seus prompts devem visar o líder com instruções claras sobre o entregável