Lịch trình

Chạy lời nhắc của tác tử vào mỗi ngày trong tuần, mỗi giờ hoặc một lần, trong múi giờ và cuộc trò chuyện bạn chọn.

Một lịch trình cung cấp cho một tác tử một lời nhắc vào những thời điểm đã định, ví dụ: mỗi ngày làm việc lúc 08:00 hoặc một lần vào thứ Ba tới. Mỗi lần tác tử nhận lời nhắc dưới dạng một lượt trong cuộc trò chuyện bạn đã chọn và trả lời ở đó.

Tạo lịch trình#

Mở Lịch trình ở thanh bên trái và nhấp Lịch trình mới. Biểu mẫu yêu cầu:

Cách viết thời gian:

• Cron có năm trường: phút, giờ, ngày trong tháng, tháng và ngày trong tuần. 0 8 * * 1-5 là các ngày làm việc lúc 08:00.
• RRULE sử dụng định dạng lịch, ví dụ FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze lưu trữ nó dưới dạng cron phù hợp.
• Một lần lấy một thời gian cục bộ trong múi giờ, ví dụ 2026-11-02T09:00. Một lịch trình một lần chạy một lần rồi hiển thị là đã hoàn tất.

Một thời gian hoặc múi giờ không hợp lệ bị từ chối với schedule_invalid và không có gì được lưu.

Một lịch trình lặp lại chạy tối đa mỗi 30 phút. Một cron hoặc RRULE có các lần chạy gần nhau hơn, ví dụ */5 * * * *, bị từ chối với schedule_too_frequent; đối với công việc nên theo sau một sự kiện nào đó, hãy sử dụng trình kích hoạt thay thế.

Điều gì xảy ra khi một lịch trình chạy#

Tác tử đăng "Lần chạy theo lịch trình: Bản tóm tắt buổi sáng" (với tên của lịch trình) và lời nhắc trong cuộc trò chuyện bạn đã chọn, và câu trả lời của nó sẽ nằm trong một luồng dưới tin nhắn đó. Lời nhắc được tính là một tin nhắn từ người đã tạo lịch trình, vì vậy tác tử làm việc với quyền truy cập của người đó vào két an toàn.

Mỗi lần chạy bắt đầu trong một phiên mới cho một tác tử được lưu trữ: nó có các kỹ năng và tệp bộ nhớ của tác tử nhưng không có các cuộc trò chuyện trước đó, vì vậy nó thực hiện nhiệm vụ từ các kênh, tệp và kết nối mỗi lần. Khi lần chạy kết thúc, phiên chính của tác tử nhận được một ghi chú ngắn về những gì lần chạy đã làm. Một lần chạy không tìm thấy gì để làm thì không đăng gì.

Nếu tác tử đã rời kênh đó, lần chạy không đăng gì và không cung cấp lượt nào cho tác tử. Nếu tác tử đã bị xóa, lần chạy được ghi nhận là đã bỏ qua và lịch trình dừng lại.

Kiểm tra trước, chỉ đánh thức khi có thay đổi#

Một lịch trình thăm dò thay đổi không cần mô hình mỗi lần. Hãy cung cấp cho nó một kiểm tra: một tập lệnh có thể thực thi trong thư mục làm việc của tác tử. Mỗi lần kích hoạt, tập lệnh chạy trên máy tính tác tử, trước bất kỳ lệnh gọi mô hình nào.

Đặt nó dưới Kiểm tra trước trong biểu mẫu, hoặc với laze schedule add ... --check checks/new-calls.sh. Chỉ tác tử hoặc chủ sở hữu của nó mới có thể đặt hoặc thay đổi một kiểm tra, vì nó chạy với các tệp của tác tử và lệnh laze. Nó chạy bên ngoài bất kỳ lượt nào, vì vậy các lệnh laze vault từ chối nó. Một kiểm tra tự gọi một mô hình sẽ trả tiền cho lệnh gọi đó. Các tác tử được kết nối từ máy riêng của bạn không có máy tính Laze nào để chạy kiểm tra.

#!/bin/sh
now=$(laze app records list picks --site published | sha256sum)
[ "$now" = "$(cat state/picks 2>/dev/null)" ] && exit 0
echo "picks changed: $now"

8000 ký tự đầu tiên của đầu ra đến được tác tử, được đánh dấu là dữ liệu từ tập lệnh. Chúng không được đăng trong cuộc trò trò chuyện. Ba lỗi liên tiếp sẽ gửi cho người đã tạo lịch trình một thẻ trong Bảng tin. Chạy ngay chạy kiểm tra trước, vì vậy nó kiểm tra một tập lệnh: nó chỉ đánh thức tác tử nếu tập lệnh in ra thứ gì đó. Một kiểm tra đánh thức một máy tính đang ngủ, máy tính này sẽ quay lại trạng thái ngủ ngay sau đó khi kiểm tra không tìm thấy gì.

Nếu những gì bạn theo dõi là một bản ghi ứng dụng hoặc một kênh, hãy sử dụng trình kích hoạt hoặc màn hình thay thế: chúng kích hoạt khi có thay đổi và không cần máy tính cho đến lúc đó.

Múi giờ, giờ tiết kiệm ánh sáng ban ngày và thời gian ngừng hoạt động#

Thời gian tuân theo múi giờ của lịch trình, bao gồm giờ tiết kiệm ánh sáng ban ngày:

• Khi đồng hồ chạy nhanh và thời gian đó không tồn tại trong ngày, lịch trình sẽ chạy một lần, ngay sau khoảng trống.
• Khi đồng hồ chạy chậm và thời gian đó xảy ra hai lần, lịch trình sẽ chạy một lần, vào lần đầu tiên.
• Nếu Laze bị ngừng hoạt động và bỏ lỡ các lần chạy, lịch trình sẽ chạy một lần khi Laze hoạt động trở lại, và lần chạy đó ghi chú có bao nhiêu lần đã bị bỏ lỡ. Lần chạy tiếp theo sau đó được tính từ bây giờ.

Tạm dừng, chỉnh sửa và xóa lịch trình#

Mỗi hàng trên trang Lịch trình có Chạy, Chỉnh sửa, Tạm dừng hoặc Tiếp tục, và Xóa:

• Chạy liệt kê mỗi lần chạy với thời gian và kết quả của nó.
• Tạm dừng xóa lần chạy tiếp theo. Tiếp tục tính lần chạy tiếp theo từ bây giờ và không bắt kịp thời gian đã tạm dừng.
• Chỉnh sửa thay đổi tên, lời nhắc, thời gian, múi giờ hoặc cuộc trò chuyện. Một lịch trình đã tạm dừng vẫn tạm dừng sau khi chỉnh sửa, và một lịch trình một lần đã hoàn thành sẽ chạy lại nếu bạn cung cấp cho nó một thời gian phía trước.
• Xóa loại bỏ lịch trình; nó sẽ không bao giờ chạy lại.

Bất kỳ ai có thể nói chuyện với tác tử đều thấy các lịch trình của nó và có thể tạo, chỉnh sửa, tạm dừng, tiếp tục và xóa chúng: chủ sở hữu của nó, những người nó được chia sẻ cùng và tất cả mọi người đối với một tác tử nhóm. Người đã yêu cầu một lịch trình cũng giữ nó. Những người khác, bao gồm admin không gian làm việc, không thấy các lịch trình của tác tử; việc lên lịch cho một tác tử bạn không thể nói chuyện bị từ chối với schedule_agent_not_allowed.

Lên lịch từ dòng lệnh#

Mọi người và tác tử đều sử dụng laze schedule. Cung cấp chính xác một trong --cron, --rrule hoặc --at. Không có --tz, múi giờ là UTC.

laze schedule add "Morning brief" --prompt "Write my morning brief from my inbox and calendar" --cron "0 8 * * 1-5" --tz Europe/Amsterdam
laze schedule add "Renewal reminder" --prompt "Remind the team about the ACME renewal" --at 2026-11-02T09:00 --tz Europe/Amsterdam --channel <channelId>
laze schedule list
laze schedule pause <scheduleId>
laze schedule runs <scheduleId>
laze schedule run <scheduleId>

Chạy ngay và các lần chạy đã không xảy ra#

Chạy ngay trên hàng của một lịch trình, hoặc laze schedule run <scheduleId>, chạy nó một lần ngay lập tức. Lần kích hoạt tiếp theo không di chuyển.

Nếu một lịch trình kích hoạt trong khi tác tử của nó không được kết nối, đã bị xóa hoặc cuộc trò chuyện của nó đã biến mất, người mà lịch trình chạy cho sẽ nhận được một thẻ trong bảng tin của họ: Your scheduled run "<name>" did not run, với lý do và nút Chạy ngay. Một lần bỏ lỡ khác của cùng lịch trình đó sẽ đưa thẻ tương tự trở lại.

Ví dụ: một bản tóm tắt buổi sáng trong bảng tin#

Một bản tóm tắt buổi sáng là một lịch trình mà lời nhắc của nó yêu cầu tác tử đăng các thẻ bảng tin thành một nhóm. Bảng tin hiển thị nhóm mới nhất dưới lời chào, với một chip lọc cho mỗi nhãn.

laze schedule add "Morning brief" --cron "45 7 * * 1-5" --tz Europe/Amsterdam --prompt "Check my inbox, calendar and open loops. Post one feed card per thing that needs me with --group \"Morning brief <d Mon>\", one --label of money, promise, decide, nudge, risk or fyi, and --loop <stable key>. Then run laze feed group-summary \"Morning brief <d Mon>\" and post its output."

Đối với một bản tóm tắt lớn hơn, hãy phân chia việc đọc cho nhiều tác tử trinh sát. Cài đặt kỹ năng brief-scout trên mỗi tác tử trinh sát và morning-brief trên tác tử viết bản tóm tắt, sau đó lên lịch cho các tác tử trinh sát trước bản tóm tắt. Mỗi tác tử trinh sát tải lên báo cáo của mình dưới dạng briefs/<YYYY-MM-DD>/<scout>.md vào kênh mà bản tóm tắt đọc, với bằng chứng của mỗi mục. Tác tử bản tóm tắt đọc các tệp đó, chờ tới 15 phút cho một tệp bị trễ, kiểm tra từng mục và đăng các mục đã kiểm tra dưới dạng thẻ trong nhóm. Một tác tử trinh sát không chạy sẽ dẫn đến bản tóm tắt, và chủ sở hữu của nó cũng nhận được thẻ chạy bị bỏ lỡ với Chạy ngay.

Đăng lại một thẻ với cùng khóa --loop sẽ di chuyển nó vào nhóm mới và hiển thị số lần nó đã được xem. --auto-send-on <YYYY-MM-DD> thêm một bộ đếm ngược với nút Dừng vào bất kỳ thẻ nào.

Khi một tác tử chạy laze schedule add với khóa riêng của nó, lịch trình nhắm mục tiêu vào tác tử đó và được tính là do chủ sở hữu của tác tử tạo. Một tác tử được yêu cầu trong trò chuyện để thực hiện công việc định kỳ có thể tạo lịch trình theo cách này.

Cũng kiểm tra: Tham khảo CLI, Tác tử được lưu trữ.