Skip to content

Stream chat AI ​

Trang này vẽ trình tự từ lúc người dùng gửi một tin nhắn cho trợ lý AI đến khi nhận được câu trả lời, gồm cả đường dự phòng khi stream không dùng được và bước xác nhận hành động. Dành cho người cần biết các bước, và developer sửa hộp chat.

Vì sao có hai đường gửi ​

Stream cho người dùng thấy câu trả lời hiện dần. Nhưng không phải lúc nào stream cũng dùng được (backend cũ không có route, token hết hạn, kết nối bị ngắt). Vì vậy useChat thử stream trước và chuyển sang endpoint thường khi cần, để người dùng vẫn nhận được câu trả lời.

Luồng ​

Sơ đồ rút gọn: useChat chỉ dùng đường dự phòng khi useStreamChat báo fallback.

BướcGiải thích
2Chưa đăng nhập thì toast và dừng; tin trống bị bỏ qua; tin dài hơn 1000 ký tự bị từ chối
5Header có Authorization nếu có token trong localStorage. Stream dùng fetch nên không qua interceptor làm mới token: khi access token hết hạn, backend trả 401 và useChat chuyển sang POST /chat/message qua Axios, nơi cơ chế làm mới token có thể chạy
10Mỗi token được cộng vào streamingContent; tin trống làm chỗ giữ chỗ chỉ nhận nội dung ở bước hoàn tất
12Sự kiện done mang nội dung cuối, quota, suggestedActions, recommendedJobs, recommendedJobIds, pendingToolActions, intent

Sau khi nhận câu trả lời ​

ViệcHành vi
Hạn mứcCập nhật quota trong Redux, lưu qua Redux Persist
Gợi ý câu hỏiHiện thành các nút gợi ý
Việc làm gợi ýVới mỗi mã chưa có dữ liệu, useChat gọi GET /jobs/:id rồi ghi vào tin nhắn

Xác nhận hành động ​

Khi phản hồi có pendingToolActions (hiện chỉ save_job), giao diện hiện nút xác nhận và hủy.

Sơ đồ cho thấy việc lưu chỉ được thực hiện sau khi người dùng đồng ý, và hành động quá hạn bị gỡ khỏi tin nhắn. Hủy dùng DELETE /chat/tool-actions/:id.

Nhánh lỗi ​

Tình huốngHành vi
Backend trả sự kiện error giữa chừngHoàn tất tin nhắn bằng thông điệp lỗi, cập nhật hạn mức nếu có, hiện toast
Luồng bị ngắt giữa chừngHoàn tất tin nhắn bằng phần đã nhận (nếu chưa bị người dùng hủy)
Người dùng bấm dừngGiữ phần đã nhận; nếu chưa nhận gì thì tin nhắn ghi "Đã dừng tạo phản hồi." (chuỗi viết cứng bằng tiếng Việt)
Đường dự phòng cũng lỗiToast lỗi từ useChat

Source code liên quan ​

Backend: Stream chat AI và Module AI chat.

Đọc tiếp: Trạng thái stream chat, Trợ lý AI, Endpoint Chat.

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