Rutinitas

Rutinitas adalah tugas cloud yang tersimpan: sebuah nama, instruksi, model, dan apa yang memulainya. Saat waktunya tiba, Perch memulai agen cloud dengan instruksi Anda sebagai pesan pertama. Rutinitas berjalan di ruang kerja cloud privat, jadi komputer Anda boleh dalam keadaan mati. Setelahnya, Anda membuka chat proses tersebut, membaca apa yang dikerjakannya, dan melanjutkan percakapan jika Anda menginginkan lebih.

Rutinitas cocok untuk pekerjaan yang sebenarnya akan Anda minta berulang kali: tinjauan bug setiap pagi di sebuah repositori, pemeriksaan kotak masuk dukungan setiap hari kerja, ringkasan metrik mingguan, atau pemeriksaan yang dimulai oleh tooling Anda sendiri setelah setiap deploy.

Membuat rutinitas

Atau minta Perch

Di chat Perch Terminal mana pun, di web, di Perch Desktop, atau di CLI, jelaskan rutinitas yang Anda inginkan, atau ketik /schedule (/routines juga bisa). Perch menanyakan apa pun yang masih kurang, lalu menampilkan kartu berisi semua yang akan disimpannya: nama, instruksi lengkap, jadwal dalam zona waktu Anda beserta proses berikutnya, model, koneksi, repositori, dan pengaturan.

Tidak ada yang disimpan sampai Anda menyetujui kartu tersebut. Kartu ini muncul di setiap mode izin, termasuk Take the Wheel, dan Auto Review tidak pernah menyetujuinya untuk Anda. Kecuali Anda menyebutkan yang lain, rutinitas memakai model yang sedang dipakai chat tersebut dan zona waktu perangkat Anda.

Proses milik sebuah rutinitas tidak dapat membuat atau mengubah rutinitas.

Pemicu

Jadwal

Setiap jadwal berjalan dalam zona waktu yang Anda pilih, sehingga pergantian waktu musim panas (daylight saving) tidak menggesernya. Sebuah rutinitas berjalan paling sering sekali per jam, dan jadwal kustom yang akan berjalan lebih sering dari itu ditolak.

API

Gunakan pemicu API untuk memulai rutinitas dari skrip deploy, peringatan pemantauan, atau aplikasi lain. Saat Anda menyimpan, Perch menampilkan token rahasia satu kali. Salin saat itu juga.

Di halaman rutinitas, Trigger from another app menampilkan alamat dan contoh permintaan:

curl -X POST https://chat.perchai.app/api/routines/fire \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "..."}'

• text bersifat opsional, hingga 2,000 karakter. Teks ini sampai ke proses sebagai data, tidak pernah sebagai perintah, sehingga Perch hanya memakainya sesuai yang dikatakan instruksi Anda. Contohnya: "Teks peringatan terlampir. Temukan penyebabnya di repo."
• Perch menjawab dengan 202 beserta runId dan chatUrl dari proses baru tersebut.
• Satu rutinitas dapat dimulai dengan cara ini hingga 30 kali per jam.
• Make a new token mengganti token, dan token lama berhenti berfungsi. Delete token menonaktifkan pemicu API.

Jalankan sekarang

Setiap rutinitas memiliki Run now di halamannya, apa pun pemicunya. Pilih Add a note terlebih dahulu untuk mengirim teks tambahan bersama proses yang satu itu.

Pengaturan

Koneksi

Rutinitas hanya dapat memakai koneksi yang Anda tambahkan di tab ini. Tidak ada yang dipilihkan untuk Anda. Anda dapat menambahkan aplikasi apa pun yang sudah Anda hubungkan di Settings › Connections, hingga 10 per rutinitas.

Rutinitas berjalan di cloud, sehingga server MCP lokal yang dikonfigurasi di komputer Anda tidak tersedia untuknya, sama seperti untuk agen cloud mana pun.

Perilaku

• Ask before risky actions adalah default. Sebuah proses menunggu persetujuan Anda sebelum melakukan apa pun yang berisiko, dan statusnya menjadi Waiting for you. Halaman Rutinitas menampilkan A run is waiting for your approval dengan tombol Review yang membuka chat-nya. Persetujuan yang tidak dijawab selama 24 jam akan kedaluwarsa.
• Run without asking memungkinkan Perch melakukan apa yang dikatakan instruksi tanpa berhenti, termasuk membuat perubahan melalui koneksinya. Gunakan untuk tugas yang sudah pernah Anda lihat berjalan.
• New chat each run adalah default. Keep one chat membuat setiap proses melanjutkan proses sebelumnya, sehingga proses itu bisa memberi tahu Anda apa yang berubah sejak saat itu.

Notifikasi

Tell me menentukan kapan Anda diberi tahu tentang sebuah proses:

• After every run (default)
• Only when there's something to report. Setiap proses menyatakan apakah proses itu menemukan sesuatu. Proses yang tidak menemukan apa pun menampilkan Nothing to report dan tidak memberi tahu Anda.
• Only when a run fails
• Never

Di bawahnya, pilih Phone notification, Email, atau keduanya. Notifikasi ponsel memerlukan Perch di Layar Utama Anda. Email tersebut menyebutkan nama rutinitas dan hasilnya, diawali dengan bagian awal jawaban, dan menautkan ke chat-nya.

Kecuali Tell me diatur ke Never, Perch selalu mengirimi Anda email saat sebuah proses gagal, menunggu persetujuan Anda, atau tidak dapat dimulai, bahkan jika Email tidak dicentang.

Memantau rutinitas Anda

Daftar Rutinitas menampilkan jadwal setiap rutinitas, proses berikutnya, bagaimana proses terakhirnya berjalan, dan sakelar nyala/mati. Sebuah penghitung menandai hasil yang belum Anda buka.

Buka sebuah rutinitas untuk melihat proses-prosesnya: kapan masing-masing dimulai, apa yang memulainya (Schedule, API, atau Run now), bagaimana hasilnya, dan berapa lama waktunya. Open chat membuka chat sebuah proses. Chat rutinitas tidak masuk ke daftar chat Anda, sehingga rutinitas yang berjalan setiap jam tidak menenggelamkan pekerjaan Anda yang lain. Masing-masing adalah chat cloud biasa: ajukan pertanyaan lanjutan, jawab permintaan persetujuan, atau tinjau branch di panel Changes.

Proses terjadwal dilewati, dan proses berikutnya tetap berjalan sesuai rencana, jika:

• Proses terakhir rutinitas tersebut masih berjalan. Dua proses dari satu rutinitas tidak pernah dimulai pada saat yang sama.
• Proses terakhir sedang menunggu persetujuan Anda dan rutinitas tersebut mempertahankan satu chat.
• Perch tidak dapat memulainya dalam 30 menit setelah waktunya.
• Anda sudah menjalankan tiga proses cloud selama 30 menit setelah waktunya.
• Anda sudah mencapai batas harian proses cloud, atau sudah memakai jam ruang kerja cloud untuk periode ini.

Untuk mengubah rutinitas, buka rutinitas itu lalu pilih Edit dari menu More actions. Sakelarnya menonaktifkan dan mengaktifkannya kembali. Delete menghapus rutinitas tetapi tetap menyimpan chat-nya.

Jika model sebuah rutinitas tidak lagi tersedia, Perch menonaktifkan rutinitas tersebut dan memberi tahu Anda, alih-alih mengganti model sendiri. Pilih model lain, lalu aktifkan kembali.

Penggunaan dan batas

• Hingga 20 rutinitas dapat aktif sekaligus.
• Paling sering sekali per jam untuk setiap rutinitas.
• Setiap proses adalah proses agen cloud. Penggunaan model dihitung ke batas normal paket Anda, dan waktu ruang kerja dihitung ke 30 jam waktu ruang kerja cloud per periode penagihan. Proses rutinitas berbagi batas tiga proses cloud sekaligus dengan chat cloud Anda yang lain.

Pemecahan masalah

Saya tidak melihat Routines. Rutinitas tersedia di Pro. Pastikan Anda masuk ke akun Pro Anda.

Jadwal saya ditolak. Rutinitas dapat berjalan paling sering sekali per jam, dan waktu Once harus di masa mendatang.

Sebuah proses menampilkan Skipped. Alasannya ditampilkan di sebelahnya. Daftar di atas menjelaskan masing-masing alasan.

Saya tidak menerima email. Pastikan Tell me tidak diatur ke Never, lalu periksa folder spam Anda. Jika Perch tidak dapat mengirim email saat ini, halaman rutinitas akan memberitahukannya.