Skip to content

Trạng thái stream chat ​

Trang này mô tả các trạng thái của một lượt gửi tin nhắn cho trợ lý AI: chờ phản hồi, đang stream, hoàn tất, bị dừng và chuyển sang đường dự phòng. Dành cho developer sửa hộp chat hoặc tìm lỗi "tin nhắn cứ quay".

Vì sao cần trang này ​

Khác với trạng thái hồ sơ hay trạng thái duyệt tin, đây không phải một giá trị lưu trong dữ liệu. Không có field status nào cho stream. Trạng thái được suy ra từ hai cờ trong Redux (isTyping, streamingMessageId) và từ kết quả mà sendStreamMessage trả về. Hiểu cách ghép chúng giúp biết vì sao giao diện đang hiện chấm gõ, đang hiện chữ chạy hoặc đã yên.

Các trạng thái ​

Trạng tháiisTypingstreamingMessageIdGiao diện
RảnhfalsenullCó thể gửi tin mới
Đang chờ phản hồitruenullChấm báo trợ lý đang trả lời, chưa có chữ
Đang streamtruecó giá trịChữ hiện dần từ streamingContent

useStreamChat còn trả isStreaming, bằng streamingMessageId !== null.

Kết quả của sendStreamMessage ​

Hàm này cho useChat biết bước tiếp theo, bằng ba giá trị:

Giá trịNghĩaĐiều kiện
startedStream đã bắt đầuPhản hồi ok và có body
handled_errorLỗi đã được thông báo, không dự phòngPhản hồi không ok và mã khác 401, 404, 405, 501
fallbackCần gửi lại bằng đường thườngMã 401, 404, 405, 501; không có body; hoặc fetch ném lỗi

Sơ đồ ​

Sơ đồ chỉ vẽ các chuyển trạng thái có trong use-chat.ts, use-stream-chat.ts và chat-bot.slice.ts; DangCho2 là chờ phản hồi của đường thường, cùng dấu hiệu isTyping = true như DangCho.

ChuyểnNơi thực hiện
Rảnh sang chờdispatch(setIsTyping(true)) trong sendStreamMessage
Chờ sang streamaddMessage tin giữ chỗ rồi startStreaming(messageId)
Stream sang rảnh khi hoàn tấtfinalizeStream, ghi nội dung cuối, đặt isTyping = false
Stream sang rảnh khi dừngabortStream, giữ phần đã nhận, đặt isTyping = false
Chờ sang rảnh khi lỗisetIsTyping(false) rồi toast

Điểm cần lưu ý ​

ĐiểmChi tiết
Chuỗi viết cứngabortStream ghi "Đã dừng tạo phản hồi." bằng tiếng Việt khi chưa nhận được chữ nào
Kết thúc không rõNếu luồng kết thúc mà không có sự kiện done, readStream vẫn gọi finalizeStream bằng phần đã nhận
Gỡ componentHủy luồng đang chạy khi hook bị gỡ

Source code liên quan ​

Đọc tiếp: Stream chat AI, Endpoint Chat, Model Chat Message.

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