Configurando e Utilizando Subagentes
Guia completo para criar, configurar e utilizar subagentes para expandir as capacidades dos seus agentes no Super Agentes
Visão Geral
Subagentes são agentes que podem ser chamados por outro agente durante uma conversa para lidar com tarefas ou situações específicas. Diferentemente dos estágios, que alteram o comportamento do mesmo agente, os subagentes permitem que você:
- Chame um agente completamente diferente em momentos específicos da conversa
- Aproveite agentes já configurados com suas próprias integrações e estágios
- Crie fluxos de conversação mais especializados e modulares
- Transfira o controle da conversa para outro agente quando necessário
Benefícios
Especialização
Crie agentes altamente especializados para tarefas específicas
Reutilização
Reutilize agentes existentes como componentes em fluxos mais complexos
Modularidade
Divida problemas complexos em módulos mais gerenciáveis
Escalabilidade
Expanda as capacidades do seu sistema sem reconfigurar agentes existentes
Diferença entre Estágios e Subagentes
Estágios | Subagentes |
---|---|
Alteram o comportamento do mesmo agente | Chamam um agente completamente diferente |
Úteis para mudanças de tom ou abordagem | Úteis quando você precisa de funcionalidades específicas de outro agente |
Configurados dentro do próprio agente | São agentes independentes que podem ser reutilizados |
Mantêm o contexto dentro do mesmo agente | Permitem transferir o contexto para outro agente especializado |
Requisitos para Subagentes
Para que um agente possa ser utilizado como subagente, ele deve estar marcado como público. Agentes privados não aparecem na lista de subagentes disponíveis.
Estágios
Configure os estágios do seu agente antes de torná-lo um subagente
Sub-agentes
Marque o agente como público para disponibilizá-lo como subagente
Tornando um Agente Público
Para marcar um agente como público e disponibilizá-lo como subagente:
- Acesse o agente que deseja tornar público
- Clique na aba Configurações
- Na seção Configurações Gerais, nos três pontos, clique em segurança
- Selecione a opção Público
- Clique em Salvar para confirmar as alterações
Agentes públicos podem ser utilizados como subagentes por qualquer outro agente no workspace, enquanto agentes privados ficam visíveis apenas para você.
Acessando a Configuração de Subagentes
Para acessar a tela de configuração de subagentes:
- Faça login na sua conta do Super Agentes
- Acesse o agente que deseja configurar
- Clique na aba Configurações
- Navegue até a seção Subagentes
Configurando Subagentes
Adicionando um Subagente
Para adicionar um subagente existente:
- Na seção “Subagentes Disponíveis”, localize o agente que deseja adicionar como subagente
- Clique no card do agente para adicioná-lo
- O agente será movido para a seção “Subagentes Selecionados”
- Clique em Salvar para confirmar as alterações
A descrição do subagente é muito importante, pois ela deve indicar claramente quando o subagente deve ser acionado. Esta informação será usada pelo agente principal para determinar quando chamar o subagente.
Criando um Novo Subagente
Para criar um novo subagente:
- Clique no botão Novo Subagente na seção “Subagentes Disponíveis”
- No modal que se abre, preencha:
- Nome do Subagente: Um nome claro e descritivo
- Descrição: Explique quando este subagente deve ser acionado (muito importante!)
- Clique em Criar
- O novo subagente aparecerá na lista de subagentes disponíveis
- Clique no card do novo subagente para adicioná-lo
- Clique em Salvar para confirmar as alterações
Removendo um Subagente
Para remover um subagente da configuração:
- Na seção “Subagentes Selecionados”, clique no card do subagente que deseja remover
- O subagente será movido de volta para a seção “Subagentes Disponíveis”
- Clique em Salvar para confirmar as alterações
Excluindo um Subagente
Para excluir permanentemente um subagente:
- Na seção “Subagentes Disponíveis”, localize o subagente que deseja excluir
- Clique no ícone de três pontos (⋮) no canto do card
- Selecione Remover Subagente
- Confirme a exclusão na caixa de diálogo que aparece
Excluir um subagente é uma ação permanente e removerá o subagente de todos os agentes que o utilizam. Certifique-se de que o subagente não está sendo usado em outros agentes antes de excluí-lo.
Configurando o Acionamento de Subagentes
Para configurar quando um subagente deve ser acionado, você tem duas opções:
Opção 1: Usando Estágios
- Acesse a aba Estágios do seu agente principal
- Crie um novo estágio ou edite um existente
- No campo Objetivo do estágio, defina claramente quando este estágio deve ser ativado
- No campo Instruções do estágio, inclua instruções para chamar o subagente específico
- Exemplo de instrução: “Quando o usuário demonstrar interesse em trocar de plano, chame o subagente SDR para dar continuidade à conversa”
Opção 2: Usando Instruções Gerais
- Acesse a aba Instruções do seu agente principal
- Nas instruções gerais, inclua orientações sobre quando chamar cada subagente
- Exemplo: “Se o usuário perguntar sobre preços ou planos, chame o subagente de vendas. Se o usuário tiver problemas técnicos, chame o subagente de suporte técnico.”
A descrição que você fornece ao criar o subagente é crucial, pois ela deve indicar claramente quando o subagente deve ser acionado. Certifique-se de que esta descrição seja específica e alinhada com as instruções ou estágios do agente principal.
Casos de Uso Práticos
Caso 1: Agente de Suporte com Encaminhamento para Vendas
Cenário: Um agente de suporte que identifica oportunidades de upgrade e passa a conversa para um agente de vendas.
Configuração:
- Crie um agente de suporte principal
- Crie um agente de vendas (SDR) separado
- Adicione o agente de vendas como subagente do agente de suporte
- Crie um estágio no agente de suporte para identificar interesse em upgrade
- Nas instruções desse estágio, configure o acionamento do subagente de vendas
Caso 2: Agente de Atendimento com Análise Pós-Atendimento
Cenário: Após finalizar um atendimento, um subagente de análise é chamado para avaliar a conversa e extrair insights.
Configuração:
- Crie um agente de atendimento principal
- Crie um agente de análise separado
- Adicione o agente de análise como subagente do agente de atendimento
- Crie um estágio no agente de atendimento para o final da conversa
- Nas instruções desse estágio, configure o acionamento do subagente de análise
Caso 3: Agente Generalista com Especialistas
Cenário: Um agente generalista que encaminha perguntas específicas para subagentes especialistas em diferentes áreas.
Configuração:
- Crie um agente generalista principal
- Crie agentes especialistas para cada área (técnico, financeiro, etc.)
- Adicione os agentes especialistas como subagentes do agente generalista
- Nas instruções gerais do agente principal, defina quando chamar cada especialista
Considerações Técnicas
- Cada subagente é uma ferramenta HTTP configurada automaticamente no agente principal
- A comunicação entre agentes é feita via API interna do Super Agentes
- O contexto da conversa é passado para o subagente quando ele é acionado
- O subagente pode ter seus próprios estágios e ferramentas
- É necessário ter pelo menos uma chave de API configurada no workspace para usar subagentes
Integrações com Outros Recursos
Os subagentes se integram com vários outros recursos da plataforma:
- Estágios de Conversação: Use estágios para controlar quando os subagentes são acionados
- Ferramentas: Subagentes podem ter suas próprias ferramentas configuradas
- Conhecimentos: Cada subagente pode acessar bases de conhecimento específicas
- Integrações: Subagentes podem ter suas próprias integrações com canais externos
Solução de Problemas
O subagente não está sendo acionado
O subagente não está sendo acionado
Possíveis causas e soluções:
- Verifique as instruções: Certifique-se de que as instruções para acionar o subagente estão claras
- Verifique a descrição: A descrição do subagente deve indicar claramente quando ele deve ser acionado
- Teste com exemplos diretos: Tente fazer perguntas que correspondam exatamente ao gatilho do subagente
O subagente está sendo acionado no momento errado
O subagente está sendo acionado no momento errado
Possíveis causas e soluções:
- Refine as instruções: Torne as instruções mais específicas sobre quando o subagente deve ser acionado
- Ajuste a descrição: Modifique a descrição do subagente para ser mais precisa
- Use estágios: Considere usar estágios para controlar melhor quando o subagente é acionado
Perda de contexto entre agentes
Perda de contexto entre agentes
Possíveis causas e soluções:
- Inclua contexto nas instruções: Certifique-se de que o agente principal está instruído a passar o contexto relevante
- Refine o prompt do subagente: Ajuste o prompt do subagente para solicitar e utilizar o contexto recebido
O agente não aparece na lista de subagentes disponíveis
O agente não aparece na lista de subagentes disponíveis
Possíveis causas e soluções:
- Verifique a visibilidade do agente: Certifique-se de que o agente está marcado como público nas configurações
- Verifique permissões: Confirme se você tem as permissões necessárias para acessar o agente
- Atualize a página: Em alguns casos, pode ser necessário atualizar a página para que as alterações de visibilidade sejam refletidas
Perguntas Frequentes
Posso usar o mesmo agente como subagente de múltiplos agentes?
Posso usar o mesmo agente como subagente de múltiplos agentes?
Sim, você pode adicionar o mesmo agente como subagente em quantos agentes principais desejar. Isso é especialmente útil para agentes especialistas que podem ser reutilizados em diferentes contextos.
Os subagentes têm acesso às mesmas ferramentas e integrações do agente principal?
Os subagentes têm acesso às mesmas ferramentas e integrações do agente principal?
Não, cada subagente tem suas próprias ferramentas e integrações configuradas separadamente. Isso permite que você crie subagentes altamente especializados com acesso apenas às ferramentas relevantes para sua função.
Posso criar uma cadeia de subagentes (um subagente chamando outro subagente)?
Posso criar uma cadeia de subagentes (um subagente chamando outro subagente)?
Sim, é possível criar cadeias de subagentes, mas é recomendável limitar a profundidade para evitar complexidade excessiva. Cada nível adicional de subagentes aumenta a complexidade do sistema e pode tornar o comportamento menos previsível.
Como o usuário percebe a mudança de um agente para um subagente?
Como o usuário percebe a mudança de um agente para um subagente?
A transição é transparente para o usuário. Ele continuará conversando normalmente, sem perceber que está interagindo com um agente diferente. Isso garante uma experiência de usuário fluida e natural.
Posso limitar quanto tempo um subagente permanece ativo na conversa?
Posso limitar quanto tempo um subagente permanece ativo na conversa?
Sim, você pode definir nas instruções do subagente quando ele deve devolver o controle para o agente principal. Por exemplo, você pode instruir o subagente a retornar o controle após resolver uma questão específica ou após um número determinado de interações.
Por que meu agente não aparece na lista de subagentes disponíveis?
Por que meu agente não aparece na lista de subagentes disponíveis?
O agente precisa estar marcado como público para aparecer na lista de subagentes disponíveis. Verifique as configurações de visibilidade do agente em Configurações nos três pontos ao lado de conversar e certifique-se de que ele está definido como público.
Próximos Passos
Após configurar seus subagentes, você pode:
Configurar Estágios
Use estágios para controlar quando os subagentes são acionados
Adicionar Ferramentas
Configure ferramentas específicas para cada subagente
Conectar Conhecimentos
Adicione bases de conhecimento específicas para cada subagente
Testar Integrações
Teste seus subagentes em diferentes canais de comunicação