Squads de agentes: como um agente passa o trabalho para o outro, com regra e aprovação

Um agente que faz tudo costuma fazer tudo mais ou menos. O prompt cresce, as ferramentas se acumulam e fica difícil saber por que ele tomou uma decisão. O caminho que funciona é o mesmo de um time de pessoas: cada agente com um papel, e uma regra clara de quando o trabalho passa de um para o outro.

Na ControlHub isso se chama squad.

O que é um squad

Um squad é um grupo de agentes que atende a mesma conversa. Um deles é a porta de entrada: é quem recebe a primeira mensagem. Os outros entram quando uma transição acontece — a passagem de bastão de um agente para outro.

Cada agente do squad continua sendo um agente completo: modelo, prompt, base de conhecimento e as ferramentas MCP que você liberou para ele. O squad só decide quem fala agora.

Os três jeitos de passar o bastão

Cada transição diz de qual agente para qual agente o trabalho vai, e o que dispara a passagem:

Gatilho	Quando dispara
Quando pedir	O próprio agente decide passar adiante, porque o pedido saiu da especialidade dele
Ao chamar ferramenta	O agente chama uma ferramenta específica — por exemplo, a que consulta erros no Sentry
Ao detectar palavras	A resposta do agente contém palavras-chave que você definiu, com a opção de exigir qualquer uma ou todas

Se mais de uma transição servir, vale nessa ordem: o pedido explícito, depois a ferramenta, depois as palavras.

E qualquer transição pode exigir aprovação humana: o agente propõe a passagem e ela só acontece depois que alguém aprova. É útil quando o próximo agente tem acesso a ferramentas que o primeiro não tem.

Um exemplo para time de software

Um squad simples para o dia a dia de engenharia:

Agente	Papel	Ferramentas
Triagem (porta de entrada)	Entende o pedido e decide para quem vai	Nenhuma — só conversa
Diagnóstico	Investiga erro em produção, com evidência	Sentry, GitHub (leitura)
Andamento	Resume o que entrou, travou ou mudou na sprint	Jira (leitura)

E as transições:

Triagem → Diagnóstico, quando pedir: "o checkout está dando erro 500 desde ontem".
Triagem → Andamento, ao detectar palavras como "sprint" ou "release" na resposta da triagem.
Diagnóstico → Andamento, quando pedir, com aprovação humana — antes de o assunto mudar de investigação para planejamento, alguém do time confirma.

Os agentes de diagnóstico e de andamento não precisam nascer do zero: as receitas em Agentes → Receitas criam o "Assistente de Engenharia" (Sentry, com GitHub e Jira opcionais) e o "Resumo de Sprint" (Jira, com GitHub opcional), já com prompt e só com ferramentas de leitura.

E se um desses agentes tentar escrever — comentar no PR, criar um card —, a regra das ferramentas MCP continua valendo dentro do squad: toda escrita espera aprovação de uma pessoa. Mais sobre isso em Ferramentas MCP com aprovação humana.

Como montar

Crie (ou reaproveite) um agente para cada papel.
Em Squads, crie o squad e adicione os agentes. Marque qual é a porta de entrada.
Adicione as transições: de quem, para quem, o gatilho e se exige aprovação.
Abra o chat do squad a partir da tela dele e veja o bastão passar. Cada passagem fica registrada no histórico da conversa.

Pausar o squad no painel pausa a orquestração de verdade: a conversa volta a ser atendida por um agente só.

Onde mais um squad trabalha

O mesmo squad pode atender clientes pelo módulo Atendimento — WhatsApp, Instagram, Messenger e Telegram —, e ali o gatilho de palavras e a aprovação funcionam do mesmo jeito. Mas o squad não depende de canal nenhum: ele nasce e roda dentro do chat do time.

O passo a passo com telas está na central de ajuda.