Chamar outro agente
A etapa Chamar outro agente executa outro agente publicado e usa o resultado. É como você compõe automações sem duplicar lógica.
Escolher o alvo
O Studio lista os agentes que este agente pode chamar, com nome, descrição, versão exata, o que o agente pede de entrada e o que devolve.
O que não pode ser chamado aparece com o motivo, em vez de simplesmente sumir:
| Motivo | Significa |
|---|---|
| Sem versão ativa neste ambiente | O agente existe e não está ativo aqui |
| De outro ambiente | O alvo precisa estar no mesmo ambiente |
| O próprio agente | Chamar a si mesmo é recursão direta |
O alvo é sempre exato
Você aponta para uma versão ativa específica, nunca para "a mais recente". Publicar uma versão nova do agente chamado não muda sozinha o que este executa — o que acontece é a versão anterior deixar de estar ativa.
Isso é o que faz um fluxo composto continuar rodando exatamente o que foi testado.
Mapear a entrada
O painel mostra os campos que o agente chamado espera — com rótulo, tipo, obrigatoriedade e opções — e você liga cada um a um dado do fluxo atual. Nada de adivinhar nomes.
O que ele produz
O identificador da execução filha e o resultado que ela devolveu.
A execução filha é de primeira classe: tem linha do tempo própria, pode ser acompanhada, cancelada e auditada. Na linha do tempo do agente pai, ela aparece como um passo com link para a execução completa.
Proteções
| Proteção | Como funciona |
|---|---|
| Profundidade | A cadeia de agente-chamando-agente tem teto, declarado no agente e limitado pelo espaço (padrão 3) |
| Recursão | A cadeia real de chamadas é verificada; um ciclo A → B → A é barrado |
| Ambiente | A execução filha roda sempre no mesmo ambiente do pai |
| Fan-out | Uma execução não gera mais de 50 filhas — o mesmo teto do "Para cada item" |
Cadeia de responsabilidade
Na execução filha, "quem pediu" é registrado como a execução pai, não como uma pessoa. A cadeia inteira fica explícita na auditoria.
Quando usar em vez de repetir etapas
| Situação | Por quê |
|---|---|
| A mesma lógica aparece em vários agentes | Um agente só, chamado por todos |
| O tratamento de um item de lista é complexo | É o que a etapa "Para cada item" faz internamente |
| Times diferentes cuidam de partes diferentes | Cada um publica e versiona o seu |
Erros comuns
| Sintoma | Causa | O que fazer |
|---|---|---|
| O agente que quero não aparece | Não tem versão ativa neste ambiente | Ative-o no mesmo ambiente |
| Falha por profundidade excedida | A cadeia é mais longa que o teto | Reduza a cadeia ou revise o teto do agente |
| Falha por recursão | Um agente da cadeia chama alguém que já está nela | Refaça o desenho |
| A execução filha falhou | O problema está no agente chamado | Abra a execução filha pela linha do tempo |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.