> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superagentes.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

> [!WARNING]
>
> 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:

1. Acesse o agente que deseja tornar público
2. Clique na aba **Configurações**
3. Na seção **Configurações Gerais**, nos três pontos, clique em segurança
4. Selecione a opção **Público**
5. Clique em **Salvar** para confirmar as alterações

> [!TIP]
>
> 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:

1. Faça login na sua conta do Super Agentes
2. Acesse o agente que deseja configurar
3. Clique na aba **Configurações**
4. Navegue até a seção **Subagentes**

## Configurando Subagentes

### Adicionando um Subagente

Para adicionar um subagente existente:

1. Na seção "Subagentes Disponíveis", localize o agente que deseja adicionar como subagente
2. Clique no card do agente para adicioná-lo
3. O agente será movido para a seção "Subagentes Selecionados"
4. Clique em **Salvar** para confirmar as alterações

> [!TIP]
>
> 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:

1. Clique no botão **Novo Subagente** na seção "Subagentes Disponíveis"
2. 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!)
3. Clique em **Criar**
4. O novo subagente aparecerá na lista de subagentes disponíveis
5. Clique no card do novo subagente para adicioná-lo
6. Clique em **Salvar** para confirmar as alterações

### Removendo um Subagente

Para remover um subagente da configuração:

1. Na seção "Subagentes Selecionados", clique no card do subagente que deseja remover
2. O subagente será movido de volta para a seção "Subagentes Disponíveis"
3. Clique em **Salvar** para confirmar as alterações

### Excluindo um Subagente

Para excluir permanentemente um subagente:

1. Na seção "Subagentes Disponíveis", localize o subagente que deseja excluir
2. Clique no ícone de três pontos (⋮) no canto do card
3. Selecione **Remover Subagente**
4. Confirme a exclusão na caixa de diálogo que aparece

> [!WARNING]
>
> 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

1. Acesse a aba **Estágios** do seu agente principal
2. Crie um novo estágio ou edite um existente
3. No campo **Objetivo** do estágio, defina claramente quando este estágio deve ser ativado
4. No campo **Instruções** do estágio, inclua instruções para chamar o subagente específico
5. 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

1. Acesse a aba **Instruções** do seu agente principal
2. Nas instruções gerais, inclua orientações sobre quando chamar cada subagente
3. 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."

> [!TIP]
>
> 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**:

1. Crie um agente de suporte principal
2. Crie um agente de vendas (SDR) separado
3. Adicione o agente de vendas como subagente do agente de suporte
4. Crie um estágio no agente de suporte para identificar interesse em upgrade
5. 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**:

1. Crie um agente de atendimento principal
2. Crie um agente de análise separado
3. Adicione o agente de análise como subagente do agente de atendimento
4. Crie um estágio no agente de atendimento para o final da conversa
5. 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**:

1. Crie um agente generalista principal
2. Crie agentes especialistas para cada área (técnico, financeiro, etc.)
3. Adicione os agentes especialistas como subagentes do agente generalista
4. 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](https://docs.superagentes.ai/agent/stages/stages.md)**: Use estágios para controlar quando os subagentes são acionados
* **[Ferramentas](https://docs.superagentes.ai/agent/tool/overview.md)**: Subagentes podem ter suas próprias ferramentas configuradas
* **[Conhecimentos](https://docs.superagentes.ai/datastore)**: Cada subagente pode acessar bases de conhecimento específicas
* **[Integrações](https://docs.superagentes.ai/agent/integration/overview.md)**: Subagentes podem ter suas próprias integrações com canais externos

## Solução de Problemas

> **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**
>
> **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**
>
> **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**
>
> **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?**
>
> 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?**
>
> 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)?**
>
> 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?**
>
> 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?**
>
> 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?**
>
> 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](https://docs.superagentes.ai/agent/stages/stages.md)**
>
> Use estágios para controlar quando os subagentes são acionados

> **[Adicionar Ferramentas](https://docs.superagentes.ai/agent/tool/overview.md)**
>
> Configure ferramentas específicas para cada subagente

> **[Conectar Conhecimentos](https://docs.superagentes.ai/datastore)**
>
> Adicione bases de conhecimento específicas para cada subagente

> **[Testar Integrações](https://docs.superagentes.ai/agent/integration/overview.md)**
>
> Teste seus subagentes em diferentes canais de comunicação


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.