Chuyển tới nội dung chính

Sequence: chat AI dạng stream

Trình tự của POST /api/v1/chat/message/stream (và biến thể theo phiên). Quy tắc và guardrail: ai-chat. Định dạng sự kiện: realtime.

Actor​

Người dùng đã đăng nhập; không có khách.

Luồng chính​

Nhánh lỗi​

Tình huốngKhi nàoBiểu hiện với client
Thiếu hoặc sai token, DTO sai, vượt 15 lượt mỗi phútTrước flushHeadersHTTP 401, 400, 429 thường, không phải SSE
Tin nhắn bị guardrail chặn (rủi ro cao)Trong prepareChatTurn, sau khi header 200 đã gửiSự kiện error với thông điệp "Your message appears to contain instructions that cannot be processed by the chatbot."
Hết hạn mức ngàyỞ reserveSự kiện error kèm quota.remainingQuota và quota.nextResetTime
Nhà cung cấp chính lỗi đủ điều kiện (giới hạn tốc độ, 5xx, hết thời gian)Khi gọi AIChuyển sang Gemini nếu bật dự phòng và còn quota chat-fallback
Lỗi trước khi có token nàoKhi gọi AIHoàn quota (rollback), sự kiện error
Lỗi không phải HttpExceptionBất kỳSự kiện error với thông điệp chung, không lộ chi tiết
Bộ lọc chủ đề phát hiện lạc đềSau khi sinhThay nội dung bằng thông báo từ chối song ngữ
Bộ lọc chủ đề lỗiSau khi sinhCho qua (fail-open)

Vì header 200 được gửi trước khi xử lý, mọi lỗi sau đó đến qua sự kiện error chứ không qua mã HTTP. Điểm guardrail trả 400 ở route JSON nhưng thành sự kiện error ở route stream là suy ra từ việc prepareChatTurn nằm trong generator; chưa chạy thử để xác nhận.

Ghi chú​

  • Đường stream không dùng AI để phân loại ý định (allowAiIntentClassifier: false), tiết kiệm một lần gọi.
  • Cache FAQ không tiêu hạn mức.
  • Lưu hội thoại và ghi nhật ký diễn ra sau khi sinh xong, trước sự kiện done.