Tema
Tipos de Agent e sub-agents
Um Agent pode trabalhar sozinho ou como chefe de uma pequena equipe. Na equipe, cada membro é um sub-agent: um Agent especialista que só existe dentro do Agent principal (o orquestrador). O tipo do Agent, escolhido no passo Identidade, define como essa equipe trabalha.
Os quatro tipos
| Tipo | Quem conversa | Como os sub-agents são usados | Exige |
|---|---|---|---|
| LLM | O próprio Agent, com modelo, instrução e ferramentas | Opcional. O Agent decide, a cada mensagem, se responde ou se transfere para um sub-agent. | Modelo |
| Sequencial | Os sub-agents, um depois do outro | Todos rodam, sempre na mesma ordem. | Pelo menos 1 sub-agent |
| Paralelo | Os sub-agents, ao mesmo tempo | Todos rodam simultaneamente, cada um no seu ramo. | Pelo menos 2 sub-agents |
| Loop | Um sub-agent, repetidas vezes | O mesmo sub-agent roda de novo até o limite de voltas. | Exatamente 1 sub-agent e Máximo de Iterações |
Dica
Para atendimento no WhatsApp, quase sempre o tipo certo é LLM: sozinho, ou como orquestrador que transfere para especialistas. Os tipos Sequencial, Paralelo e Loop são para tarefas de processamento (analisar um documento em etapas, consultar várias fontes, revisar um texto até ficar bom), não para conversa livre.
LLM
É o Agent "clássico". Tem modelo, Instrução (System Prompt), User Message Template e ferramentas. Se você adicionar sub-agents a um Agent LLM, ele vira orquestrador: a plataforma dá a ele uma ferramenta interna de transferência e, a cada mensagem, ele escolhe entre responder ou passar a conversa para o sub-agent mais adequado. A escolha é feita com base no nome e na descrição de atuação de cada sub-agent, por isso esses campos precisam ser claros.
Sequencial
Os sub-agents rodam em fila, na ordem em que aparecem no passo Sub-agentes. Na Revisão, o resumo diz "Passa o atendimento por N colega(s), sempre nesta ordem."
O Agent sequencial não tem modelo nem instrução próprios: quem pensa são os sub-agents. Para um sub-agent usar o resultado do anterior, use a Chave de saída (output_key): o resultado de cada um fica guardado com esse nome e o próximo pode referenciá-lo com {{nome_da_chave}} na instrução.
Exemplo: análise de contrato em três etapas.
| Ordem | Sub-agent | Chave de saída | Instrução (resumo) |
|---|---|---|---|
| 1 | Extrator | clausulas | Liste as cláusulas do contrato. |
| 2 | Analista | riscos | Para cada item de {{clausulas}}, aponte o risco. |
| 3 | Redator | — | Com base em {{riscos}}, escreva um parecer de um parágrafo. |
Paralelo
Todos os sub-agents rodam ao mesmo tempo, cada um sem ver o que os outros estão fazendo. Na Revisão: "Aciona N colegas ao mesmo tempo e junta o que eles trouxerem." Use a Chave de saída em cada um para que os resultados fiquem separados e possam ser usados depois.
Se um dos sub-agents falhar, a execução inteira é interrompida.
Loop
Um único sub-agent roda várias vezes seguidas, até atingir o Máximo de Iterações (de 1 a 50, obrigatório). Na Revisão: "Repete o próprio trabalho até resolver, no limite de N voltas."
Atenção
Hoje o loop sempre roda até o Máximo de Iterações: o assistente não oferece uma forma de o sub-agent "avisar que terminou" e encerrar antes. Comece com um número baixo (2 ou 3) e aumente só se o resultado pedir, porque cada volta é uma chamada inteira ao modelo.
Atenção
O Loop exige exatamente um sub-agent. O assistente não bloqueia a publicação com dois ou mais, mas a publicação falha. Se aparecer erro ao publicar um Agent Loop, confira o número de sub-agents.
Configurar um sub-agent
No passo Sub-agentes, clique em Adicionar sub-agente. Abre a janela Configurar sub-agente, com seis abas. Ao final, clique em Salvar sub-agente.
Passo Sub-agentes do assistente, com o botão 'Adicionar sub-agente'.
Aba Identidade
Aba Identidade do sub-agent, com ícone, nome, especialidade e descrição.
| Campo | O que colocar |
|---|---|
| Ícone e cor | O badge do sub-agent. |
| Nome do sub-agente (obrigatório) | Ex.: "Agente de Triagem Processual". É com esse nome que o orquestrador o chama. |
| Especialidade / Role | Em uma linha, o que ele faz. |
| Descrição | Detalhe da especialidade. |
Aba Comportamento
Aba Comportamento do sub-agent, com modelo herdado, System Prompt, Temperatura, Top-P e modo de colaboração.
| Campo | Padrão | O que faz |
|---|---|---|
| Modelo / Herdar do orquestrador | Herdar | Com "Herdar" ligado, usa o mesmo modelo do Agent principal. Desligue para usar outro (ex.: um modelo mais barato para uma tarefa simples). |
| System Prompt | vazio | A instrução própria do sub-agent. Escreva como se fosse um Agent independente. |
| Temperatura | 0,7 | De 0 a 2. Mais baixo = respostas mais previsíveis. Não é enviada para modelos Claude. |
| Top-P | 0,95 | De 0 a 1. Outro controle de variação. Não é enviado para modelos Claude. |
| Modo de colaboração | Chat | Como o sub-agent se relaciona com o orquestrador (tabela abaixo). |
| Modo | Comportamento |
|---|---|
| Chat | Conversa contínua. Assume a conversa e segue falando com o contato. |
| Task | Executa a tarefa e devolve ao orquestrador automaticamente. |
| Single-turn | Responde uma vez, de forma autônoma, sem ver o histórico. Não devolve nem transfere. |
Aba Ferramentas
Aba Ferramentas do sub-agent, com as ferramentas próprias e a seção Tools liberadas.
As ferramentas, Skills e MCP Servers deste sub-agent. Nada é herdado do orquestrador, a não ser o CRM nativo, que vai para todos. Aqui também fica a seção Tools liberadas, para escolher quais ferramentas de cada servidor o sub-agent pode usar. Veja MCP Servers no Agent.
Aba Conhecimento
Bases de conhecimento deste sub-agent, com os mesmos controles do Agent principal. Veja Conhecimento.
Aba Roteamento
Aba Roteamento do sub-agent, com as regras de quando atuar, a descrição de atuação e os interruptores de devolução.
É aqui que você diz ao orquestrador quando chamar este sub-agent.
| Campo | O que faz |
|---|---|
| Quando este agente deve atuar | Regras com gatilho (sempre, por intenção ou por palavra-chave). Elas viram texto na descrição que o orquestrador lê. |
| Descrição de atuação | Texto livre sobre quando acionar este sub-agent. É o campo que mais influencia a escolha do orquestrador. |
| Pode devolver (ligado) | Devolve o atendimento ao agente principal ao concluir. |
| Pode acionar outros agentes (desligado) | Pode passar o atendimento para outros agentes. |
Esses dois interruptores definem o Modo de colaboração: "Pode acionar outros agentes" ligado = Chat; só "Pode devolver" = Task; nenhum dos dois = Single-turn.
Aba Avançado
Aba Avançado do sub-agent. Hoje só o Timeout é aplicado.
Timeout (segundos), padrão 30: tempo máximo de uma execução deste sub-agent.
Atenção
A aba Avançado também mostra Tentativas (retry), Delay inicial, Em caso de erro, Sub-agente de fallback e Contrato de entrada/saída, e a aba Comportamento mostra Max Tokens. Hoje esses campos não são aplicados: só o Timeout é salvo. O botão Gerar com IA do System Prompt ainda não funciona.
Regras de transferência
- Um sub-agent que não tem sub-agents próprios não transfere para outro sub-agent. Só o orquestrador re-roteia, sempre na próxima mensagem do contato. Isso evita que dois especialistas fiquem se passando a conversa em loop.
- O orquestrador não transfere para ele mesmo.
- A hierarquia pode ter até 8 níveis de profundidade.
- Cada sub-agent existe só dentro do seu orquestrador. Para usar o mesmo especialista em dois orquestradores, configure-o nos dois.
Formas de rotear a conversa
Somente roteamento (o orquestrador nunca responde)
Por padrão, o Agent orquestrador decide a cada mensagem entre transferir para um sub-agent ou responder ele mesmo — e, na prática, ele oscila: às vezes transfere, às vezes assume a conversa e faz perguntas que eram território de uma persona específica. Escrever "sempre transfira, nunca responda" na instrução não resolve, porque instrução é sugestão para o modelo, não regra.
O switch Somente roteamento, na aba Sub-agentes, tira essa escolha do modelo. Com ele ligado, o orquestrador só decide e transfere: se ainda assim ele tentar responder o contato, a plataforma descarta a resposta e exige a transferência. O contato nunca fica sem resposta — quem responde é sempre um sub-agent.
Somente roteamento ligado na aba Sub-agentes, com o sub-agente de fallback escolhido.
Dois campos acompanham o switch:
- Sub-agente de fallback — quem recebe a conversa quando o orquestrador insiste em responder. A lista vem dos sub-agents que você já adicionou.
- Tentativas de correção antes de forçar — quantas chances o orquestrador tem de se corrigir sozinho antes de a transferência ser imposta. Vazio equivale a 1. Com
0, a primeira tentativa de responder já força a transferência para o fallback.
Dica
Deixe o padrão (1 tentativa). Ela costuma bastar para o orquestrador escolher a persona certa, em vez de cair sempre no fallback — e custa, no pior caso, uma chamada extra ao modelo.
Atenção
O switch fica desabilitado enquanto não houver pelo menos um sub-agent e um modelo selecionado — sem destino, não há para onde rotear. Se você renomear ou remover o sub-agent escolhido como fallback, a tela acusa o erro e a publicação fica bloqueada até você escolher outro.
Roteamento por etapa do CRM (além da transferência direta)
Existe uma segunda forma de trocar "quem responde", diferente da delegação direta entre agents: o orquestrador consulta a etapa atual do negócio no funil do CRM e decide, a cada nova mensagem, qual sub-agent deve atender. É um re-roteamento por estado — a decisão é simples e reavaliada do zero a cada mensagem, com base na etapa do negócio associado ao contato, não uma passagem de bastão explícita entre duas partes.
Exemplo do workspace de demonstração Advocacia Serafim, com o funil Comercial:
| # | Etapa | Tipo |
|---|---|---|
| 1 | Triagem | aberta |
| 2 | SDR | aberta |
| 3 | SDR - 1º Follow Up | aberta |
| 4 | SDR - 2º Follow Up | aberta |
| 5 | SDR - 3º Follow Up | aberta |
| 6 | Closer | aberta |
| 7 | Closer - 1º Follow Up | aberta |
| 8 | Closer - 2º Follow Up | aberta |
| 9 | Closer - 3º Follow Up | aberta |
| 10 | Contrato Gerado | aberta |
| 11 | Aguardando Assinatura | aberta |
| 12 | Gerar Financeiro | ganho |
| 13 | Desqualificado | perdido |
Regra de roteamento: o orquestrador só direciona a conversa para a closer Aurora quando o negócio está numa etapa cujo nome começa com Closer (Closer, Closer - 1º/2º/3º Follow Up, Contrato Gerado, Aguardando Assinatura, Gerar Financeiro). Enquanto o negócio está em Triagem ou SDR*, quem atende é a SDR Sofia.
Na prática, é a própria Sofia quem dispara a troca: ao qualificar o lead, ela move o negócio para a etapa Closer. Isso não aciona a Aurora na hora — o repasse acontece na próxima mensagem do contato, quando o orquestrador reavalia a etapa do CRM e roteia para quem é dono daquela etapa.
Atenção
O handoff Sofia → Aurora é imediato e contínuo, no mesmo WhatsApp — não é uma ligação telefônica nem um "alguém vai te contatar em breve". Se você está escrevendo instruções para uma SDR que qualifica e passa o bastão para uma closer, deixe isso explícito na instrução: ela deve indicar que a conversa continua ali mesmo, sem prometer contato humano ou por telefone.
Os agents também têm autonomia para criar, via suas ferramentas de CRM, a estrutura que estiver faltando, em vez de depender de tudo pré-cadastrado. Antes de mover um negócio, o agent confere a lista de etapas do funil; se a etapa canônica necessária não existir, ele a cria usando o nome canônico exato e só então move o negócio. O mesmo vale para tags: o agent confere se a tag já existe antes de aplicar e, se faltar, cria a tag antes de aplicá-la ao contato.
Atenção
Os nomes de etapa são um vocabulário canônico compartilhado entre os agents — o roteamento por etapa (regra Closer* → Aurora, acima) depende do nome exato. O agent não pode inventar variações (ex.: "Fechamento" no lugar de "Closer"); só cria a etapa se ela realmente não existir, sempre com o nome canônico, evitando duplicar etapas já existentes.
Roteamento por classificação de assunto (sem etapa do funil)
O roteamento por etapa do CRM (acima) pressupõe uma negociação com várias etapas visíveis no Kanban. Nem todo orquestrador se encaixa nisso: às vezes a negociação inteira cabe numa etapa só (triagem), mas o domínio do atendimento tem várias especialidades — e é o assunto da conversa, não o estado do negócio, que decide qual sub-agent deve responder.
Exemplo do workspace de demonstração Advocacia Pacheco (atuação previdenciária). O orquestrador só classifica e transfere — nunca responde ao contato — entre seis sub-agents, todos com a mesma persona Ana:
| Sub-agent | Assunto |
|---|---|
| Incapacidade | Auxílio-doença, invalidez, auxílio-acidente, majoração de 25% |
| Aposentadoria Contributiva | Idade, tempo de contribuição, aposentadoria especial, PCD, rural |
| Assistencial | BPC/LOAS idoso e BPC/LOAS deficiente |
| Família | Pensão por morte, licença-maternidade |
| Revisão | Revisão de aposentadoria já concedida |
| Acolhimento | Rota padrão quando o assunto não se identifica com nenhuma das cinco especialidades acima |
Regra de roteamento: a cada mensagem do lead, o orquestrador classifica de novo o assunto e transfere para o sub-agent correspondente — não existe estado persistido de "para qual especialista este lead já foi". Se o lead muda de assunto no meio da conversa, o próximo roteamento já reflete isso.
Atenção
Sub-agent nunca transfere direto para outro sub-agent. Só o orquestrador re-roteia, e sempre na mensagem seguinte do lead. Se um sub-agent pudesse transferir para outro diretamente, um par de especialistas mal configurados correria o risco de ficar se repassando a conversa em loop (A transfere para B, que devolve para A, e assim por diante). Ao desenhar um orquestrador com várias especialidades, mantenha essa regra: toda transferência passa pelo orquestrador, nunca de folha para folha.
Dica
Como as seis especialidades da Pacheco respondem sob a mesma persona (Ana), o contato nunca percebe a troca de atendente — não existe mensagem de transição do tipo "vou te passar para outra pessoa". Isso só funciona porque o orquestrador não fala com o contato: ele apenas classifica e transfere (mesmo princípio de Somente roteamento, acima). Se as várias especialidades do seu orquestrador tiverem personas diferentes entre si, avalie se faz sentido anunciar a troca — o silêncio só é natural quando a persona é única.
Custo e desempenho
Cada sub-agent acionado é mais uma chamada ao modelo, com seus próprios tokens. Num orquestrador LLM, toda mensagem passa primeiro pelo orquestrador (que decide) e depois pelo sub-agent (que responde): são pelo menos duas chamadas. Em Sequencial e Paralelo, todos os sub-agents rodam sempre. Use modelos menores nos sub-agents de tarefa simples e mantenha a cadeia curta.
Saiba mais
- Jornada do Lead — roteamento por etapa do funil
- Ferramentas do Agent — o que cada sub-agent pode usar
- Controle da IA no chat — como o badge mostra qual sub-agent respondeu
- Playground ao vivo — veja na trilha para quem o orquestrador transferiu