PerchAI
Menggunakan Perch

Perintah garis miring

Cara benar-benar memakai setiap perintah garis miring di Perch Terminal dan CLI, apa yang Anda dapatkan, dan kapan sebaiknya memakainya alih-alih sekadar bertanya.

Perintah garis miring adalah instruksi langsung kepada Perch itu sendiri, bukan tugas untuk model. Ketik / di prompt dan daftarnya akan muncul. Sebagian besar adalah kontrol sesi yang cepat, tetapi lima di antaranya mengerjakan pekerjaan sungguhan: /goal berjalan secara otonom lintas banyak giliran, /verify memeriksa ulang jawaban terhadap sumber Anda, /deepresearch meriset sebuah pertanyaan dalam beberapa putaran dan mengembalikan laporan bersitasi, /delegate menyerahkan tugas ke agen latar belakang, dan /flock menjalankan tim worker.

Halaman ini menjelaskan kapan memakai masing-masing perintah dan apa yang terjadi saat Anda memakainya. Untuk daftar ringkas semua perintah dan flag, lihat referensi CLI.

Tempat perintah ini berfungsi

Perintah garis miring berjalan di Perch Terminal (aplikasi desktop dan app.perchai.app) dan di CLI. Chat web tidak memilikinya. Beberapa perintah khusus untuk satu platform, seperti dicatat di bawah.

/goal

/goal adalah perintah yang kurang dimanfaatkan banyak orang. Giliran biasa mengerjakan apa yang Anda minta lalu berhenti, dan jika pekerjaannya butuh dua belas langkah, Anda harus terus mengetik "continue". /goal menetapkan tujuan yang dikejar Perch sendiri dari giliran ke giliran, dengan memanggil dirinya lagi sampai audit penyelesaian lolos atau anggarannya habis.

Gunakan saat pekerjaannya punya banyak langkah dan garis akhir yang bisa Anda jelaskan dengan kata-kata:

/goal make the test suite pass
/goal reconcile every invoice in this folder against the GL and write up the exceptions

Jangan gunakan untuk satu pertanyaan saja. Goal yang sebenarnya cukup satu giliran hanya menambah langkah audit.

Memantau dan mengarahkannya

Setelah goal berjalan, Anda melihat setiap giliran saat terjadi, beserta panggilan tool-nya. Kontrolnya:

PerintahFungsinya
/goalMenampilkan goal saat ini: status, jumlah giliran yang terpakai, dan alasan terakhir kali berhenti.
/goal pauseMenjeda goal tanpa kehilangannya.
/goal resumeMelanjutkan goal dari titik berhentinya.
/goal clearMembuang goal sepenuhnya. stop, off, cancel, dan reset juga berfungsi.

/goal status sama dengan /goal saja, dan /goal continue sama dengan /goal resume.

Kapan sebuah proses berhenti

Goal tidak pernah berjalan selamanya. Goal berakhir karena salah satu alasan berikut, dan Perch memberi tahu alasannya:

BerhentiArtinya
CompleteAudit penyelesaian lolos. Pekerjaannya selesai.
BudgetMencapai 40 giliran atau 4 jam waktu nyata. Yang Anda miliki adalah progres parsial.
No progressGiliran terakhir tidak membuat panggilan tool dan tidak lolos audit, jadi goal berhenti alih-alih berputar tanpa hasil.
BlockedSebuah tindakan memerlukan persetujuan Anda.
FailedSebuah giliran mengalami error.
CancelledAnda menghentikannya dengan Ctrl-C di CLI atau Esc di aplikasi desktop.

Kecuali Complete, semuanya bisa dilanjutkan dengan /goal resume.

Mode izin berpengaruh di sini

Inilah yang sering mengejutkan orang. Dalam mode izin Default, penulisan atau perintah pertama akan berhenti menunggu persetujuan Anda, lalu goal melaporkan Blocked dan berhenti. Itu perilaku yang benar, tetapi artinya goal yang dibiarkan berjalan semalaman tanpa pengawasan dalam mode Default tidak akan berjalan jauh.

Jika Anda ingin goal berjalan saat Anda tidak ada, gunakan Auto Review (pekerjaan yang dapat dibatalkan berjalan sendiri, tindakan yang tidak dapat dibatalkan tetap bertanya) atau Take the Wheel (otonomi penuh). Lihat mode izin untuk apa yang diizinkan setiap mode.

Tetap ada meski Anda keluar

Goal disimpan bersama thread-nya, jadi goal bertahan lebih lama dari sesinya. Keluar dari CLI, tutup aplikasi desktop, atau muat ulang halaman, lalu kembali ke folder atau thread yang sama dan jalankan /goal resume. Tujuan dan jumlah gilirannya masih ada.

Ada dua konsekuensi dari goal yang berlaku per thread. Goal yang ditetapkan di thread milik satu folder tidak terlihat dari folder lain, karena CLI membatasi thread default ke direktori kerja Anda. Selain itu, menjalankan /goal lagi dengan teks tujuan yang persis sama akan melanjutkan goal yang ada alih-alih mereset hitungannya, sedangkan teks yang berbeda memulai goal baru.

/verify

/verify memeriksa ulang klaim dalam sebuah jawaban terhadap sumber Anda yang sudah diindeks. Perintah ini murni retrieval, tanpa panggilan model di baliknya, itulah sebabnya hasilnya cepat dan tidak memakai token.

/verify                  # check the last answer Perch gave
/verify <paste text>     # check text you wrote or pasted
/verify --changed        # re-check only what moved since your last check

Anda mendapatkan rekap jumlah lalu satu baris per klaim:

Citation check — 6 claims in the last answer checked against your sources
✓ 4 verified · ~ 1 uncertain · ✗ 1 not found

✓ berarti ada sumber yang mendukung klaim tersebut, ~ berarti kecocokannya cukup lemah sehingga Anda sebaiknya memeriksanya, dan ✗ berarti tidak ada apa pun di sumber Anda yang mendukungnya. Baris ✗ adalah alasan perintah ini ada. Jalankan setelah Perch menyusun draf apa pun yang memuat sitasi, dan sebelum draf itu lepas dari tangan Anda.

--changed, dan apa itu checkpoint

/verify --changed menjawab pertanyaan yang lebih sempit: sejak terakhir saya memeriksa, apakah ada sumber yang berubah tanpa saya sadari, dan apakah ada yang saya andalkan yang kini tidak lagi berlaku?

Detail kuncinya adalah bahwa eksekusi /verify terakhir Anda adalah checkpoint-nya. Tidak ada perintah terpisah untuk menetapkannya. Setiap pemeriksaan mencatat sumber yang diandalkannya, sehingga eksekusi --changed berikutnya hanya memeriksa ulang klaim yang sumbernya benar-benar berubah dan membiarkan sisanya. Jika Anda belum pernah menjalankan /verify di thread tersebut, --changed tidak punya pembanding dan akan menyatakannya.

Hasilnya diawali dengan regresi, yaitu klaim yang menjadi lebih lemah, karena hanya bagian itulah yang menuntut tindakan dari Anda. --since-last adalah alias jika menurut Anda itu lebih mudah dibaca.

/deepresearch

/deepresearch ditujukan untuk pertanyaan yang memerlukan lebih dari satu kali pencarian. Perintah ini memecah pertanyaan menjadi subpertanyaan, mencari di file Anda yang sudah diindeks dan di web (termasuk sumber khusus jika sesuai), membaca apa yang ditemukannya dalam beberapa putaran, lalu kembali dengan laporan bersitasi beserta daftar klaim (claim ledger).

/deepresearch what changed in EU AI Act enforcement this year
/deepresearch --rounds 5 does creatine improve strength in trained adults
/deepresearch --web only use the public web for this merger timeline

/research dan /deep-research adalah perintah yang sama. Gunakan saat Anda menginginkan jawaban hasil riset dengan sumber yang bisa Anda periksa, bukan balasan chat singkat. Jangan gunakan untuk pencarian satu baris atau untuk tugas bergaris akhir yang lebih cocok untuk /goal.

Flag

FlagFungsinya
--rounds NMenetapkan anggaran putaran dari 1 sampai 6. Default-nya 3. -r dan --rounds=N juga berfungsi.
--webMelewati file ruang kerja Anda dan meriset hanya di web publik. --web-only sama saja.
--resumeMelanjutkan proses yang diparkir setelah interupsi paksa. --continue sama saja.

/deepresearch tanpa pertanyaan mencetak bantuan dan tidak memakai penggunaan. Jika ada proses yang menunggu untuk dilanjutkan, perintah ini juga memberitahukannya.

Yang Anda dapatkan

Balasan chat berisi laporan, daftar sumber bernomor, dan daftar klaim. Daftar klaim terdiri dari tiga tingkat: didukung oleh file Anda, hanya dari web, atau tidak didukung. Balasan menyoroti klaim yang didukung dan yang tidak didukung; catatan lengkapnya memuat ketiganya.

Di desktop dan CLI, Perch juga menulis file markdown di bawah perch-research/ yang berisi laporan lengkap, rencana, setiap sumber, dan daftar klaim lengkap. File itu adalah catatan permanen dari proses tersebut.

Melanjutkan, dan kapan kedaluwarsa

Interupsi paksa akan memarkir proses agar Anda bisa melanjutkannya dengan /deepresearch --resume. Anda punya waktu sekitar 45 menit. Setelah itu, proses yang diparkir kedaluwarsa, dan Anda memulai lagi dengan pertanyaan aslinya. Pembatalan normal (graceful cancel) justru menulis laporan parsial dan tidak menyisakan apa pun untuk dilanjutkan.

--web berarti tidak akan ada klaim yang didukung oleh file Anda. Jika belum ada isi folder yang diindeks, hal yang sama berlaku sampai Anda mengindeks satu file.

/delegate

/delegate <task> menyerahkan tugas yang cakupannya jelas ke agen latar belakang dan mengembalikan prompt kepada Anda. Agen berjalan secara asinkron dan mengembalikan hasilnya untuk ditinjau, sehingga pekerjaan panjang tidak pernah memblokir sesi yang sedang Anda pakai. /bg <task> adalah perintah yang sama dengan ketikan lebih sedikit.

/delegate summarize every PDF in ./contracts and list the renewal dates

Gunakan saat tugasnya berdiri sendiri dan Anda lebih suka terus bekerja daripada menontonnya berjalan. Jika tugas itu memerlukan masukan Anda di tengah jalan, atau Anda ingin mengarahkannya, tetap kerjakan di sesi utama.

/flock

/flock <task> menjalankan tim worker untuk satu tugas sulit dan meminta worker pemeriksa memverifikasi hasilnya sebelum Anda melihatnya. Perintah ini masih eksperimental dan tidak muncul di menu perintah, tetapi berfungsi di aplikasi desktop dan CLI.

/flock review this branch for regressions and verify the tests

Perintah ini dibuat untuk pekerjaan yang tidak cukup diselesaikan dalam satu kali jalan, dan menolak tugas kecil sebelum dimulai karena giliran biasa lebih cepat. Lihat Flock untuk cara tim direncanakan dan dijalankan.

Perintah sesi

Perintah ini tidak menjalankan tugas, melainkan mengubah atau menampilkan sesuatu tentang sesi.

PerintahFungsinyaTempat
/model [tier|name]Menampilkan atau menentukan model Anda: tingkatan Roost, atau model tertentu yang disematkan. Lihat tingkatan model.Keduanya
/usageMenampilkan penggunaan Perch Token yang sudah termasuk dalam paket Anda dan penggunaan sesi ini.Keduanya
/compactMeringkas giliran lama untuk mengosongkan ruang di jendela konteks.Desktop
/contextMenampilkan meteran konteks dan detail pemadatan (compaction).CLI
/persona [saffron|quill]Menampilkan atau mengganti gaya bahasa. Lihat Persona.CLI
/mode [ask|agents|plan]Menampilkan atau menentukan mode chat.CLI
/permission [mode]Menampilkan atau menentukan seberapa banyak yang dapat dilakukan Perch tanpa bertanya.CLI
/thinking [on|off]Menampilkan status atau mengaktifkan/menonaktifkan extended thinking untuk model yang dipilih.CLI
/local-tools [on|off]Menampilkan status atau mengaktifkan/menonaktifkan tool shell dan file lokal.CLI
/cwd [dir]Menampilkan atau mengganti direktori kerja.CLI
/thread [new|id]Menampilkan, mereset, atau menentukan id thread saat ini.CLI
/skills [name]Menampilkan daftar skill inti Perch, atau menampilkan isi satu skill.CLI
/memory-audit <text>Memeriksa apakah sebuah catatan akan disimpan ke memori, dan alasannya. Lihat Memori.CLI
/statusMenampilkan cwd, autentikasi, mode, persona, izin, dan thread.CLI
/clearMenghapus memori percakapan lokal dari sesi terminal ini.CLI
/helpMenampilkan daftar perintah lengkap.CLI
/login, /logoutMasuk melalui OAuth di browser, atau menghapus autentikasi yang tersimpan.CLI
/exitKeluar dari CLI.CLI

Selagi Perch bekerja

Anda tidak perlu menunggu giliran selesai untuk mengarahkannya. Ketik teks lalu tekan Enter untuk menambahkan arahan di tengah giliran. Ctrl-C menghentikan giliran saat ini di CLI, dan Ctrl-E membuka detail.

Langkah berikutnya