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
metadata
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.