RAG là gì? Cho chatbot quán Mộc đọc đúng đoạn chính sách

# Chính sách của quán cà phê Mộc

## Giờ mở cửa và ngày lễ
Mộc mở cửa từ 6:30 đến 22:00 mỗi ngày. Dịp Tết Nguyên đán quán nghỉ từ 28 tháng Chạp đến hết mùng 3 và thông báo trên trang chủ trước một tuần. Các ngày lễ khác quán vẫn mở, nhưng đơn giao tận nơi có thể chậm hơn.

## Đặt hàng và thanh toán
Khách đặt hàng trên website hoặc nhắn tin cho quán. Quán nhận thanh toán bằng chuyển khoản, ví điện tử và tiền mặt khi nhận hàng. Đơn chuyển khoản được pha sau khi quán thấy tiền về tài khoản, thường mất dưới hai phút.

## Phí giao hàng
Mộc giao trong bán kính 5 km, phí 15.000đ. Đơn từ 150.000đ được miễn phí giao hàng. Ngoài 5 km quán không nhận giao, nhưng khách có thể tự đặt xe công nghệ đến lấy.

## Hủy đơn
Khách hủy đơn miễn phí khi đơn còn ở trạng thái "đã nhận". Khi đơn chuyển sang "đang pha chế", quán không hủy được vì nguyên liệu đã dùng. Đơn chuyển khoản hủy hợp lệ sẽ được hoàn lại đủ số tiền, theo mục Hoàn tiền.

## Đổi món khi giao sai hoặc pha sai
Nếu quán giao sai món hoặc pha sai so với đơn, khách nhắn trong vòng 30 phút kể từ lúc nhận, kèm ảnh món đã giao. Quán sẽ pha lại món đúng và giao lại miễn phí, hoặc hoàn tiền nếu khách không muốn đợi. Món đã uống quá một nửa thì quán không đổi.

## Hoàn tiền
Quán hoàn tiền trong ba ngày làm việc, về đúng phương thức khách đã thanh toán. Đơn tiền mặt được hoàn bằng chuyển khoản vào tài khoản khách cung cấp. Số tiền hoàn là giá món, phí giao hàng chỉ được hoàn khi lỗi do quán.

## Dị ứng và thành phần
Cà phê muối và bạc xỉu có sữa. Bánh mì trứng có gluten và trứng. Khách dị ứng cần ghi chú trong đơn, quán sẽ báo lại có làm được hay không. Quán dùng chung dụng cụ pha chế nên không thể đảm bảo tuyệt đối không lẫn thành phần.

## Khuyến mãi và mã giảm giá
Mỗi đơn dùng một mã giảm giá. Mã không cộng dồn với chương trình tích điểm trong cùng một đơn. Mã hết hạn không được gia hạn, và đơn đã thanh toán không được áp mã thêm.

## Tích điểm
Mỗi 10.000đ tích một điểm. Một trăm điểm đổi một đồ uống bất kỳ có giá đến 35.000đ. Điểm có hiệu lực mười hai tháng kể từ ngày tích. Đơn bị hoàn tiền sẽ bị trừ lại số điểm đã tích.

## Đặt số lượng lớn
Đơn từ 20 ly trở lên cần đặt trước một ngày, và quán sẽ báo giá riêng. Đơn lớn không áp mã giảm giá. Quán xác nhận bằng tin nhắn trước 17:00 ngày hôm trước.

## Voucher quà tặng
Voucher có giá trị từ 100.000đ, hạn dùng sáu tháng. Voucher không đổi thành tiền mặt và không hoàn lại sau khi bán. Một đơn dùng được nhiều voucher.

## Ly tự mang
Khách mang ly riêng được giảm 3.000đ cho mỗi đồ uống. Ly cần sạch và dung tích từ 350 ml. Quán có quyền từ chối ly có mùi hoặc bị nứt.

## Bảo mật thông tin khách
Quán chỉ dùng số điện thoại và địa chỉ để giao hàng và chăm sóc đơn. Quán không bán hay chia sẻ thông tin của khách cho bên thứ ba. Khách muốn xóa thông tin có thể nhắn cho quán.

## Liên hệ
Khách nhắn tin cho quán trong giờ mở cửa. Trường hợp khẩn như dị ứng sau khi uống, khách gọi hotline của quán ngay.

import { readFileSync } from "node:fs";

export type Doan = { tieuDe: string; noiDung: string };

// Tách tài liệu Markdown thành các đoạn: mỗi tiêu đề "## ..." mở một đoạn mới.
export function tachDoan(markdown: string): Doan[] {
  return markdown
    .split(/^## /m)
    .slice(1) // phần trước "## " đầu tiên chỉ là tiêu đề chung của tài liệu
    .map((khoi) => {
      const [tieuDe, ...dong] = khoi.split("\n");
      return { tieuDe: tieuDe.trim(), noiDung: dong.join("\n").trim() };
    });
}

export function docChinhSach(): Doan[] {
  return tachDoan(readFileSync(new URL("../chinh-sach.md", import.meta.url), "utf8"));
}

import type { Doan } from "./tach-doan.ts";

// Từ quá phổ biến, không giúp phân biệt đoạn này với đoạn khác.
const TU_BO_QUA = new Set(["và", "là", "của", "có", "cho", "được", "không", "thì", "mà", "em", "mình", "bạn", "ạ", "nhé", "này", "một", "khi", "nếu", "bị", "để", "với", "các", "những", "thế", "nào", "sao", "gì", "quán", "mộc"]);

export function tachTu(chu: string): string[] {
  return (chu.toLowerCase().match(/\p{L}+|\d+/gu) ?? []).filter((tu) => !TU_BO_QUA.has(tu));
}

export type KetQuaTim = { doan: Doan; diem: number; tuKhop: string[] };

// Chấm điểm bằng từ khóa: mỗi từ của câu hỏi có trong đoạn được cộng điểm,
// từ càng hiếm (ít đoạn chứa) càng nhiều điểm. Tiêu đề đoạn được tính cùng nội dung.
export function timDoan(cauHoi: string, cacDoan: Doan[], soDoan = 2): KetQuaTim[] {
  const tuCuaDoan = cacDoan.map((d) => new Set(tachTu(`${d.tieuDe} ${d.noiDung}`)));
  const tuCauHoi = [...new Set(tachTu(cauHoi))];
  const idf = (tu: string) => Math.log(1 + cacDoan.length / (1 + tuCuaDoan.filter((s) => s.has(tu)).length));

  return cacDoan
    .map((doan, i) => {
      const tuKhop = tuCauHoi.filter((tu) => tuCuaDoan[i].has(tu));
      return { doan, tuKhop, diem: Number(tuKhop.reduce((tong, tu) => tong + idf(tu), 0).toFixed(2)) };
    })
    .filter((kq) => kq.diem > 0)
    .sort((a, b) => b.diem - a.diem)
    .slice(0, soDoan);
}

// In ra các đoạn mà bộ tìm kiếm chọn cho từng câu hỏi, để xem nó đúng hay sai trước khi gọi mô hình.
import { docChinhSach } from "./tach-doan.ts";
import { timDoan } from "./tim-doan.ts";

const CAC_DOAN = docChinhSach();
console.log(`Tài liệu có ${CAC_DOAN.length} đoạn: ${CAC_DOAN.map((d) => d.tieuDe).join(" | ")}\n`);

const CAU_HOI = [
  "Đơn từ bao nhiêu tiền thì được miễn phí giao hàng?",
  "Quán giao sai món thì được hoàn tiền bao lâu?",
  "Em hủy đơn chuyển khoản rồi, bao lâu thì tiền về?",
  "Ly cà phê pha sai, em muốn quán đền tiền",
  "Mình bị dị ứng sữa thì uống gì được?",
];

for (const cau of CAU_HOI) {
  console.log(`Khách: ${cau}`);
  const kq = timDoan(cau, CAC_DOAN);
  if (kq.length === 0) console.log("  (không có đoạn nào khớp)");
  for (const { doan, diem, tuKhop } of kq) console.log(`  ${diem.toFixed(2)}  ${doan.tieuDe}   [khớp: ${tuKhop.join(", ")}]`);
  console.log();
}

Tài liệu có 14 đoạn: Giờ mở cửa và ngày lễ | Đặt hàng và thanh toán | Phí giao hàng | Hủy đơn | Đổi món khi giao sai hoặc pha sai | Hoàn tiền | Dị ứng và thành phần | Khuyến mãi và mã giảm giá | Tích điểm | Đặt số lượng lớn | Voucher quà tặng | Ly tự mang | Bảo mật thông tin khách | Liên hệ

Khách: Đơn từ bao nhiêu tiền thì được miễn phí giao hàng?
  7.12  Phí giao hàng   [khớp: đơn, từ, miễn, phí, giao, hàng]
  6.88  Đổi món khi giao sai hoặc pha sai   [khớp: đơn, từ, tiền, miễn, phí, giao]

Khách: Quán giao sai món thì được hoàn tiền bao lâu?
  7.32  Đổi món khi giao sai hoặc pha sai   [khớp: giao, sai, món, hoàn, tiền]
  5.24  Hoàn tiền   [khớp: giao, món, hoàn, tiền]

Khách: Em hủy đơn chuyển khoản rồi, bao lâu thì tiền về?
  6.92  Hủy đơn   [khớp: hủy, đơn, chuyển, khoản, tiền]
  6.57  Đặt hàng và thanh toán   [khớp: đơn, chuyển, khoản, tiền, về]

Khách: Ly cà phê pha sai, em muốn quán đền tiền
  6.25  Đổi món khi giao sai hoặc pha sai   [khớp: pha, sai, muốn, tiền]
  5.49  Dị ứng và thành phần   [khớp: cà, phê, pha]

Khách: Mình bị dị ứng sữa thì uống gì được?
  5.55  Dị ứng và thành phần   [khớp: dị, ứng, sữa]
  4.80  Liên hệ   [khớp: dị, ứng, uống]

import Anthropic from "@anthropic-ai/sdk";

import type { Doan } from "./tach-doan.ts";
import { tachTu } from "./tim-doan.ts";

export const MODEL = "claude-opus-5-5";

export const SYSTEM = `Bạn là nhân viên chăm sóc khách hàng của quán cà phê Mộc. Trả lời ngắn gọn, thân thiện, bằng tiếng Việt.
Chỉ trả lời dựa trên các đoạn trong thẻ <tai_lieu>. Cuối câu trả lời, ghi tên đoạn bạn đã dùng trong ngoặc vuông.
Nếu các đoạn không có thông tin để trả lời, hãy nói quán chưa có thông tin đó, đừng đoán.`;

// Ghép các đoạn tìm được vào tin nhắn của khách. Mỗi đoạn có tên để mô hình trích nguồn.
export function ghepCauHoi(cauHoi: string, cacDoan: Doan[]): string {
  const taiLieu = cacDoan.map((d) => `<doan ten="${d.tieuDe}">\n${d.noiDung}\n</doan>`).join("\n");
  return `<tai_lieu>\n${taiLieu}\n</tai_lieu>\n\nCâu hỏi của khách: ${cauHoi}`;
}

export function coKey(): boolean {
  return Boolean(process.env.ANTHROPIC_API_KEY) && process.env.MOC_OFFLINE !== "1";
}

export async function traLoi(cauHoi: string, cacDoan: Doan[]): Promise<string> {
  if (!coKey()) return moHinhOffline(cauHoi, cacDoan);
  const client = new Anthropic();
  const response = await client.messages.create({
    model: MODEL,
    max_tokens: 16000,
    output_config: { effort: "low" },
    system: SYSTEM,
    messages: [{ role: "user", content: ghepCauHoi(cauHoi, cacDoan) }],
  });
  return response.content.filter((b) => b.type === "text").map((b) => b.text).join("");
}

// Mô hình giả lập, không phải mô hình thật: chọn câu trong các đoạn có nhiều từ trùng nhất với câu hỏi
// và đọc lại nguyên văn. Nó chỉ dùng được chữ có trong đoạn, nên cho thấy rõ mô hình "nhìn thấy" gì.
function moHinhOffline(cauHoi: string, cacDoan: Doan[]): string {
  const tuHoi = new Set(tachTu(cauHoi));
  const cacCau = cacDoan.flatMap((d) =>
    d.noiDung.split(/(?<=\.)\s+/).map((cau) => ({ cau, ten: d.tieuDe, khop: tachTu(cau).filter((tu) => tuHoi.has(tu)).length })),
  );
  const tot = cacCau.filter((c) => c.khop >= 2).sort((a, b) => b.khop - a.khop).slice(0, 2);
  if (tot.length === 0) return "Dạ Mộc chưa có thông tin này ạ.";
  return `Dạ, ${tot.map((c) => c.cau).join(" ")} [${[...new Set(tot.map((c) => c.ten))].join("; ")}]`;
}

// RAG đầy đủ: tìm đoạn, ghép vào prompt, hỏi mô hình. So với việc gửi cả tài liệu ở mỗi lần gọi.
import { docChinhSach } from "./tach-doan.ts";
import { ghepCauHoi, traLoi } from "./tra-loi.ts";
import { timDoan } from "./tim-doan.ts";

const CAC_DOAN = docChinhSach();
const CAU_HOI = process.argv.slice(2).length ? [process.argv.slice(2).join(" ")] : [
  "Đơn từ bao nhiêu tiền thì được miễn phí giao hàng?",
  "Em hủy đơn chuyển khoản rồi, bao lâu thì tiền về?",
];

const kyTuCaTaiLieu = ghepCauHoi("", CAC_DOAN).length;
for (const cau of CAU_HOI) {
  const duocChon = timDoan(cau, CAC_DOAN).map((kq) => kq.doan);
  console.log(`Khách: ${cau}`);
  console.log(`  gửi kèm: ${duocChon.map((d) => d.tieuDe).join(" + ")}`);
  console.log(`  ${ghepCauHoi(cau, duocChon).length} ký tự (gửi cả tài liệu: ${kyTuCaTaiLieu} ký tự)`);
  console.log(`Mộc: ${await traLoi(cau, duocChon)}\n`);
}

Khách: Đơn từ bao nhiêu tiền thì được miễn phí giao hàng?
  gửi kèm: Phí giao hàng + Đổi món khi giao sai hoặc pha sai
  594 ký tự (gửi cả tài liệu: 3176 ký tự)
Mộc: Dạ, Đơn từ 150.000đ được miễn phí giao hàng. Nếu quán giao sai món hoặc pha sai so với đơn, khách nhắn trong vòng 30 phút kể từ lúc nhận, kèm ảnh món đã giao. [Phí giao hàng; Đổi món khi giao sai hoặc pha sai]

Khách: Em hủy đơn chuyển khoản rồi, bao lâu thì tiền về?
  gửi kèm: Hủy đơn + Đặt hàng và thanh toán
  600 ký tự (gửi cả tài liệu: 3176 ký tự)
Mộc: Dạ, Đơn chuyển khoản hủy hợp lệ sẽ được hoàn lại đủ số tiền, theo mục Hoàn tiền. Đơn chuyển khoản được pha sau khi quán thấy tiền về tài khoản, thường mất dưới hai phút. [Hủy đơn; Đặt hàng và thanh toán]

Khách: Ly cà phê pha sai, em muốn quán đền tiền
  gửi kèm: Đổi món khi giao sai hoặc pha sai + Dị ứng và thành phần
  652 ký tự (gửi cả tài liệu: 3176 ký tự)
Mộc: Dạ, Nếu quán giao sai món hoặc pha sai so với đơn, khách nhắn trong vòng 30 phút kể từ lúc nhận, kèm ảnh món đã giao. Quán sẽ pha lại món đúng và giao lại miễn phí, hoặc hoàn tiền nếu khách không muốn đợi. [Đổi món khi giao sai hoặc pha sai]