A Letaido / docs
DOCUMENTATION

Automasi

Cara kerja Letaido berjalan untuk Anda sesuai jadwal. Ada dua jenis: satu menjalankan program kecil yang dibuat agen untuk Anda; yang lain membangunkan agen dan membiarkannya melakukan pekerjaan itu sendiri.

Anda menjelaskan apa yang ingin dilakukan dan kapan. Agen menulis otomasi, memilih jadwal, meminta persetujuan sekali, dan menjalankannya sejak saat itu. Output setiap eksekusi (stdout, stderr, exit code) disimpan sehingga Anda dapat meninjaunya nanti.

Dua jenis automasi

1. Otomatisasi terskrip

Agen menulis program kecil sekali, lalu menjalankannya untuk Anda sesuai jadwal. Cepat, murah, dan dapat diprediksi: langkah-langkahnya tidak berubah antar eksekusi. Gunakan ketika tugasnya bersifat mekanis dan hasilnya terlihat sama setiap minggu.

Example asks:

  • "Setiap Senin pukul 9, ambil delta kata kunci minggu lalu dan kirim DM kepada saya di Slack."
  • "Pada tanggal 1 setiap bulan, arsipkan data bulan lalu ke dalam arsip laporan."
  • "Setiap jam, segarkan cache Brand Radar agar dashboard langsung dimuat."

2. Otomatisasi agen

Alih-alih menjalankan program yang tersimpan, jadwal membangunkan agen dengan instruksi tertulis (prompt). Agen membacanya dengan segar setiap kali, melihat apa pun yang ada di Workspace Anda saat ini, dan memutuskan cara bertindak, sama seperti yang akan dilakukannya dalam percakapan dengan Anda.

Gunakan ini ketika pekerjaan memerlukan penilaian, ketika situasi berubah di antara eksekusi, atau ketika Anda ingin agen melakukan perbaikan kecil di setiap siklus dan perbaikan tersebut terakumulasi seiring waktu.

Example asks:

  • "Setiap hari pukul 9 UTC, lihat apa yang berubah di ruang kerja dan perbarui wiki tim." (Ini adalah otomatisasi Sinkronisasi wiki dalam daftar di atas, yang dibahas di bagian berikutnya.)
  • "Setiap Jumat sore, lihat data pesaing minggu ini dan beri tahu saya apa yang perlu saya perhatikan pada hari Senin."
  • "Setiap Senin, lihat draf halaman arahan ini, temukan satu peningkatan terbesar, dan terapkan." Jalankan selama beberapa minggu dan halaman tersebut akan menulis ulang dirinya sendiri: lihat apa yang terjadi setelah banyak siklus.

Catatan: Otomasi Agent memerlukan biaya lebih banyak daripada otomasi Scripted (panggilan LLM setiap kali dijalankan, bukan hanya Python biasa), tetapi mereka dapat menangani pekerjaan yang tidak pernah bisa dilakukan oleh skrip.

Automasi terkelola (sudah terpasang oleh Letaido)

Beberapa automasi sudah terinstal di setiap Workspace dan tetap terbaru seiring Letaido menyempurnakannya. Automasi terkelola pertama adalah Wiki sync, sebuah automasi Agent yang berjalan setiap hari dan menjaga memori jangka panjang Workspace Anda di ~/workspace/wiki/ tetap terbaru dengan menyaring sesi chat baru, pengeditan file, dan unggahan.

Folder wiki/ adalah bukti konsep untuk memori jangka panjang workspace: tempat di mana agen mencatat keputusan, entitas bernama, konvensi, dan pekerjaan terkini sehingga chat di masa mendatang dapat melanjutkan dari tempat chat sebelumnya berhenti. Sinkronisasi wiki adalah yang menjaganya tetap terkini tanpa Anda harus ingat untuk memperbaruinya.

Automasi yang dikelola ditandai sebagai preinstalled di tab Automations dan bersifat read-only secara default. Jika Anda ingin menyesuaikannya, klik Customize untuk membuat salinan yang dapat diedit. Salinan Anda tetap berada di workspace Anda; yang asli tetap berjalan dengan pembaruan Letaido.

Trigger (segera hadir)

Saat ini semua automasi dipicu oleh cron. Gelombang berikutnya akan menambahkan Trigger berbasis peristiwa sehingga automasi dapat berjalan ketika sesuatu terjadi di aplikasi yang terhubung: PR GitHub baru dibuka, deal HubSpot berpindah ke Closed-Won, pesan Slack diposting di channel tertentu.

Ini membuka pola seperti:

  • "Setiap kali PR baru dibuka di repo utama kami, jalankan Claude Code dan Codex untuk melakukan tinjauan keamanan, lalu posting ringkasan gabungan di #engineering."
  • "Setiap kali seseorang memposting di #incoming-leads di Slack, cari perusahaan tersebut di Ahrefs dan balas dengan ringkasan konteks 4 baris."

Sampai saat itu, Anda sudah dapat bertindak berdasarkan event pihak ketiga hari ini dengan menggabungkan automasi Scripted yang melakukan polling pada antrian webhook dengan subscription yang dijelaskan di Webhooks & triggers. Slack, GitHub, HubSpot, Linear, Notion, Webflow, dan belasan penyedia lainnya sudah mengirimkan event ke antrian tersebut; script yang dijadwalkan cron hanya mengambilnya dan bertindak.

Kapan meminta otomasi vs satu kali

Bentuk permintaan memberi tahu Anda mana yang Anda inginkan.

  • Jika Anda mengatakan "setiap Senin," "setiap kuartal," "setiap kali X terjadi": otomatisasi.
  • Jika Anda mengatakan "Senin ini," "sekarang juga," "untuk satu URL ini": satu kali chat run.

Sebaliknya, one-off adalah apa pun yang Anda inginkan dilakukan hanya sekali saat ini:

  • "Ambil data minggu lalu dan berikan saya ringkasannya."
  • "Periksa daftar 100 URL ini dan beri tahu saya mana yang mengembalikan 404."

Seperti apa persetujuan itu

Saat pertama kali otomatisasi didaftarkan, Anda akan melihat kartu persetujuan dengan:

  • Nama dan deskripsi satu baris.
  • Jadwal (ekspresi cron).
  • Jenis (Scripted atau Agent).
  • Model dan batas konteks (untuk otomasi Agent).
  • Isi skrip atau isi prompt.

Pemilik atau admin klik sekali. Setelah itu, otomasi berjalan sesuai jadwal. Anda dapat menjeda, melanjutkan, memicu secara manual (Jalankan sekarang), menyesuaikan, atau menghapusnya dari tab Automations.

Jadwal umum

Frekuensi Ekspresi Cron
Setiap 5 menit */5 * * * *
Setiap jam pada :00 0 * * * *
Harian pada 9:00 UTC 0 9 * * *
Senin pada 8:00 UTC 0 8 * * 1
Dua kali sehari (9 AM, 6 PM) 0 9,18 * * *

Waktu Cron menggunakan UTC pada host ini. Jika Anda memerlukan zona waktu lokal, agen akan memilih waktu UTC yang sesuai dengan waktu lokal Anda sepanjang tahun, atau menambahkan penjaga zoneinfo dalam skrip yang hanya aktif ketika waktu lokal berada dalam jendela yang tepat. DST itu menyebalkan; agen akan memberi tahu Anda ketika hal itu terjadi.

Dependensi

Jika sebuah automasi memerlukan paket Python atau konektor yang belum disetujui, agen akan:

  1. Periksa apakah dependensi ada.
  2. Jika tidak, minta pemasangan atau persetujuan konektor melalui alur persetujuan standar.
  3. Tunggu pemilik/admin untuk menyetujui.
  4. Kemudian daftarkan otomasi.

Anda dapat melihat satu kartu persetujuan untuk dependensi, satu untuk otomasi. Agen biasanya mengelompokkan permintaan terkait sehingga Anda cukup mengklik sekali untuk seluruh alur, bukan tiga kali.

Automasi apa saja yang berjalan di ruang kerja ini

Anda dapat melihat daftarnya dari tab Automations di ruang kerja Anda. Situs dokumentasi yang sedang Anda baca ini dikelola oleh tiga di antaranya:

  • Sinkronisasi Wiki (harian, dikelola oleh Letaido): otomatisasi Agent yang membaca sesi chat baru, pengeditan file, dan unggahan, lalu menyaringnya ke dalam wiki ruang kerja di ~/workspace/wiki/. Ini adalah memori jangka panjang yang diandalkan oleh dua otomatisasi berikutnya.
  • Sinkronisasi Docs (setiap 30 menit): otomatisasi Scripted yang membaca markdown dari ~/workspace/docs/, merendernya menjadi HTML, dan mendorongnya ke situs publik sehingga pengunjung melihat versi terbaru dalam waktu setengah jam.
  • Saran pembaruan otomatis Docs (Senin pukul 10:00 Europe/Bucharest): otomatisasi Agent yang membaca wiki, mencantumkan apa yang berubah di ruang kerja dalam seminggu terakhir, dan mengusulkan pengeditan spesifik per bab untuk ditinjau Andrei. Hanya saran; tidak ada publikasi otomatis.

Batas

  • Eksekusi otomasi akan timeout setelah 1 jam. Pekerjaan yang lebih lama harus dibagi menjadi beberapa tahap dan menulis status perantara ke database.
  • stdout dan stderr dibatasi hingga 50 KB per eksekusi. Apa pun yang lebih besar harus disimpan ke file atau baris database.
  • Jadwal dikelola oleh platform setelah persetujuan. Untuk mengubah jadwal, agen mendaftarkan otomasi baru dan menghapus yang lama; tidak mengedit cron secara diam-diam.

Di balik layar. Setiap otomasi adalah baris dalam tabel otomasi platform ditambah entri crontab. Runner menjalankan skrip melalui shell (Scripted) atau memunculkan chat agen baru dengan prompt yang disimpan (Agent) dengan stdin/stdout/stderr yang ditangkap, menetapkan variabel lingkungan ID run, dan menulis kembali catatan run. Jika skrip mengimpor sesuatu yang tidak diinstal secara sistem, run akan gagal dengan cepat disertai kesalahan yang jelas dalam riwayat run.

Last updated 2026-10-02