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

Chat Tool Actions (chat_tool_actions)

Hành động mà trợ lý AI đề xuất và người dùng phải xác nhận trước khi thực hiện. Hiện chỉ có loại save_job (lưu một tin tuyển dụng). Cơ chế này tách quyết định của AI khỏi thay đổi dữ liệu thật.

  • Nguồn schema: chat-tool-action.schema.ts
  • Phân loại dữ liệu: payload chứa tham số hành động (mã tin tuyển dụng), không chứa nội dung hội thoại.
  • Soft-delete: plugin thêm isDeleted và deletedAt.

Data dictionary​

FieldTypeRequiredDefaultRàng buộcÝ nghĩa
userIdMixedCó—ref: UserNgười dùng được hỏi xác nhận
sessionIdMixedCó—ref: ChatSessionPhiên chat phát sinh hành động
typeStringCó—enum: save_jobLoại hành động. Hiện chỉ có save_job
statusStringKhông"pending"enum: expired, canceled, confirmed, pendingTrạng thái: pending, confirmed, canceled, expired. Mặc định pending
payloadMixedCó——Tham số hành động, dạng object tự do
labelStringCó——Nhãn hiển thị cho nút xác nhận
expiresAtDateCó——Hạn xác nhận
confirmedAtDateKhông——Thời điểm xác nhận
canceledAtDateKhông——Thời điểm hủy
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

Indexes​

KeysThuộc tínhMục đích
{ type: 1 }—Lọc theo loại
{ status: 1 }—Lọc theo trạng thái
{ expiresAt: 1 }—Lọc theo hạn. Index thường, không phải TTL
{ userId: 1, status: 1, expiresAt: 1 }—Tìm hành động còn chờ của một người
{ sessionId: 1, status: 1, createdAt: -1 }—Hành động của một phiên theo trạng thái, mới nhất trước

expiresAt có index thường (index: true), không phải TTL. Bản ghi hết hạn không tự bị xóa.

Vòng đời​

  • expiresAt = thời điểm tạo + CHAT_TOOL_ACTION_EXPIRY_MS, mặc định 15 phút (chat.constant.ts, đọc được từ cấu hình).
  • Việc chuyển expired xảy ra khi action được truy cập sau hạn, không do tác vụ nền (chat-tool-action.service.ts). Action không ai chạm tới sẽ ở pending mãi mãi dù đã quá hạn.

Quan hệ​

FieldLoạiĐích
userIdReference, ref: 'User'users. Mixed, xem database-overview
sessionIdReference, ref: 'ChatSession'chat_sessions. Mixed

Ví dụ document​

{
"_id": "665f1a2b3c4d5e6f70819f51",
"userId": "665f1a2b3c4d5e6f70819201",
"sessionId": "665f1a2b3c4d5e6f70819e01",
"type": "save_job",
"status": "pending",
"label": "Luu tin: Senior Backend Engineer",
"payload": { "jobId": "665f1a2b3c4d5e6f70819301" },
"expiresAt": "2026-10-03T03:15:00.000Z",
"isDeleted": false
}

Cấu trúc payload trong ví dụ là minh họa: schema khai báo Record<string, unknown>. Tên khóa thật của save_job nằm trong chat-tool-action.service.ts.

Lưu ý​

  • Known Limitation: bản ghi pending quá hạn không tự đổi sang expired (xem trên). Truy vấn danh sách "đang chờ" phải tự lọc theo expiresAt.