# Tự động hóa & Lập lịch ## Cron Jobs Lên lịch đánh thức tác nhân với thời gian chính xác. Cron job tồn tại qua các lần khởi động lại Gateway và hỗ trợ các mẫu lập lịch linh hoạt. ### Loại lịch trình | Loại | Mô tả | Ví dụ | |------|-------------|---------| | **Biểu thức cron** | Cú pháp cron tiêu chuẩn với múi giờ | `0 7 * * *` (hàng ngày lúc 7 giờ sáng) | | **Khoảng thời gian** | Lặp lại ở khoảng thời gian cố định | `30m`, `2h`, `1d` | | **Một lần** | Chạy một lần vào thời điểm cụ thể | `2026-03-15T16:00:00Z` | ### Mục tiêu phiên - **Phiên chính**, Đưa vào hàng đợi như sự kiện hệ thống trong cuộc trò chuyện chính của tác nhân - **Phiên cô lập**, Chạy trong phiên chuyên dụng (`cron:`) để tránh làm ô nhiễm các cuộc trò chuyện chính ### Chế độ giao hàng | Chế độ | Mô tả | |------|-------------| | **Không có** | Thực thi im lặng (không đăng đầu ra) | | **Thông báo** | Đăng kết quả trở lại một kênh cụ thể | | **Webhook** | HTTP POST kết quả đến URL bên ngoài | ### Lời nhắc một lần Đặt lời nhắc cho một thời điểm cụ thể. Tác nhân thức dậy, xử lý lời nhắc và tùy chọn xóa công việc sau khi chạy. ### Công việc định kỳ Lên lịch các nhiệm vụ lặp lại với biểu thức cron và hỗ trợ múi giờ. Công việc theo dõi lịch sử thực thi của chúng (thành công, thất bại, thời gian). --- ## Webhook Nhận sự kiện từ các dịch vụ bên ngoài và định tuyến chúng đến các tác nhân. ### Gmail Pub/Sub Tích hợp với hệ thống thông báo đẩy của Gmail để kích hoạt hành động tác nhân khi email đến: 1. Thiết lập chủ đề và đăng ký GCP Pub/Sub 2. Cấu hình lọc nhãn Gmail 3. Trỏ giao hàng đẩy đến URL webhook của bạn 4. Neotask nhận tin nhắn và đưa sự kiện tác nhân vào hàng đợi ### Webhook tùy chỉnh Đăng ký các endpoint HTTP kích hoạt lượt tác nhân khi được gọi. Hữu ích để tích hợp với các pipeline CI/CD, hệ thống giám sát hoặc bất kỳ dịch vụ nào có thể gửi yêu cầu HTTP. --- ## Sự kiện hệ thống Sự kiện hệ thống là các tín hiệu đánh thức tác nhân để xử lý: - **Tức thì**, Xử lý ở nhịp tim tiếp theo - **Nhịp tim tiếp theo**, Xếp hàng cho lần kiểm tra theo lịch tiếp theo Sử dụng sự kiện hệ thống cho các quy trình làm việc phản ứng, tác nhân thức dậy khi có điều gì đó xảy ra thay vì theo lịch cố định. --- ## Nhịp tim Nhịp tim là tín hiệu định kỳ (mặc định ~15 giây) cho các tác nhân cơ hội xử lý công việc đang chờ xử lý: - Kiểm tra các sự kiện hệ thống mới - Xử lý tin nhắn đã xếp hàng - Chạy các tự động hóa đang chờ xử lý Nhịp tim có thể được bật, tắt hoặc cấu hình theo từng tác nhân. --- ## Hook Tự động hóa hướng sự kiện kích hoạt các lệnh shell hoặc script để phản hồi các sự kiện Gateway: - **Khi có tin nhắn**, Thực thi khi nhận được tin nhắn - **Khi có lượt tác nhân**, Thực thi trước hoặc sau khi tác nhân xử lý tin nhắn - **Khi có sự kiện kênh**, Thực thi trên các sự kiện dành riêng cho kênh (tham gia, rời, phản ứng) Hook chạy trên máy chủ Gateway và có quyền truy cập dữ liệu ngữ cảnh sự kiện. --- ## Các trường hợp sử dụng | Kịch bản | Giải pháp | |----------|----------| | Bản tóm tắt buổi sáng hàng ngày | Cron job lúc 7 giờ sáng → tác nhân tóm tắt các cập nhật qua đêm | | Tạo báo cáo hàng tuần | Cron job vào mỗi thứ Hai → tác nhân tạo và gửi email báo cáo | | Theo dõi email | Webhook Gmail → tác nhân xử lý email đến | | Thông báo bản dựng | Webhook CI/CD → tác nhân thông báo kết quả bản dựng trên Discord | | Kiểm tra dữ liệu hàng giờ | Cron dựa trên khoảng thời gian → tác nhân kiểm tra bảng điều khiển và cảnh báo về bất thường | | Bài đăng mạng xã hội theo lịch | Cron job → tác nhân soạn thảo và đăng nội dung vào thời điểm tối ưu |