Skip to content

Model Chat Message ​

Trang này mô tả dữ liệu của trợ lý AI ở frontend: tin nhắn, phản hồi, hạn mức dùng, thẻ gợi ý việc làm và hành động chờ xác nhận. Dành cho developer cần biết field nào có, và state chat được giữ ở đâu.

Vì sao có nhiều dạng ​

Cùng một cuộc trò chuyện được nhìn ở ba nơi. Backend trả tin nhắn dạng truyền tải (không có id). Giao diện cần id để cập nhật đúng tin nhắn khi stream. Khi phản hồi về, ngoài văn bản còn có gợi ý việc làm, hành động chờ xác nhận và hạn mức.

DạngĐịnh nghĩaDùng ở
Tin nhắn truyền tảiIChatTransportMessageLịch sử từ GET /chat/history
Tin nhắn trong giao diệnIMessage = tin truyền tải + id + isLoading?Redux, ChatSurface
Phản hồi một lượtIChatResponsePOST /chat/message
Kết quả cuối của streamIStreamDoneEvent, sau chuẩn hóa là INormalizedStreamDoneEventSự kiện done của stream
Lịch sửIChatHistoryResponseGET /chat/history
Yêu cầu gửiISendMessageRequestGửi tin nhắn

Type chính: IMessage cho giao diện; tất cả định nghĩa ở src/shared/types/chat.d.ts. Đây là type TypeScript thuần, không có schema Zod kiểm tra lúc chạy.

Tin nhắn (IMessage) ​

FieldKiểuBắt buộcÝ nghĩa nghiệp vụ
idstringCóĐịnh danh trong giao diện (UUID tạo ở frontend)
role'user' | 'assistant'CóNgười gửi
contentstringCóNội dung; phản hồi của trợ lý là Markdown
timestampstringCóThời điểm dạng ISO, giữ dạng chuỗi để Redux lưu được
isLoadingbooleanKhôngTin đang chờ nội dung
recommendedJobsIJob[]KhôngViệc làm gợi ý kèm đủ dữ liệu
recommendedJobIdsstring[]KhôngMã việc làm gợi ý; với mã chưa có dữ liệu, useChat gọi GET /jobs/:id cho từng mã rồi ghi vào recommendedJobs
pendingToolActionsIChatToolAction[]KhôngHành động đang chờ người dùng xác nhận
intentChatIntentKhôngÝ định backend nhận diện

ChatIntent có 7 giá trị: job_search, company, cv_review, job_matching, faq, recruiter_support, general.

Hành động chờ xác nhận (IChatToolAction) ​

FieldKiểuÝ nghĩa
actionIdstringMã hành động, dùng để xác nhận hoặc hủy
type'save_job'Loại hành động; hiện chỉ có lưu việc
payload{ jobId: string }Việc làm cần lưu
expiresAtstringHạn xác nhận; hành động quá hạn bị gỡ khỏi tin nhắn

Hạn mức (IChatQuotaStatus) ​

FieldKiểuÝ nghĩa
remainingQuotanumber | nullSố lượt còn lại; null là không giới hạn
nextResetTimenumberThời điểm đặt lại, đơn vị giây (frontend nhân 1000 khi tạo Date)
limitnumber | null | undefinedHạn mức mỗi ngày; null là gói không giới hạn, undefined là backend chưa gửi

Phản hồi một lượt (IChatResponse) ​

FieldKiểuÝ nghĩa
conversationIdstringMã cuộc trò chuyện
responsestringVăn bản Markdown
timestampstringThời điểm, tùy chọn
suggestedActionsstring[]Gợi ý câu hỏi tiếp theo
quotaIChatQuotaStatusHạn mức sau lượt này
Các field gợi ýrecommendedJobs, recommendedJobIds, pendingToolActions, intentNhư ở tin nhắn

State chat trong Redux ​

Field của chatBotÝ nghĩaĐược lưu qua tải lại trang
messagesDanh sách IMessageKhông
isTypingĐang chờ phản hồiKhông
suggestedActionsGợi ý câu hỏi hiện tạiKhông
streamingMessageIdTin đang được streamKhông
streamingContentPhần văn bản đã nhận khi streamKhông
quotaHạn mứcCó (qua Redux Persist)

quota bị xóa khi đăng xuất hoặc xóa phiên đăng nhập.

Ví dụ JSON ​

Dữ liệu giả, theo IChatResponse:

json
{
  "conversationId": "665f1a2b3c4d5e6f70819340",
  "response": "Đây là vài việc làm React phù hợp với bạn.",
  "suggestedActions": ["Xem việc làm lương cao"],
  "recommendedJobIds": ["665f1a2b3c4d5e6f70819310"],
  "pendingToolActions": [
    { "actionId": "a1", "type": "save_job", "payload": { "jobId": "665f1a2b3c4d5e6f70819310" } }
  ],
  "intent": "job_search",
  "quota": { "remainingQuota": 18, "nextResetTime": 1790000000, "limit": 20 }
}

Điểm chưa đồng nhất ​

Vấn đềChi tiết
recommendedJobs dùng interface cũKiểu IJob của backend.d.ts, khác với Job suy ra từ schema Zod; xem Model Job
Hai kiểu kết quả của streamIStreamDoneEvent và INormalizedStreamDoneEvent có cùng field
Chưa kiểm tra lúc chạyDữ liệu từ backend được ép kiểu, không được Zod kiểm tra

Chưa có ghi chép về lý do.

Nơi dùng ​

Endpoint: Endpoint Chat. Luồng: Stream chat AI và Trạng thái stream chat.

Source code liên quan ​

Collection ở backend: chat-messages.

Đọc tiếp: Endpoint Chat, Trợ lý AI, Tham chiếu dữ liệu backend.

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