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

Chat Messages (chat_messages)

Từng tin nhắn trong một chat-sessions, gồm lời người dùng, câu trả lời của trợ lý và kết quả công cụ.

  • Nguồn schema: chat-message.schema.ts
  • Phân loại dữ liệu: có thể chứa dữ liệu cá nhân: content là nội dung người dùng gõ, có thể gồm thông tin về CV, nghề nghiệp. Không ghi content vào log.
  • Soft-delete: plugin thêm isDeleted và deletedAt.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
sessionIdMixedCó—ref: ChatSessionPhiên chat chứa tin nhắn
userIdMixedCó—ref: UserNgười dùng sở hữu phiên
roleStringCó—enum: tool, system, assistant, userNgười phát tin nhắn: user, assistant, system, tool
contentStringCó——Nội dung tin nhắn
sequenceNumberCó——Số thứ tự tin nhắn trong phiên
relatedJobIds[String]Không——Mã các tin tuyển dụng được nhắc tới, dạng chuỗi
metadataMixedKhông——Thông tin kỹ thuật của lượt trả lời (xem cấu trúc bên trên)
createdAtDateKhông——Thời điểm tạo
updatedAtDateKhông——Thời điểm sửa gần nhất
isDeletedBooleanCófalsethêm bởi plugin xóa mềmCờ xóa mềm. true nghĩa là bản ghi đã bị xóa khỏi nghiệp vụ nhưng vẫn còn trong database
deletedAtDateKhôngnullthêm bởi plugin xóa mềmThời điểm xóa mềm

metadata là type: Object tự do, theo IChatMessageMetadata (chat-message-metadata.interface.ts): provider, model, intent, intentDetectionSource, latencyMs, promptTokens, completionTokens, totalTokens, estimatedPromptTokens, fallbackUsed, guardrailFlags[], errorCategory. Đây là thông tin kỹ thuật của lượt trả lời, được tách riêng khỏi content.

Indexes​

KeysThuộc tínhMục đích
{ sessionId: 1, sequence: 1 }—Đọc hội thoại theo đúng thứ tự
{ userId: 1, createdAt: -1 }—Tin nhắn gần đây của một người

Quan hệ​

FieldLoạiĐích
sessionIdReference, ref: 'ChatSession'chat_sessions. Kiểu Mongoose là Mixed
userIdReference, ref: 'User'users. Kiểu Mongoose là Mixed
relatedJobIdsChuỗi mã tinjobs._id dạng chuỗi, không phải tham chiếu ObjectId

Về kiểu Mixed của sessionId và userId, xem database-overview.

Vai trò tin nhắn (role)​

user, assistant, system, tool. sequence đánh số thứ tự trong phiên, cùng sessionId tạo thứ tự hội thoại.

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819f01",
"sessionId": "665f1a2b3c4d5e6f70819e01",
"userId": "665f1a2b3c4d5e6f70819201",
"role": "assistant",
"content": "Day la mot so tin phu hop voi ban.",
"sequence": 2,
"relatedJobIds": ["665f1a2b3c4d5e6f70819301"],
"metadata": { "provider": "groq", "intent": "job_search", "latencyMs": 820, "fallbackUsed": false },
"isDeleted": false
}

Giá trị model và intent trong metadata là minh họa. Tập giá trị hợp lệ của intent nằm ở enum EChatIntent.

Lưu ý​

  • Known Limitation: không có TTL và không có index trên sessionId riêng lẻ ngoài index ghép { sessionId, sequence }, đủ cho truy vấn theo phiên.
  • Chưa kiểm tra cách sequence được cấp khi có hai request đồng thời cùng một phiên. Trạng thái: Chưa xác minh.