Jadwal

Jalankan prompt agen setiap hari kerja, setiap jam, atau sekali, di zona waktu dan percakapan yang Anda pilih.

Sebuah jadwal memberikan agen prompt pada waktu yang telah ditentukan, misalnya setiap hari kerja pukul 08:00 atau sekali pada Selasa depan. Pada setiap waktu, agen menerima prompt sebagai giliran dalam percakapan yang Anda pilih dan menjawab di sana.

Buat jadwal#

Buka Jadwal di bilah kiri dan klik Jadwal baru. Formulir meminta:

Cara menulis waktu:

• Cron memiliki lima kolom: menit, jam, hari dalam bulan, bulan, dan hari kerja. 0 8 * * 1-5 adalah hari kerja pukul 08:00.
• RRULE menggunakan format kalender, misalnya FREQ=WEEKLY;BYDAY=MO,WE;BYHOUR=9;BYMINUTE=0. Laze menyimpannya sebagai cron yang sesuai.
• Sekali mengambil waktu lokal di zona tersebut, seperti 2026-11-02T09:00. Jadwal satu kali berjalan sekali dan kemudian ditampilkan sebagai selesai.

Waktu atau zona yang tidak valid akan ditolak dengan schedule_invalid dan tidak ada yang disimpan.

Jadwal berulang berjalan paling sering setiap 30 menit. Cron atau RRULE yang eksekusinya berdekatan, seperti */5 * * * *, akan ditolak dengan schedule_too_frequent; untuk pekerjaan yang harus mengikuti sesuatu yang terjadi, gunakan pemicu sebagai gantinya.

Apa yang terjadi saat jadwal dieksekusi#

Agen memposting "Eksekusi terjadwal: Rangkuman Pagi" (dengan nama jadwal) dan prompt dalam percakapan yang Anda pilih. Jawabannya akan muncul dalam utas di bawah pesan tersebut. Prompt dihitung sebagai pesan dari orang yang membuat jadwal, jadi agen bekerja dengan akses orang tersebut ke brankas.

Setiap eksekusi dimulai dalam sesi baru untuk agen yang di-hosting: ia memiliki skill dan file memori agen tetapi tidak dengan chat sebelumnya. Jadi, ia melakukan tugas dari saluran, file, dan koneksi setiap kali. Ketika eksekusi berakhir, sesi utama agen mendapatkan catatan singkat tentang apa yang dilakukan eksekusi. Eksekusi yang tidak menemukan apa pun untuk dilakukan tidak memposting apa pun.

Jika agen telah meninggalkan saluran tersebut, eksekusi tidak memposting apa pun dan tidak memberikan giliran kepada agen. Jika agen dihapus, eksekusi dicatat sebagai dilewati dan jadwal berhenti.

Periksa terlebih dahulu, bangunkan hanya jika ada yang berubah#

Jadwal yang melakukan polling untuk perubahan tidak memerlukan model setiap kali. Beri jadwal tersebut pemeriksaan: skrip yang dapat dieksekusi di folder kerja agen. Pada setiap pemicuan, skrip berjalan di komputer agen, sebelum panggilan model apa pun.

Atur di bawah Periksa terlebih dahulu di formulir, atau dengan laze schedule add ... --check checks/new-calls.sh. Hanya agen atau pemiliknya yang dapat mengatur atau mengubah pemeriksaan, karena ia berjalan dengan file agen dan perintah laze. Ia berjalan di luar giliran apa pun, jadi perintah laze vault menolaknya. Pemeriksaan yang memanggil model sendiri membayar panggilan tersebut. Agen yang terhubung dari mesin sendiri tidak memiliki komputer Laze untuk menjalankan pemeriksaan.

Simpan apa yang terakhir dilihat skrip dalam file Anda sendiri. Contoh ini membangunkan agen saat nilai berubah, dan giliran agen menyimpan nilai baru:

#!/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 karakter pertama dari output mencapai agen, ditandai sebagai data dari skrip. Mereka tidak diposting dalam percakapan. Tiga kegagalan berturut-turut mengirim orang yang membuat jadwal satu kartu di Feed. Eksekusi sekarang menjalankan pemeriksaan terlebih dahulu, sehingga menguji skrip: itu membangunkan agen hanya jika skrip mencetak sesuatu. Pemeriksaan membangunkan komputer yang tidak aktif, yang akan kembali tidak aktif segera setelah pemeriksaan tidak menemukan apa pun.

Jika yang Anda pantau adalah catatan aplikasi atau saluran, gunakan pemicu atau monitor sebagai gantinya: mereka memicu perubahan dan tidak memerlukan komputer sampai saat itu.

Zona waktu, waktu musim panas, dan waktu henti#

Waktu mengikuti zona waktu jadwal, termasuk waktu musim panas:

• Ketika jam dimajukan dan waktu tidak ada pada hari itu, jadwal berjalan sekali, tepat setelah jeda.
• Ketika jam dimundurkan dan waktu terjadi dua kali, jadwal berjalan sekali, pada yang pertama.
• Jika Laze tidak berfungsi dan melewatkan eksekusi, jadwal berjalan sekali saat Laze kembali. Eksekusi tersebut mencatat berapa banyak yang terlewat. Eksekusi berikutnya kemudian dihitung mulai sekarang.

Jeda, edit, dan hapus jadwal#

Setiap baris di halaman Jadwal memiliki Eksekusi, Edit, Jeda atau Lanjutkan, dan Hapus:

• Eksekusi mencantumkan setiap eksekusi dengan waktu dan hasilnya.
• Jeda menghapus eksekusi berikutnya. Lanjutkan menghitung eksekusi berikutnya mulai sekarang dan tidak mengejar waktu yang dijeda.
• Edit mengubah nama, prompt, waktu, zona, atau percakapan. Jadwal yang dijeda tetap dijeda setelah diedit, dan jadwal satu kali yang selesai berjalan lagi jika Anda memberinya waktu di depan.
• Hapus menghapus jadwal; ia tidak akan pernah berjalan lagi.

Siapa pun yang dapat berbicara dengan agen dapat melihat jadwalnya dan dapat membuat, mengedit, menjeda, melanjutkan, dan menghapusnya: pemiliknya, orang-orang yang berbagi dengannya, dan semua orang untuk agen tim. Orang yang meminta jadwal juga menyimpannya. Orang lain, termasuk admin ruang kerja, tidak melihat jadwal agen; menjadwalkan agen yang tidak dapat Anda ajak bicara ditolak dengan schedule_agent_not_allowed.

Jadwalkan dari baris perintah#

Orang-orang dan agen sama-sama menggunakan laze schedule. Berikan tepat satu dari --cron, --rrule atau --at. Tanpa --tz, zona adalah 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>

Eksekusi sekarang dan eksekusi yang tidak terjadi#

Eksekusi sekarang pada baris jadwal, atau laze schedule run <scheduleId>, menjalankannya sekali segera. Pemicuan berikutnya tidak bergerak.

Jika jadwal terpicu saat agennya tidak terhubung, telah dihapus, atau percakapannya hilang, orang yang menjalankan jadwal akan mendapatkan satu kartu di feed mereka: Your scheduled run "<name>" did not run, dengan alasan dan tombol Eksekusi sekarang. Eksekusi yang terlewat lagi dari jadwal yang sama akan mengembalikan kartu yang sama.

Contoh: rangkuman pagi di feed#

Rangkuman pagi adalah jadwal yang prompt-nya memberitahu agen untuk memposting kartu feed sebagai satu grup. Feed menampilkan grup terbaru di bawah sapaan, dengan satu chip filter per label.

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."

Untuk rangkuman yang lebih besar, bagi pembacaan di antara agen pengumpul. Instal skill brief-scout pada setiap agen pengumpul dan morning-brief pada agen yang menulis rangkuman, lalu jadwalkan agen pengumpul sebelum rangkuman. Setiap agen pengumpul mengunggah laporannya sebagai briefs/<YYYY-MM-DD>/<scout>.md ke saluran yang dibaca rangkuman, dengan bukti setiap item. Agen rangkuman membaca file-file tersebut, menunggu hingga 15 menit untuk yang terlambat, memeriksa setiap item, dan memposting item yang diperiksa sebagai kartu dalam grup. Agen pengumpul yang tidak berjalan memimpin rangkuman, dan pemiliknya juga mendapatkan kartu eksekusi yang terlewat dengan Eksekusi sekarang.

Memposting kartu lagi dengan kunci --loop yang sama memindahkannya ke grup baru dan menunjukkan berapa kali telah dilihat. --auto-send-on <YYYY-MM-DD> menambahkan hitungan mundur dengan tombol Hentikan ke kartu mana pun.

Ketika agen menjalankan laze schedule add dengan kuncinya sendiri, jadwal menargetkan agen tersebut dan dihitung sebagai dibuat oleh pemilik agen. Agen yang diminta dalam chat untuk pekerjaan berulang dapat membuat jadwal dengan cara ini.

Periksa juga: referensi CLI, Agen yang di-hosting.