IA que responde con tus propias preguntas frecuentes (RAG)

npm install @botmesh/core @botmesh/ai @anthropic-ai/sdk @botmesh/baileys

<!-- faq.md -->
# Preguntas frecuentes de Lámparas Lumen

## Envíos
Enviamos a todo el país. Los pedidos llegan en 2-3 días hábiles; el envío exprés llega al día hábil siguiente.

## Devoluciones
Puedes devolver cualquier lámpara en los 30 días siguientes a la entrega, sin usar y en su caja. El reembolso tarda 5 días hábiles.

## Pagos
Aceptamos tarjetas de crédito y débito, PayPal y transferencia bancaria.

## Garantía
Todas las lámparas tienen 2 años de garantía contra defectos de fabricación.

// bot.js
import { readFile } from 'node:fs/promises'
import { Bot, defineBot, isMainModule } from '@botmesh/core'
import { BaileysProvider } from '@botmesh/baileys'
import { aiPlugin } from '@botmesh/ai'

const STOP_WORDS = new Set(['que', 'los', 'las', 'del', 'con', 'para', 'por', 'una', 'cuanto', 'puedo', 'tarda', 'hay', 'sus'])
// Minúsculas y sin tildes, así "envío" y "envio" coinciden.
const words = (text) =>
  new Set(
    (text.toLowerCase().normalize('NFD').replace(/\p{Diacritic}/gu, '').match(/[a-z0-9]{3,}/g) ?? [])
      .filter((w) => !STOP_WORDS.has(w)),
  )

/**
 * Un retriever pequeño sobre un archivo Markdown: un pasaje por sección `## `, ordenado
 * por las palabras que comparte con la pregunta. El plugin solo necesita
 * `retrieve(query)`, así que una base de datos vectorial o una API de búsqueda encajan igual.
 */
function markdownRetriever(file) {
  let sections
  const load = async () => {
    sections ??= (await readFile(file, 'utf8'))
      .split(/^## /m)
      .slice(1)
      .map((part) => {
        const [title, ...body] = part.trim().split('\n')
        const text = body.join('\n').trim()
        return { title, text, words: words(`${title} ${text}`) }
      })
    return sections
  }
  return {
    warmup: async () => { await load() }, // aiPlugin lo llama al arrancar
    async retrieve(query, { topK = 2 } = {}) {
      const asked = words(query)
      return (await load())
        .map((s) => ({ ...s, score: [...asked].filter((w) => s.words.has(w)).length }))
        .filter((s) => s.score > 0)
        .sort((a, b) => b.score - a.score)
        .slice(0, topK)
        .map((s) => ({ text: s.text, citation: `faq.md › ${s.title}`, score: s.score }))
    },
  }
}

const PERSONA = [
  'Eres el asistente de soporte de Lámparas Lumen, una tienda online de lámparas.',
  'Responde solo con la información del contexto. Si no tiene la respuesta,',
  'di que no lo sabes y sugiere escribir a ayuda@lumen.example. Responde en una o dos frases.',
].join(' ')

const RAG = {
  retriever: markdownRetriever(new URL('./faq.md', import.meta.url)),
  topK: 2,              // menos pasajes, prompt más corto
  appendSources: true,  // añade "Fuentes: [1] faq.md › Envíos" a la respuesta
}

const createBot = defineBot((provider) => {
  const bot = new Bot({ provider, lang: 'es' })

  bot.plug(aiPlugin({
    provider: 'anthropic',
    apiKey: process.env.ANTHROPIC_API_KEY,
    model: 'claude-haiku-5-5',
    persona: PERSONA,
    maxTokens: 300,
    rag: RAG,
  }))

  return bot
})

export default createBot

// `node bot.js` conecta con WhatsApp; `npx botmesh dev bot.js` se salta este bloque.
if (isMainModule(import.meta)) {
  const bot = await createBot(new BaileysProvider({ session: 'faq-rag-bot' }))
  bot.on('ready', () => console.log('✅ Conectado'))
  await bot.start()
}

npx botmesh dev bot.js --env-file .env   # .env tiene la línea ANTHROPIC_API_KEY=sk-ant-...

user › ¿cuánto tarda el envío?
bot › Los pedidos llegan en 2-3 días hábiles, o al día hábil siguiente con envío exprés [1].

      Fuentes: [1] faq.md › Envíos
user › ¿venden ventiladores de escritorio?
bot › Lo siento, no lo sé. Escribe a ayuda@lumen.example, por favor.
user › ¿puedo devolver una lámpara a las dos semanas?
bot › Sí: puedes devolver una lámpara en los 30 días siguientes a la entrega, sin usar y en su caja [1].

      Fuentes: [1] faq.md › Devoluciones