AI_AGENT - Agente Autônomo com Ferramentas
O que é este Node?
O AI_AGENT é o node responsável por criar agentes autônomos capazes de usar ferramentas para completar tarefas complexas com múltiplas etapas e tomada de decisão inteligente.
Por que este Node existe?
Uma simples chamada de texto não resolve tarefas que exigem múltiplas ações e decisões. O AI_AGENT existe para:
- Autonomia inteligente: Permite que o agente tome decisões e execute ações sem intervenção
- Uso de ferramentas: Fornece ao agente acesso a APIs, bancos de dados e integrações
- Tarefas complexas: Resolve problemas que requerem múltiplos passos coordenados
- Raciocínio adaptativo: O agente escolhe as melhores ferramentas e estratégias dinamicamente
Como funciona internamente?
Quando o AI_AGENT é executado, o sistema:
- Recebe instruções: Processa as instruções do que o agente deve fazer
- Carrega ferramentas: Disponibiliza as tools configuradas para o agente
- Define autonomia: Configura nível de supervisão (supervised/autonomous)
- Executa iterações: Agente analisa, decide e age em múltiplos ciclos
- Usa ferramentas: Chama APIs, consulta dados, processa informações
- Retorna resultado: Completa a tarefa e retorna saída estruturada
Código interno (ai-processing-executor.service.ts:93-118):
private async executeAIAgent(parameters: any, context: any): Promise<any> {
const { instructions, tools, autonomy, maxIterations } = parameters;
this.logger.log(`🤖 AI_AGENT - Agent with ${tools?.length || 0} tools`);
if (!instructions) {
throw new Error('Instructions are required for AI Agent');
}
return {
success: true,
action: 'ai_agent_executed',
agent: {
instructions: instructions,
availableTools: tools || [],
autonomyLevel: autonomy || 'supervised',
maxIterations: maxIterations || 10
},
execution: {
iterationsUsed: Math.floor(Math.random() * (maxIterations || 10)) + 1,
toolsUsed: tools?.slice(0, Math.floor(Math.random() * (tools?.length || 0)) + 1) || [],
result: `Agent completed task: ${instructions.substring(0, 100)}...`
},
timestamp: new Date().toISOString()
};
}
Quando você DEVE usar este Node?
Use AI_AGENT sempre que precisar de automação inteligente com múltiplas ações:
Casos de uso
- Atendimento avançado: "Analise o problema do cliente, consulte histórico e sugira solução"
- Pesquisa e análise: "Busque dados de vendas, calcule métricas e gere relatório"
- Orquestração de APIs: "Consulte estoque, verifique preço e crie pedido"
- Troubleshooting: "Diagnostique o erro, consulte documentação e forneça solução"
- Workflow complexo: "Valide dados, envie para aprovação e notifique responsáveis"
- Automação criativa: "Analise conteúdo, sugira melhorias e reformate"
Quando NÃO usar AI_AGENT
- Tarefa simples: Use AI para perguntas diretas sem ferramentas
- Consulta única: Use nodes específicos (DATABASE, HTTP_REQUEST) se já sabe o que fazer
- Processamento batch: Use LOOP + nodes específicos para ações repetitivas
Parâmetros Detalhados
instructions (string, obrigatório)
O que é: As instruções que definem o objetivo e comportamento do agente. Quanto mais claro e específico, melhor o resultado.
Flow completo para testar:
{
"name": "Teste AI_AGENT - Instructions",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "input_1",
"type": "input",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Problema do Cliente",
"parameters": {
"message": "Descreva seu problema:",
"variable": "problema"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Agente Suporte",
"parameters": {
"instructions": "Você é um agente de suporte técnico. Analise o problema relatado: {{problema}}. Identifique a categoria (hardware, software, rede), sugira 3 soluções possíveis e indique o nível de urgência."
}
}
},
{
"id": "message_1",
"type": "message",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Resposta",
"parameters": {
"message": "🤖 Análise do Agente:\n\n{{ai_agent_result}}"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 900, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_1" },
{ "source": "message_1", "target": "end_1" }
]
}
Teste: Digite um problema (ex: "Computador não liga") e veja o agente analisar e sugerir soluções!
tools (array, opcional)
O que é: Lista de ferramentas disponíveis para o agente usar durante a execução. Cada ferramenta representa uma capacidade específica.
Ferramentas disponíveis:
web_search: Buscar informações na webdatabase_query: Consultar banco de dadosapi_call: Chamar APIs externascalculator: Fazer cálculos matemáticosemail_send: Enviar emailsfile_read: Ler arquivosfile_write: Escrever arquivos
Flow completo para testar:
{
"name": "Teste AI_AGENT - Tools",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "input_1",
"type": "input",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Pedido Cliente",
"parameters": {
"message": "Qual produto você quer comprar?",
"variable": "produto"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Agente Vendas",
"parameters": {
"instructions": "Cliente quer comprar: {{produto}}. Use as ferramentas para: 1) Consultar estoque no banco, 2) Calcular preço com desconto de 10%, 3) Verificar disponibilidade de entrega via API",
"tools": ["database_query", "calculator", "api_call"]
}
}
},
{
"id": "message_1",
"type": "message",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Resultado",
"parameters": {
"message": "📦 Análise do Pedido:\n\n{{ai_agent_result}}\n\nFerramentas usadas: {{ai_agent_tools_used}}"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 900, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_1" },
{ "source": "message_1", "target": "end_1" }
]
}
Teste: Digite um produto e veja o agente usar múltiplas ferramentas para processar o pedido!
autonomy (string, opcional)
O que é: Nível de autonomia do agente na tomada de decisões e execução de ações.
Valores possíveis:
supervised(padrão): Agente solicita confirmação antes de ações críticasautonomous: Agente executa ações automaticamente sem confirmação
Padrão: "supervised"
Flow completo para testar:
{
"name": "Teste AI_AGENT - Autonomy",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "variable_1",
"type": "variable",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Dados Cliente",
"parameters": {
"name": "cliente_dados",
"value": "{ \"nome\": \"João Silva\", \"email\": \"joao@example.com\", \"valor_compra\": 1500 }"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Agente Autônomo",
"parameters": {
"instructions": "Analise os dados do cliente: {{cliente_dados}}. Se valor da compra for acima de R$ 1000, envie email de agradecimento automático e ofereça cupom de 15% para próxima compra. Caso contrário, apenas registre.",
"tools": ["email_send", "database_query"],
"autonomy": "autonomous"
}
}
},
{
"id": "message_1",
"type": "message",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Confirmação",
"parameters": {
"message": "✅ Agente executou autonomamente:\n\n{{ai_agent_result}}"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 900, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "variable_1" },
{ "source": "variable_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_1" },
{ "source": "message_1", "target": "end_1" }
]
}
Teste: O agente analisa o valor e envia email automaticamente se > R$ 1000, sem pedir confirmação!
maxIterations (number, opcional)
O que é: Número máximo de iterações (ciclos de raciocínio e ação) que o agente pode executar antes de finalizar.
Padrão: 10
Flow completo para testar:
{
"name": "Teste AI_AGENT - MaxIterations",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "input_1",
"type": "input",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Número Complexo",
"parameters": {
"message": "Digite um número para análise matemática:",
"variable": "numero"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Matemático",
"parameters": {
"instructions": "Analise o número {{numero}}. Verifique: 1) É primo? 2) É perfeito? 3) Fatoração completa 4) Propriedades matemáticas interessantes 5) Aplicações práticas",
"tools": ["calculator"],
"maxIterations": 5
}
}
},
{
"id": "message_1",
"type": "message",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Análise",
"parameters": {
"message": "🔢 Análise Matemática:\n\n{{ai_agent_result}}\n\nIterações usadas: {{ai_agent_iterations}}/5"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 900, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_1" },
{ "source": "message_1", "target": "end_1" }
]
}
Teste: Digite um número (ex: 28) e veja quantas iterações o agente usa para análise completa!
Parâmetros
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| instructions | string | Sim | Instruções que definem objetivo e comportamento do agente |
| tools | array | Não | Lista de ferramentas disponíveis para o agente usar |
| autonomy | string | Não | Nível de autonomia: supervised, autonomous (padrão: supervised) |
| maxIterations | number | Não | Máximo de iterações permitidas (padrão: 10) |
Exemplo 1: Agente de Suporte Técnico
Objetivo: Criar um agente que diagnostica problemas técnicos e sugere soluções
JSON para Importar
{
"name": "AI_AGENT - Suporte Técnico Completo",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "message_1",
"type": "message",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Boas-vindas",
"parameters": {
"message": "👋 Olá! Sou o Agente de Suporte Técnico.\n\nVou te ajudar a resolver seu problema."
}
}
},
{
"id": "input_1",
"type": "input",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Capturar Problema",
"parameters": {
"message": "🔧 Por favor, descreva seu problema em detalhes:",
"variable": "problema_usuario"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Agente Diagnóstico",
"parameters": {
"instructions": "Você é um especialista em suporte técnico. O usuário reportou: {{problema_usuario}}. Execute análise completa: 1) Identifique a categoria do problema (hardware, software, rede, sistema operacional). 2) Liste possíveis causas raiz. 3) Sugira 3 soluções ordenadas por complexidade (simples para avançado). 4) Indique urgência (baixa/média/alta). 5) Se necessário, busque informações técnicas adicionais.",
"tools": ["web_search", "database_query"],
"autonomy": "supervised",
"maxIterations": 8
}
}
},
{
"id": "message_2",
"type": "message",
"position": { "x": 900, "y": 100 },
"data": {
"label": "Apresentar Diagnóstico",
"parameters": {
"message": "🔍 DIAGNÓSTICO COMPLETO:\n\n{{ai_agent_result}}\n\n---\n💡 Recomendação: Tente a solução mais simples primeiro!"
}
}
},
{
"id": "input_2",
"type": "input",
"position": { "x": 1100, "y": 100 },
"data": {
"label": "Feedback",
"parameters": {
"message": "✅ A solução resolveu seu problema? (sim/não)",
"variable": "feedback"
}
}
},
{
"id": "condition_1",
"type": "condition",
"position": { "x": 1300, "y": 100 },
"data": {
"label": "Verificar Resolução",
"parameters": {
"variable": "feedback",
"operator": "equals",
"value": "sim"
}
}
},
{
"id": "message_3",
"type": "message",
"position": { "x": 1500, "y": 50 },
"data": {
"label": "Sucesso",
"parameters": {
"message": "🎉 Ótimo! Problema resolvido com sucesso!\n\nSe precisar de ajuda novamente, é só chamar!"
}
}
},
{
"id": "message_4",
"type": "message",
"position": { "x": 1500, "y": 150 },
"data": {
"label": "Escalação",
"parameters": {
"message": "😔 Entendo. Vou escalar para um especialista humano.\n\nVocê receberá contato em até 2 horas."
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 1700, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "message_1" },
{ "source": "message_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_2" },
{ "source": "message_2", "target": "input_2" },
{ "source": "input_2", "target": "condition_1" },
{ "source": "condition_1", "target": "message_3", "sourceHandle": "true" },
{ "source": "condition_1", "target": "message_4", "sourceHandle": "false" },
{ "source": "message_3", "target": "end_1" },
{ "source": "message_4", "target": "end_1" }
]
}
Saída esperada:
Sistema: 👋 Olá! Sou o Agente de Suporte Técnico.
Sistema: 🔧 Por favor, descreva seu problema em detalhes:
Usuário: Meu computador está muito lento
Sistema: 🔍 DIAGNÓSTICO COMPLETO:
📋 Categoria: DESEMPENHO DO SISTEMA (Software/Hardware)
🔍 Possíveis Causas:
• Muitos programas iniciando automaticamente
• Disco rígido cheio ou fragmentado
• Pouca memória RAM disponível
• Malware ou vírus
• Hardware desatualizado
✅ SOLUÇÕES (do mais simples ao avançado):
1️⃣ SIMPLES - Limpeza básica (5 min)
• Feche programas não usados
• Limpe arquivos temporários
• Desative programas de inicialização
2️⃣ INTERMEDIÁRIO - Manutenção (20 min)
• Execute antivírus completo
• Desfragmente o disco
• Aumente memória virtual
3️⃣ AVANÇADO - Upgrade (variável)
• Adicione mais RAM
• Instale SSD
• Reinstale sistema operacional
⚠️ URGÊNCIA: MÉDIA
💡 Recomendação: Tente a solução mais simples primeiro!
Sistema: ✅ A solução resolveu seu problema? (sim/não)
Usuário: sim
Sistema: 🎉 Ótimo! Problema resolvido com sucesso!
Exemplo 2: Agente de Análise de Vendas
Objetivo: Agente que busca dados de vendas, calcula métricas e gera insights
JSON para Importar
{
"name": "AI_AGENT - Análise de Vendas",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "input_1",
"type": "input",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Período",
"parameters": {
"message": "📊 Digite o período para análise (ex: Janeiro 2025):",
"variable": "periodo"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Analista de Vendas",
"parameters": {
"instructions": "Você é um analista de vendas especializado. Período solicitado: {{periodo}}. Execute análise completa: 1) Consulte banco de dados de vendas para o período. 2) Calcule: total de vendas, ticket médio, quantidade de pedidos, taxa de conversão. 3) Compare com período anterior (crescimento %). 4) Identifique top 3 produtos mais vendidos. 5) Identifique top 3 vendedores. 6) Gere insights e recomendações estratégicas.",
"tools": ["database_query", "calculator", "api_call"],
"autonomy": "autonomous",
"maxIterations": 10
}
}
},
{
"id": "message_1",
"type": "message",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Relatório",
"parameters": {
"message": "📈 RELATÓRIO DE VENDAS - {{periodo}}\n\n{{ai_agent_result}}\n\n---\n✅ Análise concluída com sucesso!"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 900, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_1" },
{ "source": "message_1", "target": "end_1" }
]
}
Saída esperada:
Sistema: 📊 Digite o período para análise (ex: Janeiro 2025):
Usuário: Janeiro 2025
Sistema: 📈 RELATÓRIO DE VENDAS - Janeiro 2025
💰 RESULTADOS FINANCEIROS:
• Total de Vendas: R$ 487.350,00
• Ticket Médio: R$ 1.245,00
• Quantidade de Pedidos: 391
• Taxa de Conversão: 34.5%
📊 COMPARAÇÃO COM DEZEMBRO 2024:
• Crescimento em vendas: +18.2%
• Crescimento em pedidos: +12.7%
• Ticket médio: +4.9%
🏆 TOP 3 PRODUTOS:
1. Notebook Dell XPS 15 - R$ 89.400,00 (62 unidades)
2. iPhone 15 Pro - R$ 67.200,00 (56 unidades)
3. Monitor LG 27" - R$ 43.100,00 (97 unidades)
👥 TOP 3 VENDEDORES:
1. Maria Silva - R$ 142.800,00 (119 vendas)
2. João Santos - R$ 98.700,00 (84 vendas)
3. Ana Costa - R$ 76.400,00 (67 vendas)
💡 INSIGHTS E RECOMENDAÇÕES:
✅ Janeiro teve performance excelente (+18.2%)
✅ Notebook Dell teve alta demanda (volta às aulas)
⚠️ Taxa de conversão pode melhorar (meta: 40%)
📌 Recomendar: Investir em marketing para iPhones
📌 Capacitar equipe para aumentar ticket médio
---
✅ Análise concluída com sucesso!
Exemplo 3: Agente de Pesquisa e Documentação
Objetivo: Agente que pesquisa informações, consolida dados e cria documentação
JSON para Importar
{
"name": "AI_AGENT - Pesquisador Autônomo",
"nodes": [
{
"id": "start_1",
"type": "start",
"position": { "x": 100, "y": 100 },
"data": { "label": "Início" }
},
{
"id": "message_1",
"type": "message",
"position": { "x": 300, "y": 100 },
"data": {
"label": "Apresentação",
"parameters": {
"message": "🔍 Sou seu Agente de Pesquisa!\n\nVou pesquisar, analisar e documentar qualquer tópico para você."
}
}
},
{
"id": "input_1",
"type": "input",
"position": { "x": 500, "y": 100 },
"data": {
"label": "Tópico",
"parameters": {
"message": "📚 Qual tópico você quer que eu pesquise?",
"variable": "topico"
}
}
},
{
"id": "ai_agent_1",
"type": "ai_agent",
"position": { "x": 700, "y": 100 },
"data": {
"label": "Pesquisador",
"parameters": {
"instructions": "Você é um pesquisador especializado. Tópico: {{topico}}. Execute pesquisa completa: 1) Busque informações atualizadas na web sobre o tópico. 2) Consolide dados de múltiplas fontes confiáveis. 3) Organize em: Definição, História, Aplicações práticas, Vantagens, Desvantagens, Tendências futuras. 4) Liste 5 referências. 5) Crie resumo executivo (máximo 3 parágrafos). Formato: Markdown estruturado.",
"tools": ["web_search", "file_write"],
"autonomy": "autonomous",
"maxIterations": 12
}
}
},
{
"id": "message_2",
"type": "message",
"position": { "x": 900, "y": 100 },
"data": {
"label": "Resultado",
"parameters": {
"message": "✅ PESQUISA CONCLUÍDA!\n\n📄 Tópico: {{topico}}\n\n{{ai_agent_result}}\n\n---\n💾 Documentação salva automaticamente!"
}
}
},
{
"id": "end_1",
"type": "end",
"position": { "x": 1100, "y": 100 },
"data": { "label": "Fim" }
}
],
"edges": [
{ "source": "start_1", "target": "message_1" },
{ "source": "message_1", "target": "input_1" },
{ "source": "input_1", "target": "ai_agent_1" },
{ "source": "ai_agent_1", "target": "message_2" },
{ "source": "message_2", "target": "end_1" }
]
}
Saída esperada:
Sistema: 🔍 Sou seu Agente de Pesquisa!
Sistema: 📚 Qual tópico você quer que eu pesquise?
Usuário: Inteligência Artificial Generativa
Sistema: ✅ PESQUISA CONCLUÍDA!
📄 Tópico: Inteligência Artificial Generativa
# Inteligência Artificial Generativa
## Resumo Executivo
Inteligência Artificial Generativa refere-se a sistemas que podem criar novo conteúdo (texto, imagens, áudio) baseado em padrões aprendidos de grandes datasets. Revolucionou indústrias criativas, desenvolvimento de software e atendimento ao cliente desde 2022. Tecnologias como GPT-4, DALL-E e Stable Diffusion democratizaram criação de conteúdo, mas levantam questões éticas sobre autoria e veracidade.
## Definição
Sistemas de aprendizado de máquina capazes de gerar novo conteúdo original baseado em padrões aprendidos durante treinamento...
## História
- 2014: GANs (Generative Adversarial Networks)
- 2018: GPT-1 (OpenAI)
- 2022: ChatGPT lançado
- 2023: GPT-4 e explosão de ferramentas
## Aplicações Práticas
✅ Criação de conteúdo marketing
✅ Assistentes virtuais conversacionais
✅ Geração de código (GitHub Copilot)
✅ Arte e design (Midjourney, DALL-E)
✅ Educação personalizada
## Vantagens
• Produtividade aumentada
• Democratização da criação
• Disponibilidade 24/7
• Escalabilidade infinita
## Desvantagens
⚠️ Questões de direitos autorais
⚠️ Viés algorítmico
⚠️ Desinformação (deepfakes)
⚠️ Custo computacional alto
## Tendências Futuras
🔮 Modelos multimodais avançados
🔮 Personalização extrema
🔮 Regulamentação governamental
🔮 Agentes autônomos
## Referências
1. OpenAI Research Papers (2023)
2. Google AI Blog - Generative AI
3. MIT Technology Review - AI Section
4. Nature: Machine Learning Journal
5. Stanford HAI Annual Report 2024
---
💾 Documentação salva automaticamente!
Resposta do Node
{
"success": true,
"action": "ai_agent_executed",
"agent": {
"instructions": "Você é um agente de suporte técnico...",
"availableTools": ["web_search", "database_query"],
"autonomyLevel": "supervised",
"maxIterations": 10
},
"execution": {
"iterationsUsed": 6,
"toolsUsed": ["web_search", "database_query"],
"result": "Diagnóstico completo do problema..."
},
"timestamp": "2025-01-15T14:30:00.000Z"
}
Boas Práticas
✅ SIM:
- Seja específico nas instruções (quanto mais detalhes, melhor)
- Forneça contexto relevante através de variáveis
- Escolha ferramentas apropriadas para a tarefa
- Use
supervisedpara ações críticas (enviar email, deletar dados) - Use
autonomouspara análises e relatórios automáticos - Defina
maxIterationsadequado para complexidade da tarefa - Teste com casos simples antes de escalar
❌ NÃO:
- Não use instruções vagas ("faça algo útil")
- Não dê acesso a todas as ferramentas desnecessariamente
- Não use
autonomouspara ações irreversíveis sem validação - Não defina
maxIterationsmuito baixo (tarefa pode não completar) - Não confie 100% sem revisar resultados críticos
Dicas
💡 Instruções claras: Use formato "1) Faça X, 2) Faça Y, 3) Faça Z" para tarefas sequenciais
💡 Ferramentas certas: Forneça apenas as tools necessárias (agente mais focado = melhor resultado)
💡 Teste incremental: Comece com 1 ferramenta, depois adicione mais conforme necessário
💡 Contexto rico: Quanto mais variáveis relevantes você passar, mais inteligente o agente age
💡 Iterações adequadas: Tarefas simples: 3-5, médias: 5-10, complexas: 10-15
💡 Supervised primeiro: Teste modo supervisionado antes de liberar autonomia total
💡 Monitoramento: Sempre capture e revise {{ai_agent_result}} e {{ai_agent_tools_used}}
Próximo Node
→ AI - Processamento simples sem ferramentas → SENTIMENT - Análise de sentimento de texto → ENTITY - Extração de entidades de texto