Skip to content

Trợ lý AI ​

Trợ lý AI là hộp chat nổi trên website, giúp người dùng hỏi về việc làm, công ty và CV, nhận gợi ý việc làm phù hợp và lưu việc ngay trong cuộc trò chuyện. Trang dành cho người muốn biết trợ lý làm được gì, và developer sửa hộp chat.

Vì sao cần ​

Tìm việc bằng bộ lọc đòi hỏi người dùng biết mình cần gì. Hỏi bằng ngôn ngữ thường giúp ứng viên diễn đạt nhu cầu, còn nhà tuyển dụng có trợ lý riêng trong khu vực HR.

Đối tượng: người dùng đã đăng nhập. Khách mở hộp chat sẽ thấy nút mời đăng nhập, không gửi được tin.

Đánh đổi:

  • Mỗi người có hạn mức lượt hỏi theo ngày; hết hạn mức thì ô nhập bị vô hiệu cho tới thời điểm đặt lại.
  • Câu trả lời do AI sinh ra nên giao diện luôn hiện lời nhắc về độ chính xác.
  • Frontend không gọi nhà cung cấp AI trực tiếp: không có mã nào trong src gọi dịch vụ AI. Mọi tin nhắn đi qua backend.

Giao diện ​

Hộp chat mở từ nút nổi ở góc màn hình. Chưa có ảnh chụp riêng của hộp chat trong public/images/screenshots/.

Nơi hiệnThành phầnGhi chú
Trang công khai ((main)) và trang cá nhân ((profile))ChatWidgetMàn hình lớn: bảng cố định bên phải rộng 420 px. Màn hình nhỏ: ngăn kéo (Sheet)
Dashboard nhà tuyển dụng ((hr-dashboard))HrChatAssistantDùng cùng ChatSurface
Trang quản trị ((dashboard))Không cóLayout này không gắn trợ lý

ChatSurface là phần chat dùng chung: màn hình chào với các thẻ tính năng và câu hỏi gợi ý, danh sách tin nhắn, ô nhập, đồng hồ hạn mức và lời nhắc AI.

Luồng nghiệp vụ ​

Sơ đồ rút gọn; trình tự kỹ thuật xem Stream chat AI.

Chức năngHành vi
Câu hỏi gợi ýMàn hình chào có sáu câu gợi ý (việc làm, kỹ năng hot, công ty, CV, việc phù hợp, so sánh lương); trên trang chi tiết tin có thêm câu hỏi về tin đó
Ngữ cảnh tin đang xemTrên /jobs/<id>, mã tin được gửi kèm tin nhắn
Gợi ý tiếp theoSau mỗi câu trả lời có thể có các câu hỏi gợi ý; chọn một câu sẽ gửi kèm mã tin của trang
Thẻ việc làmHiện việc làm gợi ý; với mã chưa có dữ liệu, giao diện gọi GET /jobs/:id để bổ sung
Lưu việc qua chatPhản hồi có thể kèm hành động save_job chờ xác nhận; xác nhận thì gọi backend và đánh dấu việc đã lưu
Hạn mứcĐồng hồ hiện số lượt còn lại, hoặc nhãn "không giới hạn" khi gói không giới hạn; chỉ hiện sau khi backend đã gửi hạn mức; cảnh báo khi sắp hết hoặc hết; ô nhập bị vô hiệu cho tới giờ đặt lại
DừngKhi đang stream có nút dừng, giữ phần đã nhận
Lịch sửTải 50 tin gần nhất (page 1, limit 50) khi mở hộp chat đang trống; nút xóa lịch sử ở đầu hộp chat, hạn mức vẫn giữ nguyên sau khi xóa (theo test của slice)

WARNING

Trên trang chi tiết tin bên ngoài (/jobs/external/<id>), mã tin lấy từ đường dẫn sẽ là chuỗi external và được gửi lên backend, vốn yêu cầu mã hợp lệ; tin nhắn có thể bị từ chối. Chi tiết ở Endpoint Chat. Đây là suy luận từ code, chưa chạy thử.

API liên quan ​

Hook hoặc hàmEndpointDùng ở
sendStreamMessagePOST /chat/message/streamuse-stream-chat.ts
useSendMessageMutationPOST /chat/messageĐường dự phòng
useLazyGetChatHistoryQueryGET /chat/historyTải lịch sử
useClearChatHistoryMutationDELETE /chat/clearXóa lịch sử
useConfirmToolActionMutation, useCancelToolActionMutationPOST và DELETE /chat/tool-actions/:idXác nhận, hủy hành động

Bảng đầy đủ: Endpoint Chat.

Dữ liệu và kiểm tra ​

Dạng dữ liệu ở Model Chat Message. Frontend giới hạn tin nhắn tối đa 1000 ký tự, và bỏ qua tin trống.

Trường hợp lỗi ​

Tình huốngHành vi
Chưa đăng nhậpToast yêu cầu đăng nhập, không gửi
Vượt hạn mứcÔ nhập bị vô hiệu kèm lý do; thông tin hạn mức lấy từ phản hồi hoặc lỗi
Stream không dùng đượcTự chuyển sang đường gửi thường
Lỗi khácToast với thông điệp của backend
Hành động hết hạnGỡ khỏi tin nhắn và báo hết hạn
Không tải được lịch sửToast lỗi

Test cases ​

TestNội dung
src/features/chatbot/hooks/use-chat.test.tsxLưu hạn mức kèm lịch sử
src/features/chatbot/components/chat-surface/chat-surface.test.tsxLời nhắc AI; vô hiệu ô nhập khi hết hạn mức; bật lại sau giờ đặt lại; chú thích hạn mức mỗi ngày
src/features/chatbot/components/chat-widget.test.tsxKhung chat chỉ được tải và render sau lần mở đầu tiên, và được giữ lại sau khi đóng
src/features/chatbot/components/chat-composer.test.tsxGửi bằng Enter, không gửi bằng Shift Enter hoặc khi đang gõ tiếng Việt, đếm ký tự, nút dừng, trạng thái vô hiệu
src/features/chatbot/components/chat-quota-meter.test.tsxHiển thị đồng hồ, không giới hạn, cảnh báo, định dạng giờ đặt lại
src/features/chatbot/components/chat-typing-indicator.test.tsxChỉ báo đang trả lời
src/features/chatbot/components/chat-job-card.test.tsxKích thước và số kỹ năng của thẻ việc làm trên màn hình nhỏ và lớn
src/features/chatbot/lib/chat-stream.utils.test.tsĐọc sự kiện SSE: token, done, error
src/features/chatbot/lib/chat-message.utils.test.tsChuẩn hóa hành động chờ xác nhận và hạn mức
src/features/chatbot/lib/chat-route.utils.test.tsLấy mã tin từ đường dẫn
src/features/chatbot/redux/chat-bot.slice.test.tsLưu và khôi phục hạn mức

Chưa có test cho: luồng gửi tin và dự phòng trong use-chat, use-stream-chat, xác nhận và hủy hành động, trợ lý HR, đường dẫn tin bên ngoài.

Source code liên quan ​

Tài liệu backend: Module AI chat.

Đọc tiếp: Stream chat AI, Trạng thái stream chat, Giao tiếp thời gian thực.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code