Bài toán

Tư vấn chọn khoa và gói khám ở quầy lễ tân bệnh viện mắc 4 rào cản: không riêng tư (ngại kể triệu chứng nơi đông người), dễ chọn gói sai (1–2 phút, hay phải đổi gói sau khi lấy số), phải đến tận nơi cho một nhu cầu thuần thông tin, và người cao tuổi/yếu gần như không tự xoay sở được. Hệ quả: thông tin đầu vào sai lệch ngay từ đầu, kéo theo sự tốn kém về thời gian, công sức, chi phí cho bệnh nhân và dồn tải cho lễ tân bệnh viện.

Giải pháp

Yên — agent hội thoại riêng tư (chữ hoặc thoại, cùng một Phiên) dẫn bệnh nhân qua Chốt khoa → Chốt gói → Đặt lịch → Phiếu số khám (QR). Ở bước Chốt khoa, Yên hỏi làm rõ triệu chứng theo khung OPQRST rồi dùng RAG để đề xuất đúng 2 chuyên khoa khác nhau kèm lý do + trích dẫn — không chẩn đoán bệnh. Guardrail xử lý các tình huống nhạy cảm (cấp cứu, jailbreak, off-topic) và luôn có lối thoát an toàn.

Kiến trúc kỹ thuật

• Orchestrator: LangGraph 3 tầng — guardrail → orchestrate_turn (điều phối sub-agent Clinical/Package/Appointment) → diễn đạt → respond.
• RAG chốt khoa: BM25 ∥ dense embedding → RRF → LLM rerank trên danh mục 28 chuyên khoa, corpus bền qua Postgres/pgvector.
• LLM: DeepSeek-V4-Flash (FPT) cho intake/intent, GLM-5.2 (OpenRouter) cho rerank, fallback OpenAI.
• Voice: kênh WebSocket riêng, STT gpt-4o-transcribe + TTS tts-1, đổi chữ ↔ thoại không mất tiến độ Phiên.
• Backend/Frontend: FastAPI (Python 3.11) + Next.js 16/React 19; state bền qua Redis (Phiên) + Postgres/pgvector (RAG).
• Observability: LangSmith trace toàn bộ lượt chat, correlation id — audit được từng quyết định của agent.
• STT: Speechmatics để chuyển giọng nói thành văn bản
• STT: Elevenlabs để chuyển văn bản thành giọng nói tự nhiên

Tính khả thi

Sản phẩm đang chạy thật, không phải concept: demo trực tuyến tại https://c3-t001.lopica.id.vn/, có bộ 78 file test tự động (agents/api/phiên/RAG), 5/7 kịch bản kiểm thử thủ công đạt (2 bug còn lại đã lên issue theo dõi công khai), và CI/CD tự động (Docker Hub → Render cho backend, Vercel cho frontend). Kiến trúc tách rời model/orchestration cho phép đổi LLM hoặc thêm sub-agent mà không viết lại quy trình nghiệp vụ.