namboqa-api / README.md
phamluan's picture
NamBoQA API v2 (dữ liệu vòng 3)
7337389 verified
|
Raw History Blame Contribute Delete
1.19 kB
---
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.