Módulo 3, Aula 1: Integração com OpenAI GPT

🔒 Usando Docker Secrets

# docker-compose.yml
version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    environment:
      - OPENAI_API_KEY_FILE=/run/secrets/openai_key
    secrets:
      - openai_key
      
secrets:
  openai_key:
    file: ./secrets/openai_api_key.txt

☁️ Usando Azure Key Vault

// Configuração para Azure
const { SecretClient } = require("@azure/keyvault-secrets");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();
const client = new SecretClient(vaultUrl, credential);

// Buscar chave de forma segura
const secret = await client.getSecret("openai-api-key");
const apiKey = secret.value;

🔐 Usando AWS Secrets Manager

// Configuração para AWS
const AWS = require('aws-sdk');
const secretsManager = new AWS.SecretsManager({
  region: 'us-east-1'
});

// Função para buscar secret
async function getOpenAIKey() {
  const params = {
    SecretId: 'prod/whatsapp-bot/openai-key'
  };
  
  const result = await secretsManager.getSecretValue(params).promise();
  return JSON.parse(result.SecretString).OPENAI_API_KEY;
}

🎯 Configurações Principais

{
  "model": "gpt-4-turbo-preview",
  "messages": [
    {
      "role": "system",
      "content": "Você é um assistente inteligente do WhatsApp. Características:
- Sempre responda em português brasileiro
- Seja conciso mas completo
- Use emojis quando apropriado
- Se não souber algo, admita honestamente
- Mantenha tom amigável e profissional"
    },
    {
      "role": "user",
      "content": "{{ $json.body.message.text.body }}"
    }
  ],
  "max_tokens": 500,
  "temperature": 0.7,
  "top_p": 0.9,
  "frequency_penalty": 0.1,
  "presence_penalty": 0.1
}

📤 Configuração Resposta WhatsApp

// Nó HTTP Request para enviar resposta
{
  "method": "POST",
  "url": "https://graph.facebook.com/v18.0/{{ $env.WHATSAPP_PHONE_ID }}/messages",
  "headers": {
    "Authorization": "Bearer {{ $env.WHATSAPP_ACCESS_TOKEN }}",
    "Content-Type": "application/json"
  },
  "body": {
    "messaging_product": "whatsapp",
    "to": "{{ $json.body.entry[0].changes[0].value.messages[0].from }}",
    "type": "text",
    "text": {
      "body": "{{ $('OpenAI').item.json.choices[0].message.content }}"
    }
  }
}

📊 Métricas de Avaliação

🧪 Processo de Teste

1. BASELINE: Crie prompt inicial
2. VARIAÇÕES: Desenvolva 2-3 versões alternativas
3. TESTE: 50 conversas com cada versão
4. MÉTRICAS: Colete dados de performance
5. ANÁLISE: Compare resultados objetivamente
6. ITERAÇÃO: Combine melhores elementos
7. VALIDAÇÃO: Teste versão otimizada

Exemplo de variações:
A) Tom formal vs informal
B) Pergunta direta vs indireta  
C) Foco em benefícios vs características

📥 Função de Recuperação

async function recuperarContexto(userId) {
  // Buscar dados do usuário
  const userData = await buscarUsuario(userId);
  
  // Buscar histórico conversacional
  const historico = await buscarHistorico(userId, { limit: 5 });
  
  // Buscar contexto de negócio
  const contextoBusiness = await buscarContextoNegocio();
  
  // Montar contexto otimizado
  const contexto = {
    usuario: {
      nome: userData.nome,
      perfil: userData.perfil,
      preferencias: userData.preferencias,
      ultima_compra: userData.ultima_compra
    },
    conversa: {
      historico: historico.map(msg => ({
        timestamp: msg.timestamp,
        role: msg.de_usuario ? 'user' : 'assistant',
        content: msg.mensagem,
        intent: msg.intencao_detectada
      })),
      topico_atual: extrairTopico(historico),
      tarefa_pendente: userData.tarefa_atual
    },
    negocio: {
      horario_funcionamento: contextoBusiness.horario,
      promocoes_ativas: contextoBusiness.promocoes,
      produtos_em_falta: contextoBusiness.estoque_baixo
    },
    situacional: {
      data_hora: new Date().toISOString(),
      dia_semana: new Date().getDay(),
      timezone: 'America/Sao_Paulo'
    }
  };
  
  return contexto;
}

🎯 Montagem do Prompt com Contexto

function montarPromptComContexto(contexto, novaMensagem) {
  const systemPrompt = `Você é um assistente especializado. Use o contexto fornecido para dar respostas personalizadas.

USUÁRIO:
- Nome: ${contexto.usuario.nome}
- Perfil: ${contexto.usuario.perfil}
- Última compra: ${contexto.usuario.ultima_compra}

CONVERSA ATUAL:
- Tópico: ${contexto.conversa.topico_atual}
- Tarefa pendente: ${contexto.conversa.tarefa_pendente}

HISTÓRICO RECENTE:
${contexto.conversa.historico.map(msg => 
  `${msg.role}: ${msg.content}`
).join('\n')}

CONTEXTO NEGÓCIO:
- Funcionamento: ${contexto.negocio.horario_funcionamento}
- Promoções: ${contexto.negocio.promocoes_ativas.join(', ')}

INSTRUÇÕES:
- Referencie o histórico quando relevante
- Use o nome do usuário quando apropriado
- Continue tarefas em andamento
- Sugira produtos baseado no perfil`;

  const messages = [
    { role: 'system', content: systemPrompt },
    { role: 'user', content: novaMensagem }
  ];
  
  return messages;
}

🗜️ Compressão Inteligente

function comprimirContexto(historico, limite = 2000) {
  // Priorizar mensagens mais importantes
  const mensagensOrdenadas = historico.sort((a, b) => {
    let scoreA = calcularImportancia(a);
    let scoreB = calcularImportancia(b);
    
    // Mensagens recentes têm prioridade
    const tempoA = new Date(a.timestamp).getTime();
    const tempoB = new Date(b.timestamp).getTime();
    
    if (Date.now() - tempoA < 300000) scoreA += 50; // 5 min
    if (Date.now() - tempoB < 300000) scoreB += 50;
    
    return scoreB - scoreA;
  });
  
  let contextoComprimido = '';
  let tokens = 0;
  
  for (const msg of mensagensOrdenadas) {
    const msgTokens = estimarTokens(msg.content);
    
    if (tokens + msgTokens > limite) {
      // Resumir mensagem se necessário
      if (msgTokens > 200) {
        const resumo = resumirMensagem(msg.content);
        contextoComprimido += `${msg.role}: ${resumo}\n`;
        tokens += estimarTokens(resumo);
      }
      continue;
    }
    
    contextoComprimido += `${msg.role}: ${msg.content}\n`;
    tokens += msgTokens;
  }
  
  return contextoComprimido;
}

function calcularImportancia(mensagem) {
  let score = 0;
  
  // Mensagens com informações importantes
  if (mensagem.content.includes('nome') || 
      mensagem.content.includes('email') ||
      mensagem.content.includes('telefone')) score += 100;
  
  // Decisões e confirmações  
  if (mensagem.content.includes('sim') || 
      mensagem.content.includes('comprar') ||
      mensagem.content.includes('confirmo')) score += 80;
  
  // Preferências e requisitos
  if (mensagem.content.includes('preciso') ||
      mensagem.content.includes('quero') ||
      mensagem.content.includes('gostaria')) score += 60;
  
  return score;
}

✂️ Prompt Minimalista

// Versão original (cara)
const promptLongo = `Você é um assistente especializado em vendas de produtos eletrônicos 
para a empresa TechStore. Você deve ser sempre cortês, profissional e prestativo. 
Sempre pergunte o nome do cliente e use durante a conversa. Quando o cliente demonstrar 
interesse em um produto, explique detalhadamente as características técnicas, 
benefícios e vantagens competitivas. Se o cliente tiver dúvidas sobre preços, 
apresente opções dentro do orçamento dele. Em caso de objeções, trate com empatia 
e ofereça alternativas. Sempre finalize com um call-to-action claro.`;

// Versão otimizada (barata)
const promptOtimizado = `Vendedor TechStore. Cordial, pergunta nome, explica produtos, 
trata objeções, fecha venda. Responda: nome do cliente + recomendação + próximo passo.`;

// Economia: 90 tokens → 25 tokens (72% redução)