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

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

Como Configurar Agent Tools

Passo 1: Acessar Configurações do Agente

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

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

Apenas agentes ativos e funcionais aparecerão na lista de seleção.

Passo 2: Selecionar Agentes

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

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

Selecione agentes que tenham especialidades complementares para maximizar a eficiência.

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

Exemplos de Uso

Agente de Atendimento com Especialistas

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

Agente de Pesquisa com Especialistas

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

Agente de Desenvolvimento com Especialistas

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

Boas Práticas

Organização de Agentes

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

Mantenha uma hierarquia clara: um agente orquestrador e vários especialistas.

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."

Performance e Eficiência

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

Muitos agentes-ferramenta podem aumentar significativamente o tempo de resposta e custos.

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

Use analytics para identificar agentes subutilizados e otimizar a configuração.

Solução de Problemas

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

---

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