Um agente de código é um ótimo parceiro de programação. Quando o trabalho tem vários tipos de tarefa (planejar, escrever código, revisar, testar), um único agente começa a fazer malabarismo. Ele perde o plano de vista enquanto conserta um teste, ou revisa o próprio código e não encontra nada de errado. Uma equipe de agentes de IA divide essa carga como uma equipe humana: um agente lidera, os outros cuidam de um papel, e todos sabem para quem repassar o trabalho.
Neste post, explico o que é de fato uma equipe multiagente, quando ela compensa a configuração extra em comparação com um agente só ou uma execução paralela, e como montar uma na visão de equipe do AgentVera.
O que é uma equipe de agentes de IA
Uma equipe de agentes de IA são vários agentes de código trabalhando em um objetivo com uma estrutura em volta. É a estrutura que diferencia uma equipe de alguns terminais que por acaso estão abertos ao mesmo tempo. Ela tem quatro partes:
- Um gerente: um agente recebe o pedido, divide em partes, distribui as partes e confere o que volta.
- Papéis: cada membro tem uma função, como pesquisador, desenvolvedor, revisor ou testador, além de instruções que dizem no que ele deve e não deve mexer.
- Linhas de reporte: todo membro reporta a alguém. Se você não definir, ele reporta ao gerente.
- Repasses: um membro também pode ter um próximo destino fixo para o trabalho terminado; por exemplo, o desenvolvedor repassa ao revisor e o revisor repassa ao testador.
Os agentes conversam diretamente entre si. Um testador que encontra um bug não espera você copiar a falha para o terminal do desenvolvedor; ele mesmo envia a mensagem.
Quando uma equipe supera um agente só
Uma equipe gasta mais tokens e mais atenção que um agente só, então ela precisa justificar seu lugar. Esta tabela é como eu decido:
| Situação | Melhor opção | Por quê |
|---|---|---|
| Uma correção pequena em um ou dois arquivos | Um agente | Dividir só adiciona sobrecarga, e não há o que dividir |
| Uma funcionalidade com planejamento, código, revisão e testes | Equipe de agentes | Cada etapa tem um objetivo diferente, e um novo par de olhos ajuda |
| Um trabalho grande com partes claramente separadas | Equipe paralela | As partes rodam nos seus próprios worktrees e se juntam em uma branch |
| Trabalho contínuo ao longo de horas ou dias | Equipe de agentes | A equipe fica aberta e mantém os papéis entre as tarefas |
| Comparar duas abordagens para um problema | Dois agentes lado a lado | Você quer respostas independentes, não coordenação |
Resumindo: recorra a uma equipe quando o trabalho tem tipos diferentes de etapas que se beneficiam de papéis separados, e quando você quer que os agentes continuem se coordenando conforme o trabalho muda. Se você só precisa de vazão bruta em partes independentes, uma execução paralela é mais simples. Escrevi sobre esse lado em Agentes de código em paralelo e Rodando vários agentes do Claude Code.
Equipe de agentes vs equipe paralela
As duas existem no AgentVera e resolvem problemas diferentes:
- A visão de equipe organiza agentes já abertos em uma equipe duradoura. Eles mantêm seus papéis, conversam entre si e compartilham uma lista de tarefas e um quadro.
- Uma equipe paralela é iniciada por um agente para um trabalho. Ela divide o trabalho em até 8 partes, roda cada parte no seu próprio git worktree, junta as partes terminadas em uma branch de integração e roda uma verificação final. Ela termina aí, e você decide se abre um pull request.
As duas também se combinam bem: o gerente de uma equipe pode iniciar uma equipe paralela quando uma das tarefas é grande o suficiente para ser dividida.
Desenhando a equipe
Antes de abrir qualquer janela, esboce a equipe no papel. Três perguntas cobrem quase tudo.
1. Quem lidera?
O gerente deve ser o agente em quem você mais confia para planejar. Ele lê o pedido, divide e decide quem faz o quê. Dê a ele instruções sobre como você quer que o trabalho seja conferido, por exemplo “não marque uma tarefa como concluída até o testador rodar os testes”.
2. Quais papéis o trabalho realmente precisa?
Comece pequeno. Um desenvolvedor, um revisor e um testador sob um gerente cobrem a maior parte do trabalho com funcionalidades. Adicione um pesquisador quando o trabalho exigir leitura antes de programar, ou um papel de documentação quando a mudança mexer em APIs públicas. Cada agente a mais é mais um contexto para preencher e mais tokens para gastar.
3. Para onde o trabalho flui?
Desenhe dois tipos de linha:
- Reporta a: quem responde a quem. Isso define a quem o agente pergunta quando trava.
- Repassa o trabalho para: o próximo destino do trabalho terminado. Uma cadeia típica é desenvolvedor → revisor → testador.
Mantenha a cadeia curta. Uma cadeia longa significa que uma pequena mudança espera muitos turnos antes de alguém avisar que está pronta.
Montando na visão de equipe do AgentVera
A visão de equipe transforma esse esboço em uma equipe funcionando. Você a abre pelo ícone de equipe em um grupo ou pelo topo da barra lateral.
Passo 1: posicione os agentes
A janela mostra Team structure ao lado de um conjunto chamado Agents in the workspace. Arraste agentes do conjunto para a estrutura, ou use Open a new agent para iniciar um para um papel que você ainda não tem. O primeiro agente que você marcar como Manager lidera a equipe. Uma equipe tem um gerente e até 24 membros, e todo membro precisa ser um agente do projeto do grupo. Sessões de terminal ficam de fora.
Se preferir não começar do zero, Ready-made teams oferece um kit completo:
- Equipe de software: um tech lead com planejador, desenvolvedor, revisor e testador.
- Equipe de pesquisa: um líder de pesquisa com um pesquisador e um redator de relatórios.
- Equipe de redes sociais: um gerente de redes sociais com pesquisador de tendências, redator, designer visual e especialista em anúncios. Ela prepara rascunhos e pergunta a você antes de publicar qualquer coisa ou gastar qualquer dinheiro.
Um kit abre para você os novos agentes de que precisa.
Passo 2: dê um papel a cada agente
Selecione um agente e defina seu Role e suas Instructions. Ready-made roles preenchem um nome e instruções para você: pesquisador, planejador, desenvolvedor, revisor, testador, DevOps, designer, documentação e segurança. Vários agentes podem compartilhar um papel, o que é útil quando dois desenvolvedores dividem o front-end e o back-end.
Passo 3: desenhe as linhas
Cada membro tem Reports to e Hands its work to. Você pode defini-los pelos campos ou arrastando um agente sobre outro e escolhendo “Report to…”, “Hand its work to…” ou “Swap places with…”. Arrange automatically organiza o layout. Um membro sem linha de reporte reporta ao gerente, e se você criar um ciclo sem querer, ele é redirecionado ao gerente.
Passo 4: dê ferramentas à equipe
Em Team’s MCP servers, você escolhe servidores que todos os membros recebem. Cada papel pode adicionar os seus por cima, por exemplo Playwright para o testador ou uma ferramenta de design para o designer. Um agente pode recusar nas próprias configurações. Se um servidor sugerido ainda não estiver instalado, você recebe um aviso e pode adicioná-lo pelo catálogo. Agentes cujas ferramentas mudaram reiniciam quando o turno atual termina, então nada é cortado no meio de uma tarefa. Explico servidores MCP com mais detalhes em O que é um servidor MCP.
Passo 5: salve e dê trabalho à equipe
Save and open the team coloca os agentes no grupo, para que eles possam trocar mensagens e compartilhar a lista de tarefas e o quadro. Salvar não inicia nada. O trabalho começa quando você usa Give to the team: o pedido vai para o gerente por padrão, ou para qualquer agente que você escolher. Cada agente é orientado sobre seu papel, e a orientação só se repete quando a equipe muda. Se as mensagens entre agentes estavam desligadas, elas são ligadas.
Acompanhando o trabalho da equipe
A aba Team mostra a estrutura ao vivo. Agentes trabalhando brilham, mensagens viajam como luz pelas linhas e um balão de fala aparece sobre o agente que está falando. Ao lado:
- Team status mostra a etapa atual de cada agente: editando, lendo, rodando um comando, buscando, planejando ou trocando mensagens.
- Activity é o feed de mensagens, trabalho e eventos dos agentes, com filtros para All, Messages, Work e Agents.
- Tasks é a lista compartilhada em que os agentes adicionam, assumem e concluem tarefas.
- Waiting for you reúne pedidos de permissão, que você aprova ou recusa ali mesmo.
Quando você precisa corrigir o rumo, Status report pede ao gerente um resumo curto do que cada agente está fazendo, do que está pronto e de onde a equipe travou. Quando você escreve para um agente, Interrupt and redirect interrompe o que ele está fazendo e repassa sua mensagem na hora, enquanto Queue repassa quando o trabalho atual dele termina. Interrupt all interrompe todos os agentes que estão trabalhando, depois de uma confirmação.
Como os agentes conversam
Por baixo dos panos, as mensagens entre agentes dão a cada agente ferramentas para listar os outros, enviar uma mensagem (e, se quiser, esperar a resposta), responder e trabalhar com a lista de tarefas compartilhada. Um agente ocupado recebe a mensagem quando o turno dele termina, então ninguém é interrompido no meio de uma edição. As mensagens são marcadas como vindas de outro agente, e cada remetente tem um limite de envio para que dois agentes não fiquem em loop para sempre. Funciona entre CLIs: Claude Code, Codex, Gemini CLI e os outros usam as mesmas ferramentas.
Erros comuns
- Agentes demais no primeiro dia. Cinco agentes em uma mudança pequena passam a maior parte dos turnos lendo as mensagens uns dos outros. Comece com três e adicione papéis quando aparecer uma lacuna.
- Papéis vagos. “Ajudar com o código” não é um papel. Diga pelo que o agente responde, quais pastas ele pode alterar e o que “pronto” significa para ele.
- Nenhum revisor ou testador. Uma equipe em que o desenvolvedor confere o próprio trabalho é só um agente com passos extras.
- Arquivos com dono sobreposto. Dois desenvolvedores nos mesmos arquivos vão atrapalhar um ao outro. Divida por pasta, ou deixe o gerente iniciar uma equipe paralela para que cada parte ganhe seu próprio worktree. Veja Git worktrees para agentes em paralelo.
- Dar trabalho a todos os agentes de uma vez. Deixe o gerente dividir. Esse é o motivo de ter um.
- Ignorar as aprovações. Um agente esperando um pedido de permissão trava todos depois dele na cadeia. Fique de olho na barra de atenção.
Checklist
- Um gerente com instruções sobre como conferir o trabalho
- Cada papel tem um dono claro, um escopo e uma definição de pronto
- Linhas de reporte e repasses desenhados, com a cadeia curta
- Um revisor ou testador em algum ponto da cadeia
- Servidores MCP da equipe e dos papéis escolhidos e instalados
- O primeiro pedido escrito para o gerente, não para cada agente
Conclusão
Uma equipe de agentes de IA vale a pena quando o trabalho tem etapas distintas e você quer que elas sejam tratadas por agentes que continuam se coordenando sem você repassar mensagens. A estrutura é simples: um gerente, alguns papéis bem descritos e linhas curtas de reporte e repasse. Comece pequeno, acompanhe a primeira execução na aba Team e ajuste os papéis onde você vir agentes esperando ou repetindo uns aos outros. Se você prefere pensar em etapas fixas, pipelines de fluxo de trabalho com agentes de IA cobre essa abordagem.
O AgentVera permite montar a equipe com os agentes que você já tem abertos, seja qual for a CLI. Você pode começar de graça e conferir os planos quando precisar de mais.