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
Perguntas Frequentes
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