Cara Menggunakan
- Background Agent Sidebar: Pakai tab background agent di sidebar native Cursor buat lihat semua background agent yang terhubung ke akun lo, cari agent yang udah ada, dan mulai yang baru.
- Background Agent Mode: Pencet buat ngaktifin background agent mode di UI.
Background agent butuh retensi data selama beberapa hari.
Setup
Koneksi GitHub
Konfigurasi Daftar Izin IP
Penyiapan Lingkungan Dasar
- Perintah install berjalan sebelum agent mulai dan memasang dependensi runtime. Ini bisa berarti menjalankan
npm install
ataubazel build
. - Terminal menjalankan proses background saat agent bekerja—misalnya menjalankan server web atau mengompilasi file protobuf.
COPY
seluruh proyek—kami yang mengelola workspace dan checkout commit yang tepat. Tetap lakukan instalasi dependensi di install script.
Masukkan secrets yang diperlukan untuk lingkungan dev kamu—secrets disimpan terenkripsi at rest (menggunakan KMS) di database kami dan disediakan ke environment agent di background.
Penyiapan mesin ada di .cursor/environment.json
, yang bisa kamu commit ke repo (direkomendasikan) atau simpan privat. Alur penyiapan akan memandu kamu membuat environment.json
.
Perintah Maintenance
install
dari environment.json
lo. Perintah ini yang biasa dijalanin developer saat pindah branch—buat install dependency baru.
Buat kebanyakan orang, perintah install
itu npm install
atau bazel build
.
Biar startup mesin cepet, kita nge-cache state disk setelah perintah install
jalan. Rancang biar bisa dijalanin berkali-kali. Cuma state disk yang ke-persist dari perintah install
—proses yang dimulai di sini nggak bakal hidup waktu agent mulai.
Perintah Startup
install
, mesin akan menyala dan kita menjalankan perintah start
, lalu menyalakan semua terminals
. Ini memulai proses yang harus tetap berjalan saat agen aktif.
Perintah start
sering bisa dilewati. Pakai ini kalau environment dev kamu bergantung pada Docker—taruh sudo service docker start
di perintah start
.
terminals
dipakai untuk kode aplikasi. Terminal-terminal ini berjalan dalam sesi tmux
yang bisa diakses kamu dan agen. Misalnya, banyak repo website menaruh npm run watch
sebagai sebuah terminal.
Spesifikasi environment.json
environment.json
bisa berbentuk seperti:
Model
Harga
Keamanan
- Kasih hak akses read-write ke app GitHub kami untuk repo yang mau lo edit. Ini dipakai buat nge-clone repo dan nge-apply perubahan.
- Kode lo jalan di infrastruktur AWS kami dalam VM yang terisolasi dan disimpan di disk VM selama agent masih aktif.
- Agent punya akses internet.
- Agent otomatis ngejalanin semua perintah terminal, biar bisa iterasi di pengujian. Ini beda dari foreground agent, yang butuh persetujuan user untuk setiap perintah. Auto-run bisa memperkenalkan risiko kebocoran data: penyerang bisa ngejalanin prompt injection, ngejebak agent buat mengunggah kode ke situs berbahaya. Lihat penjelasan OpenAI tentang risiko prompt injection untuk background agents.
- Kalau Privacy Mode dimatikan, kami ngumpulin prompt dan environment dev buat ningkatin produk.
- Kalau lo matiin Privacy Mode saat mulai background agent, lalu lo nyalain lagi di tengah jalan, agent bakal lanjut dengan Privacy Mode nonaktif sampai selesai.
Pengaturan dashboard
Pengaturan Default
- Model default – model yang dipakai saat sebuah run nggak nentuin model. Pilih model apa pun yang mendukung Max Mode.
- Repositori default – kalau kosong, agen bakal minta pengguna milih repo. Ngisi repo di sini bikin pengguna bisa lewatin langkah itu.
- Branch dasar – branch yang jadi asal fork agen saat bikin pull request. Biarkan kosong untuk pakai branch default repositori.
Pengaturan Keamanan
- Pembatasan pengguna – pilih Tidak ada (semua member bisa mulai agen latar belakang) atau Allow list. Kalau diset ke Allow list, lo nentuin persis siapa aja rekan tim yang boleh bikin agen.
- Tindak lanjut tim – kalau aktif, siapa pun di workspace bisa nambah pesan tindak lanjut ke agen yang dimulai orang lain. Matikan untuk ngebates tindak lanjut cuma ke pemilik agen dan admin.
- Tampilkan ringkasan agen – ngatur apakah Cursor nampilin gambar file-diff dan potongan kode agen. Nonaktifkan ini kalau lo nggak mau nge-ekspose path file atau kode di sidebar.
- Tampilkan ringkasan agen di kanal eksternal – memperluas toggle sebelumnya ke Slack atau kanal eksternal apa pun yang udah lo sambungin.