Calendar - Theo dõi nhật ký thực thi và chẩn đoán lỗi sự kiện
Theo dõi bảng nhật ký thực thi Execution Log của sự kiện, phân tích nguyên nhân và chẩn đoán khắc phục lỗi tự động.
Mở khu vực Nhật ký Thực thi và Chẩn đoán Lịch
| Bước | Cách thực hiện |
|---|---|
| 1 | Trên thanh điều hướng chính ở cột bên trái của nền tảng RedAI, chọn mục  Lịch (tại đường dẫn /calendar). |
| 2 | Nhấp chọn vào sự kiện có gắn tự động hóa (quy trình Workflow hoặc trợ lý ảo AI Agent) để mở hộp thoại EventUpdateForm. |
| 3 | Tại góc dưới bên trái của chân hộp thoại, chọn biểu tượng đồng hồ lịch sử  (Lịch sử thực thi) để mở hộp thoại theo dõi chuyên sâu EventExecutionLogsModal. |
Các tính năng
Định hướng giao diện nhật ký thực thi (EventExecutionLogsModal)
Hộp thoại Modalv2 Lịch sử thực thi được thiết kế để cung cấp cái nhìn minh bạch 100% về mọi tác vụ tự động chạy ngầm của sự kiện:
| Khu vực hiển thị | Nội dung và ý nghĩa |
|---|---|
| Thanh lọc trạng thái | Các nút lọc nhanh danh sách phiên chạy theo kết quả: Tất cả, Thành công, Thất bại, Đang xử lý, Đã hủy. |
| Cột danh sách phiên chạy (Runs Timeline) | Liệt kê toàn bộ các phiên chạy thực tế theo thứ tự thời gian gần nhất, đi kèm huy hiệu trạng thái màu sắc và thời lượng xử lý. |
| Khung chi tiết hành động (Action Logs) | Hiển thị chi tiết từng bước mà quy trình tự động hóa, trợ lý ảo AI Agent hoặc lệnh gửi thông báo đã thực hiện trong phiên chạy được chọn. |
| Bảng chẩn đoán kỹ thuật (Diagnostics Panel) | Hiển thị trọn vẹn 8 thông số kỹ thuật chuẩn của hệ thống để đội ngũ kỹ thuật đối soát và khoanh vùng sự cố tức thì. |
Theo dõi danh sách các lần chạy thực tế (Runs Timeline)
Giúp bạn kiểm soát xem các tác vụ định kỳ có diễn ra đúng giờ và đạt kết quả như mong đợi hay không:
| Bước | Cách thực hiện |
|---|---|
| 1 | Quan sát danh sách các phiên chạy ở khung bên trái hộp thoại. Mỗi phiên chạy đại diện cho một lần hệ thống kích hoạt tự động hóa theo lịch hẹn. |
| 2 | Nhận biết trạng thái qua huy hiệu màu: -  Thành công (SUCCESS): Toàn bộ quy trình và lệnh gửi thông báo đã hoàn tất trọn vẹn.-  Thất bại (FAILED): Có lỗi phát sinh trong quá trình chạy (như mất kết nối kênh gửi, hết hạn token, hoặc lỗi dữ liệu đầu vào).-  Đang xử lý (RUNNING): Tác vụ đang được trợ lý ảo AI Agent hoặc máy chủ xử lý ngầm.-  Đã hủy (CANCELLED): Phiên chạy đã được người dùng can thiệp dừng trước khi hoàn tất. |
| 3 | Kiểm tra thời lượng: Xem thời gian tiêu hao (tính bằng mili-giây, giây hoặc phút) để đánh giá tốc độ xử lý của từng phiên chạy. |
| 4 | Xem hoạt động chi tiết: Nhấp vào nút Xem hoạt động (hoặc Ẩn hoạt động) để mở rộng danh sách các hành động con bên trong phiên chạy. |
Chẩn đoán chuyên sâu với 8 thông số kỹ thuật (Diagnostics Panel)
Khi một sự kiện chạy tự động bị báo trạng thái Thất bại, bảng chẩn đoán sẽ chỉ rõ chính xác nguyên nhân kỹ thuật để bạn xử lý ngay:
| Bước | Cách thực hiện |
|---|---|
| 1 | Nhấp chọn vào phiên chạy có biểu tượng màu đỏ Thất bại trong danh sách. |
| 2 | Nhấp vào nút  Mở chẩn đoán (hoặc Ẩn chẩn đoán) ở khung chi tiết bên phải. |
| 3 | Đọc đúng 8 trường dữ liệu chẩn đoán chuẩn hóa: 1. ID lịch chạy (scheduleId): Mã định danh của mốc hẹn trong hệ thống lịch. 2. ID tác vụ hàng đợi (jobId): Mã nhận diện công việc trong hàng đợi BullMQ. 3. ID tác vụ worker (workerJobId): Mã nhận diện tiến trình xử lý ngầm của máy chủ Worker. 4. Tham chiếu bên ngoài (externalRefId): Mã đối soát trả về từ dịch vụ bên thứ ba (như Zalo OA messageId, Messenger mid…). 5. Mã kết quả (outcomeCode): Mã lỗi hoặc mã phản hồi chuẩn hóa của hệ thống (ví dụ: 200, 400, CHANNEL_AUTH_EXPIRED).6. Nhóm lỗi (errorCategory): Phân loại lỗi chính (như VALIDATION_ERROR, NETWORK_TIMEOUT, AUTHENTICATION_ERROR…).7. Có thể thử lại (retryable): Hiển thị Có hoặc Không cho biết hệ thống có tự động kích hoạt cơ chế retry hay không.8. Chi tiết (details): Toàn bộ dữ liệu log JSON định dạng chi tiết giúp kỹ thuật viên truy vết nguyên nhân gốc rễ. |
| 4 | Căn cứ vào chi tiết lỗi, bạn có thể kiểm tra lại kết nối kênh gửi (như nạp lại mã khóa Zalo OA / Fanpage) hoặc điều chỉnh lại cấu hình sự kiện cho phù hợp. |
Can thiệp dừng hoặc hủy lần chạy đang xử lý (Cancel Execution)
Áp dụng trong các tình huống khẩn cấp khi bạn phát hiện nội dung kịch bản có sai sót và muốn chặn ngay lập tức:
| Bước | Cách thực hiện |
|---|---|
| 1 | Tại phiên chạy đang có trạng thái Đang xử lý (RUNNING) hoặc đang xếp hàng chờ chạy. |
| 2 | Chọn nút  (Hủy phiên chạy) ở góc trên bên phải khung chi tiết. |
| 3 | Xác nhận lệnh dừng. Hệ thống sẽ ngay lập tức ngắt tiến trình ngầm, chặn các lệnh gửi thông báo tiếp theo và chuyển trạng thái phiên chạy sang Đã hủy (CANCELLED) an toàn. |
Xem báo cáo thống kê tổng quan Lịch (Calendar Dashboard Overview)
Cung cấp bức tranh toàn cảnh về tình hình vận hành lịch và mức độ hiệu quả của tự động hóa trong toàn bộ không gian làm việc:
| Chỉ số thống kê | Ý nghĩa đối với người quản lý |
|---|---|
| Tổng số cuốn lịch đang hoạt động | Số lượng các bộ lịch phòng ban và dự án đang được theo dõi trong không gian làm việc. |
| Tổng số sự kiện trong tháng | Mật độ công việc và số lượng lịch hẹn đã được phân bổ. |
| Số sự kiện sắp diễn ra | Các mốc hẹn quan trọng trong 24 giờ hoặc 7 ngày tới cần chuẩn bị. |
| Tỷ lệ thực thi tự động hóa thành công | Tỷ lệ phần trăm các phiên chạy của quy trình và trợ lý ảo AI Agent hoàn thành trọn vẹn, giúp đánh giá độ ổn định của hệ thống. |
Hướng dẫn thao tác qua trợ lý ảo AI Agent
Bạn có thể yêu cầu trợ lý ảo AI Agent tự động rà soát lịch sử chạy, báo cáo các lỗi phát sinh hoặc can thiệp hủy lịch hẹn một cách nhanh chóng qua khung trò chuyện.
Chuẩn bị kỹ năng (Skill) cho trợ lý ảo AI Agent
- Kỹ năng cần kích hoạt: Kỹ năng Quản lý Lịch thông minh (
RedAI - Module - AI Calendar). Mã ID:70008ab1-0b56-4ee8-9114-499a08f76137. - Bộ công cụ sử dụng: Bộ công cụ Quản lý Lịch thông minh (
RedAI - Module - AI Calendar). Mã ID:d673055b-b052-4fa3-8436-809a0c9991ea. - Phạm vi hỗ trợ: Tra cứu thống kê tổng quan, kiểm tra lịch sử các lần chạy, đọc chi tiết log lỗi và hủy phiên chạy khẩn cấp.
Các tính năng thao tác qua trợ lý ảo AI Agent
1. Tra cứu thống kê tổng quan lịch làm việc
Nắm bắt nhanh số lượng sự kiện và tiến độ thực thi công việc trong không gian làm việc.
| Mục | Chi tiết |
|---|---|
| Thao tác tương đương trên UI | Xem các bảng thống kê và số liệu tổng hợp trên màn hình Lịch. |
| Công cụ Agent sử dụng | get_calendar_dashboard_overview |
| Thông tin cần cung cấp | Khoảng thời gian muốn thống kê (ví dụ: trong tuần này hoặc trong tháng này). |
Câu lệnh mẫu (Prompt):
“Hãy sử dụng kỹ năng Quản lý Lịch thông minh để tổng hợp báo cáo tổng quan tình hình lịch làm việc trong tháng này cho tôi: Có bao nhiêu sự kiện đã diễn ra, bao nhiêu sự kiện sắp tới và tỷ lệ chạy tự động hóa thành công là bao nhiêu?”
2. Kiểm tra lịch sử chạy và chẩn đoán nguyên nhân lỗi
Nhờ trợ lý ảo AI Agent đọc log kỹ thuật và giải thích bằng ngôn ngữ dễ hiểu.
| Mục | Chi tiết |
|---|---|
| Thao tác tương đương trên UI | Mở hộp thoại EventExecutionLogsModal và bấm Mở chẩn đoán. |
| Công cụ Agent sử dụng | get_event_executions và get_event_execution_detail |
| Thông tin cần cung cấp | Tên sự kiện bị lỗi hoặc thời điểm phiên chạy diễn ra. |
Câu lệnh mẫu (Prompt):
“Sự kiện [Tự Động Gửi Báo Cáo Doanh Thu] sáng nay báo trạng thái Thất bại. Hãy kiểm tra chi tiết lần chạy gần nhất và giải thích rõ nguyên nhân vì sao bị lỗi cho tôi biết.”
3. Hủy khẩn cấp phiên chạy sự kiện đang diễn ra
Ngắt ngay lập tức tác vụ ngầm khi phát hiện nguy cơ sai lệch dữ liệu.
| Mục | Chi tiết |
|---|---|
| Thao tác tương đương trên UI | Bấm nút Hủy phiên chạy trong bảng theo dõi thực thi. |
| Công cụ Agent sử dụng | cancel_event_execution |
| Thông tin cần cung cấp | Tên sự kiện hoặc mã phiên chạy muốn dừng. |
Câu lệnh mẫu (Prompt):
“Hãy kiểm tra phiên chạy đang xử lý của sự kiện [Gửi Tin Nhắn Chăm Sóc Khách Hàng]. Nếu đang chạy, hãy hủy phiên chạy đó ngay lập tức giúp tôi.”
Cảnh báo khi dùng AI Agent: Lệnh hủy phiên chạy sẽ lập tức ngắt các luồng xử lý tự động hóa. Hãy chỉ ra lệnh này khi bạn thực sự muốn dừng tác vụ để tránh làm gián đoạn công việc đang diễn ra bình thường.
Kiểm tra kết quả sau khi ra lệnh cho trợ lý ảo AI Agent
| Cách kiểm tra | Cách thực hiện | Dấu hiệu nhận biết thành công |
|---|---|---|
| Kiểm tra trong khung chat | Đọc báo cáo phản hồi của trợ lý ảo AI Agent. | Trợ lý ảo AI Agent tóm tắt ngắn gọn số liệu thống kê hoặc chỉ rõ mã lỗi, nguyên nhân sự cố và giải pháp khắc phục. |
| Kiểm tra trên màn hình Lịch | Mở hộp thoại Lịch sử thực thi của sự kiện trên nền tảng RedAI. | Trạng thái phiên chạy đã cập nhật sang Đã hủy hoặc hiển thị đúng các dòng log đối soát tương ứng. |