--- title: NamBoQA API emoji: 🏯 colorFrom: yellow colorTo: red sdk: docker app_port: 7860 pinned: false short_description: API hỏi–đáp du lịch và di sản văn hoá Nam Bộ --- # NamBoQA — back-end API FastAPI cho demo hệ hỏi–đáp du lịch và di sản văn hoá Nam Bộ. Pipeline giống hệt thực nghiệm trong bài: truy hồi Hybrid (BM25 + bi-encoder, α = 0,5) trên 2.638 đoạn văn của 1.000 địa điểm, sau đó đọc hiểu bằng XLM-R (extractive, 3 đoạn đầu) hoặc Gemini (generative, 5 đoạn đầu). Tập train/dev/test tính lại lúc khởi động bằng `chia_tap.py` (y hệt bộ thực nghiệm). | Endpoint | | |---|---| | `GET /health` | trạng thái các thành phần | | `GET /stats` | thống kê dữ liệu | | `GET /samples?n=6&type=factoid` | câu hỏi mẫu từ tập test | | `POST /ask` | `{"question": "...", "retriever": "hybrid", "reader": "generative", "top_k": 5}` | Tài liệu tương tác: `/docs`. Dữ liệu **không** nằm trong repo này mà được tải lúc khởi động từ một HF Dataset private (biến `DATA_REPO` + secret `HF_TOKEN`). Xem `DEPLOY.md` trong thư mục gốc.