Skip to content

Endpoint Chat ​

Trang này liệt kê 5 endpoint của trợ lý AI trong chat-bot.api.ts và đường gửi tin nhắn dạng stream dùng fetch riêng. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao có hai đường gửi tin ​

Trợ lý trả lời từng chữ để người dùng không phải đợi cả câu. Việc đó cần đọc luồng dữ liệu (Server-Sent Events) mà RTK Query và Axios không làm được, nên stream dùng fetch riêng. Khi stream không dùng được, frontend gửi lại bằng endpoint thường để người dùng vẫn nhận được câu trả lời.

Bảng endpoint RTK Query ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useSendMessageMutationPOST /chat/messageISendMessageRequest: message, jobId?Khôngfeatures/chatbot/hooks/use-chat.ts (đường dự phòng)
useGetChatHistoryQueryGET /chat/historyparams: page (mặc định 1), limit (50)KhôngChưa có nơi nào dùng
useLazyGetChatHistoryQueryGET /chat/historyNhư trênKhôngfeatures/chatbot/hooks/use-chat.ts
useClearChatHistoryMutationDELETE /chat/clearKhôngKhôngfeatures/chatbot/hooks/use-chat.ts
useConfirmToolActionMutationPOST /chat/tool-actions/:actionId/confirmactionId: stringLàm mất hiệu lực Auth, Userfeatures/chatbot/hooks/use-chat.ts
useCancelToolActionMutationDELETE /chat/tool-actions/:actionIdactionId: stringKhôngfeatures/chatbot/hooks/use-chat.ts

Các endpoint này dùng transformResponse để bóc data khỏi ApiResponse, nên hook trả thẳng dữ liệu (IChatResponse, IChatHistoryResponse, ...) chứ không phải ApiResponse<...>. Riêng hai endpoint tool action lấy message từ data.message, nếu không có thì từ message của phản hồi.

useChat ở features/chatbot/hooks/use-chat.ts bọc các hook trên cùng useStreamChat, kèm toast và cập nhật Redux.

Gửi tin nhắn dạng stream ​

Hạng mụcGiá trị
Địa chỉPOST ${API_BASE_URL}/chat/message/stream
Cách gọifetch, credentials: "include"
HeaderContent-Type: application/json, kèm Authorization: Bearer <access_token> nếu có token trong localStorage
Body{ message, jobId? }, giống ISendMessageRequest
HủyAbortController, hủy khi gửi tin mới, khi người dùng dừng hoặc khi component bị gỡ

Phản hồi là luồng SSE; frontend đọc các sự kiện sau:

Sự kiệnDữ liệuFrontend làm gì
tokenMột đoạn văn bảnCộng vào streamingContent
doneJSON IStreamDoneEventHoàn tất tin nhắn, cập nhật hạn mức và gợi ý câu hỏi
errorJSON { message, quota? } hoặc văn bảnHoàn tất tin nhắn bằng thông điệp lỗi và hiện toast

Kết quả của sendStreamMessage cho useChat biết có cần dự phòng không, xem Trạng thái stream chat.

Mã phản hồi từ backendHành vi
401, 404, 405, 501Quay về POST /chat/message
Mã lỗi khácToast với message hoặc error của phản hồi (lấy phần tử đầu nếu là mảng) và dừng
Phản hồi không có body hoặc fetch ném lỗiQuay về POST /chat/message

Đối chiếu với backend ​

Các route frontend gọi có trong chat.controller.ts: POST /chat/message, GET /chat/history, DELETE /chat/clear, POST /chat/message/stream, POST /chat/tool-actions/:actionId/confirm và DELETE /chat/tool-actions/:actionId. Theo controller:

ĐiểmChi tiết
Giới hạn tốc độCác route gửi tin nhắn có @Throttle theo số lần mỗi phút
Route streamGắn @SkipTransform(): phản hồi không bọc trong ApiResponse, frontend đọc SSE thô
jobIdDTO yêu cầu jobId là MongoId hợp lệ; sai thì backend trả lỗi 400
Route frontend không gọiNhóm sessions (tạo, liệt kê, xem, gửi, xóa phiên), POST /chat/sessions/:sessionId/messages/stream và các route thống kê admin/usage/*

WARNING

Trên trang chi tiết tin ngoài (/jobs/external/<id>), hàm getChatJobIdFromPathname lấy đoạn đứng sau jobs làm mã việc làm, tức là chuỗi external, rồi gửi lên là jobId. Chuỗi này không phải MongoId nên theo DTO backend sẽ bị từ chối với 400. Đây là suy luận từ code, chưa chạy thử; test hiện có không kiểm tra đường dẫn dạng này.

Dữ liệu và kiểm tra ​

Trước khi gọi bất kỳ endpoint nào, useChat bỏ qua im lặng tin nhắn trống, và hiện toast từ chối khi chưa đăng nhập hoặc khi tin dài hơn 1000 ký tự. Dạng dữ liệu: Model Chat Message.

Source code liên quan ​

Hợp đồng đầy đủ: API Chat của backend và controller.

Đọc tiếp: Model Chat Message, Stream chat AI, Giao tiếp thời gian thực.

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