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

# Agent Tools

> Configure agentes existentes como ferramentas para outros agentes

## Visão Geral

O **Agent Tools** permite que você utilize agentes já criados como ferramentas para outros agentes, criando uma arquitetura de **agentes especializados** que podem ser chamados conforme necessário. Esta funcionalidade oferece:

* **Reutilização de agentes** especializados em diferentes contextos
* **Modularização** de funcionalidades específicas
* **Orquestração inteligente** entre múltiplos agentes
* **Especialização** de tarefas por domínio de conhecimento

<Note>
  **Agentes como Ferramentas**: Qualquer agente criado na plataforma pode ser usado como ferramenta por outros agentes.
  Isso permite criar hierarquias e especializações funcionais.
</Note>

## Como Configurar Agent Tools

### Passo 1: Acessar Configurações do Agente

<AccordionGroup>
  <Accordion icon="gear" title="Navegar para configurações">
    1. Vá para a **tela de agentes** no dashboard
    2. Localize o agente que será o **"orquestrador"** (que usará outros agentes como ferramentas)
    3. Clique no ícone de **"Configurações"** (⚙️) no card do agente e em seguida em **"Editar"**
    4. Você será direcionado para a tela de configurações do agente
  </Accordion>

  <Accordion icon="wrench" title="Acessar seção Agent Tools">
    1. Na tela de configurações, localize a seção **"Agent Tools"**
    2. Clique em **"Add"** para adicionar agentes como ferramentas
    3. Você verá a lista de todos os agentes disponíveis na sua conta

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/agenttool01_option.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=577fa17553a894dafa3415bafaa3ac28" alt="Opção para Adicionar Agent Tools" width="1133" height="372" data-path="images/prints/agenttool01_option.png" />

    <Info>
      Apenas agentes ativos e funcionais aparecerão na lista de seleção.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 2: Selecionar Agentes

<AccordionGroup>
  <Accordion icon="list" title="Visualizar agentes disponíveis">
    Na tela de seleção, você verá todos os agentes criados em sua conta:

    **Informações exibidas:**

    * **Nome do agente** e descrição
    * **Tipo do agente** (LLM, Task, Workflow, etc.)
    * **Status** (ativo/inativo)
    * **Especialização** ou área de atuação

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/agenttool02_config.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=1b628829932c27314d87b6080a16fe8a" alt="Seleção de Agentes como Ferramentas" width="787" height="635" data-path="images/prints/agenttool02_config.png" />
  </Accordion>

  <Accordion icon="check" title="Selecionar agentes específicos">
    **Como selecionar:**

    1. **Marque os checkboxes** dos agentes que deseja usar como ferramentas
    2. **Considere a especialização** de cada agente
    3. **Evite redundâncias** - não selecione agentes com funções muito similares
    4. **Pense na hierarquia** - o agente principal deve orquestrar os especializados

    **Critérios de seleção:**

    * ✅ **Complementaridade** - agentes com especialidades diferentes
    * ✅ **Confiabilidade** - agentes já testados e funcionais
    * ✅ **Performance** - agentes com boa velocidade de resposta
    * ❌ **Evitar loops** - não selecionar o próprio agente

    <Tip>
      Selecione agentes que tenham especialidades complementares para maximizar a eficiência.
    </Tip>
  </Accordion>

  <Accordion icon="check" title="Confirmar seleção">
    1. **Revise os agentes selecionados**
    2. **Confirme que fazem sentido** para o contexto do agente principal
    3. Clique em **"Save"** ou **"Confirmar"**
    4. Os agentes selecionados estarão disponíveis como ferramentas

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/agenttool02_config.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=1b628829932c27314d87b6080a16fe8a" alt="Agentes Configurados como Ferramentas" width="787" height="635" data-path="images/prints/agenttool02_config.png" />
  </Accordion>
</AccordionGroup>

## Exemplos de Uso

### Agente de Atendimento com Especialistas

<AccordionGroup>
  <Accordion icon="headset" title="Cenário: Central de Atendimento">
    **Agente Principal:** Atendente Geral

    **Agentes como Ferramentas:**

    * 🛒 **Agente de Vendas** - Especialista em produtos e preços
    * 🔧 **Agente de Suporte Técnico** - Resolve problemas técnicos
    * 💰 **Agente Financeiro** - Questões de pagamento e faturamento
    * 📦 **Agente de Logística** - Rastreamento e entrega

    **Fluxo de trabalho:**

    ```
    Cliente: "Meu pedido não chegou e quero cancelar"

    Atendente Geral:
    1. Chama Agente de Logística → verifica status do pedido
    2. Chama Agente Financeiro → processa cancelamento
    3. Responde ao cliente com solução completa
    ```
  </Accordion>
</AccordionGroup>

### Agente de Pesquisa com Especialistas

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Cenário: Pesquisa Acadêmica">
    **Agente Principal:** Pesquisador Geral

    **Agentes como Ferramentas:**

    * 📊 **Agente de Análise de Dados** - Processa estatísticas
    * 📚 **Agente de Literatura** - Busca referências acadêmicas
    * 🧪 **Agente de Metodologia** - Sugere métodos de pesquisa
    * ✍️ **Agente de Redação** - Ajuda na escrita científica

    **Exemplo de uso:**

    ```
    Usuário: "Preciso pesquisar sobre IA na educação"

    Pesquisador Geral:
    1. Chama Agente de Literatura → busca papers relevantes
    2. Chama Agente de Análise → analisa tendências
    3. Chama Agente de Metodologia → sugere abordagem
    4. Compila relatório completo
    ```
  </Accordion>
</AccordionGroup>

### Agente de Desenvolvimento com Especialistas

<AccordionGroup>
  <Accordion icon="code" title="Cenário: Desenvolvimento de Software">
    **Agente Principal:** Arquiteto de Software

    **Agentes como Ferramentas:**

    * 🎨 **Agente Frontend** - Especialista em UI/UX
    * ⚙️ **Agente Backend** - APIs e banco de dados
    * 🧪 **Agente de Testes** - Estratégias de testing
    * 🚀 **Agente DevOps** - Deploy e infraestrutura

    **Fluxo colaborativo:**

    ```
    Usuário: "Quero criar um e-commerce"

    Arquiteto:
    1. Chama Agente Frontend → define interface
    2. Chama Agente Backend → planeja API
    3. Chama Agente DevOps → define infraestrutura
    4. Chama Agente de Testes → estratégia de QA
    5. Entrega arquitetura completa
    ```
  </Accordion>
</AccordionGroup>

## Boas Práticas

### Organização de Agentes

<AccordionGroup>
  <Accordion icon="sitemap" title="Estrutura hierárquica">
    **Princípios de organização:**

    **Agente Orquestrador (Principal):**

    * 🎯 **Visão geral** do problema
    * 🧠 **Inteligência de roteamento** para especialistas
    * 📋 **Consolidação** de respostas
    * 🎭 **Interface** com o usuário

    **Agentes Especialistas (Ferramentas):**

    * 🔬 **Foco específico** em uma área
    * ⚡ **Respostas rápidas** e precisas
    * 📚 **Conhecimento profundo** do domínio
    * 🎯 **Tarefas bem definidas**

    <Info>
      Mantenha uma hierarquia clara: um agente orquestrador e vários especialistas.
    </Info>
  </Accordion>

  <Accordion icon="lightbulb" title="Dicas de configuração">
    **Para o Agente Principal:**

    ```
    Instructions: "Você é um orquestrador inteligente. 
    Analise a solicitação do usuário e determine qual 
    agente especialista deve ser chamado. Você tem acesso a:
    - Agente de Vendas (produtos e preços)
    - Agente Técnico (suporte e problemas)
    - Agente Financeiro (pagamentos)

    Sempre consolide as respostas dos especialistas 
    em uma resposta única e coerente para o usuário."
    ```

    **Para Agentes Especialistas:**

    ```
    Instructions: "Você é um especialista em [ÁREA]. 
    Responda apenas questões relacionadas ao seu domínio. 
    Seja preciso, direto e técnico. Se a pergunta não 
    for da sua área, informe que não é sua especialidade."
    ```
  </Accordion>
</AccordionGroup>

### Performance e Eficiência

<AccordionGroup>
  <Accordion icon="gauge" title="Otimização de performance">
    **Estratégias de otimização:**

    * ⚡ **Limite o número** de agentes-ferramenta (máximo 5-7)
    * 🎯 **Especialize bem** cada agente para evitar sobreposição
    * 📊 **Monitore latência** das chamadas entre agentes
    * 💰 **Considere custos** de múltiplas chamadas de API
    * 🔄 **Evite loops** infinitos entre agentes

    <Warning>
      Muitos agentes-ferramenta podem aumentar significativamente o tempo de resposta e custos.
    </Warning>
  </Accordion>

  <Accordion icon="chart-line" title="Monitoramento">
    **Métricas importantes:**

    * 📈 **Taxa de uso** de cada agente-ferramenta
    * ⏱️ **Tempo médio** de resposta
    * 💸 **Custo por interação** completa
    * ✅ **Taxa de sucesso** das chamadas
    * 🔄 **Frequência de uso** de cada especialista

    <Tip>
      Use analytics para identificar agentes subutilizados e otimizar a configuração.
    </Tip>
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Agente-ferramenta não responde:**

    * Verifique se o agente especialista está ativo
    * Confirme se tem créditos de API disponíveis
    * Teste o agente individualmente primeiro
    * Verifique logs de erro no dashboard

    **Respostas inconsistentes:**

    * Revise as instruções do agente orquestrador
    * Melhore a especialização dos agentes-ferramenta
    * Evite sobreposição de responsabilidades
    * Teste cenários específicos isoladamente

    **Performance lenta:**

    * Reduza o número de agentes-ferramenta
    * Otimize as instruções para chamadas mais diretas
    * Considere usar modelos mais rápidos
    * Monitore gargalos na comunicação

    **Custos elevados:**

    * Analise padrões de uso dos agentes
    * Otimize instruções para reduzir chamadas desnecessárias
    * Considere modelos mais econômicos para tarefas simples
    * Implemente cache para respostas frequentes
  </Accordion>
</AccordionGroup>

***

🤖 **Agent Tools configurado!** Agora você pode criar arquiteturas complexas de agentes especializados trabalhando em conjunto para resolver problemas de forma mais eficiente!