🤖 Agente IA Dentro do Produto

🧱 Anatomia do system prompt

# PERSONA
Você é Sofia, atendente virtual da Clínica Vita.
Tom: caloroso, direto, brasileiro. Português coloquial mas educado.
Nunca diga "como IA" ou se refira a si como bot.

# OBJETIVO
Qualificar lead que chegou pelo WhatsApp em 3 informações:
1) Procedimento de interesse (ex: harmonização, botox, limpeza)
2) Convênio ou particular
3) Cidade / disponibilidade pra ir até a clínica

Após coletar as 3, chame `createDeal` e `scheduleCall`.

# FERRAMENTAS DISPONÍVEIS
- updateContact(name, email, tags): use ao saber dado novo
- createDeal(title, value, stage): após qualificar
- scheduleCall(datetime, contactId): após createDeal
- transferToHuman(reason): se cliente irritado, valor > 5k, ou loop

# RESTRIÇÕES
- NUNCA prometa preço exato. Diga "valor varia, a Dra. confirma na avaliação".
- NUNCA dê diagnóstico ou orientação médica.
- NUNCA invente horário sem chamar `scheduleCall`.
- Se o lead falar de dor aguda, transferToHuman imediatamente.

# FORMATO
- Resposta máx 2 frases curtas.
- 1 pergunta por vez. Não despeje 3 perguntas juntas.
- Emoji só se o cliente usar primeiro.
- Sempre confirme a próxima ação ("posso agendar amanhã 14h?").

🧅 Camadas do contexto enviado

async function buildContext(ctx, conversationId) {
  const conv = await ctx.db.get(conversationId);
  const contact = await ctx.db.get(conv.contactId);

  // últimas 10 mensagens em ordem cronológica
  const recent = await ctx.db
    .query("messages")
    .withIndex("by_conversation", q => q.eq("conversationId", conversationId))
    .order("desc")
    .take(10);

  // se a conversa tem > 30 mensagens, gera resumo do que vem antes
  const total = await ctx.db.query("messages")
    .withIndex("by_conversation", q => q.eq("conversationId", conversationId))
    .collect();

  let summary = "";
  if (total.length > 20) {
    summary = conv.summaryCache ?? await summarizeOldMessages(total.slice(0, -10));
  }

  return {
    contactProfile: {
      name: contact.name,
      tags: contact.tags,
      lastSeenAt: contact.lastSeenAt,
      knownDeals: await dealsByContact(ctx, contact._id),
    },
    summary,
    messages: recent.reverse().map(m => ({
      role: m.sender === "contact" ? "user" : "assistant",
      content: m.body,
    })),
  };
}

[
  {
    "name": "updateContact",
    "description": "Atualiza dados do contato quando descoberta nova informação.",
    "input_schema": {
      "type": "object",
      "properties": {
        "name":  { "type": "string", "description": "Nome completo se informado" },
        "email": { "type": "string", "format": "email" },
        "tags":  { "type": "array", "items": { "type": "string" } }
      }
    }
  },
  {
    "name": "createDeal",
    "description": "Cria oportunidade após qualificar lead com procedimento + convênio + cidade.",
    "input_schema": {
      "type": "object",
      "required": ["title", "stage", "estimatedValue"],
      "properties": {
        "title":          { "type": "string" },
        "stage":          { "type": "string", "enum": ["qualified", "proposal"] },
        "estimatedValue": { "type": "number", "minimum": 0 },
        "notes":          { "type": "string" }
      }
    }
  },
  {
    "name": "scheduleCall",
    "description": "Agenda call/avaliação. Use somente após cliente confirmar horário.",
    "input_schema": {
      "type": "object",
      "required": ["datetimeISO"],
      "properties": {
        "datetimeISO": { "type": "string", "format": "date-time" },
        "duration":    { "type": "integer", "default": 30 }
      }
    }
  },
  {
    "name": "transferToHuman",
    "description": "Transfere pra humano. Use em: irritação, valor > 5k, dor aguda, loop.",
    "input_schema": {
      "type": "object",
      "required": ["reason"],
      "properties": {
        "reason":  { "type": "string", "enum": ["angry","high_value","medical","loop","explicit_request"] },
        "summary": { "type": "string", "description": "Resumo de 1 frase pro humano" }
      }
    }
  }
]

🔄 Loop agentic dentro do Convex

while (true) {
  const res = await anthropic.messages.create({ model, system, tools, messages });
  if (res.stop_reason === "end_turn") {
    await sendMessage(instance, phone, { kind: "text", text: res.content[0].text });
    break;
  }
  // executa cada tool_use e devolve tool_result
  const toolUse = res.content.find(c => c.type === "tool_use");
  const result = await TOOLS[toolUse.name](ctx, toolUse.input);
  messages.push({ role: "assistant", content: res.content });
  messages.push({ role: "user", content: [{ type: "tool_result", tool_use_id: toolUse.id, content: JSON.stringify(result) }] });
  if (++loops > 6) { await transferToHuman("loop"); break; }
}

🚨 Gatilhos automáticos de escalada

🎬 UX da transição (mensagem que o cliente vê)

🧮 Custo unitário real (Claude Sonnet 4.6, 2026)

📋 O que logar a cada turno

🛡️ Direitos LGPD (titular = contato)