Dengan background agents, jalankan agen asinkron yang mengedit dan menjalankan kode dalam lingkungan remote. Lihat status mereka, kirim tindak lanjut, atau ambil alih kapan saja.

​
Cara Menggunakan

  1. Tekan untuk membuka panel kontrol agen latar belakang untuk melihat daftar agen, membuat yang baru, dan melihat status.
  2. Setelah mengirimkan prompt, pilih agen Anda dari daftar untuk melihat status dan masuk ke mesin.

Agen latar belakang memerlukan penyimpanan data selama beberapa hari.

​
Umpan Balik

Kirim umpan balik ke channel Discord #background-agent kami atau background-agent-feedback@cursor.com. Silakan kirim bug, permintaan fitur, atau ide.

​
Pengaturan

Agen latar belakang berjalan dalam mesin berbasis ubuntu yang terisolasi secara default. Agen memiliki akses internet dan dapat menginstal paket.

​
Koneksi GitHub

Agen latar belakang mengkloning repo Anda dari GitHub dan bekerja pada branch terpisah, mendorong ke repo Anda untuk handoff yang mudah. Berikan hak akses baca-tulis ke repo Anda (dan repo atau submodul yang bergantung). Kami akan mendukung penyedia lain (GitLab, BitBucket, dll) di masa depan.

​
Pengaturan Environment Dasar

Untuk kasus lanjutan, atur environment sendiri. Dapatkan instance IDE yang terhubung ke mesin remote. Atur mesin Anda, instal tools dan paket, kemudian ambil snapshot. Konfigurasi pengaturan runtime:
  • Perintah Install berjalan sebelum agen dimulai dan menginstal dependensi runtime. Ini mungkin berarti menjalankan npm install atau bazel build.
  • Terminal menjalankan proses latar belakang saat agen bekerja - seperti memulai web server atau mengkompilasi file protobuf.
Untuk kasus yang paling lanjutan, gunakan Dockerfile untuk pengaturan mesin. Dockerfile memungkinkan Anda mengatur dependensi tingkat sistem: menginstal versi compiler tertentu, debugger, atau mengganti image OS dasar. Jangan COPY seluruh proyek - kami mengelola workspace dan checkout commit yang benar. Tetap tangani instalasi dependensi dalam script install. Masukkan secret yang diperlukan untuk dev environment Anda - mereka disimpan terenkripsi-at-rest (menggunakan KMS) dalam database kami dan disediakan dalam environment agen latar belakang. Pengaturan mesin berada di .cursor/environment.json, yang dapat di-commit dalam repo Anda (direkomendasikan) atau disimpan secara pribadi. Alur pengaturan memandu Anda melalui pembuatan environment.json.

​
Perintah Maintenance

Saat mengatur mesin baru, kami mulai dari environment dasar, kemudian menjalankan perintah install dari environment.json Anda. Perintah ini adalah apa yang akan dijalankan developer saat mengganti branch - menginstal dependensi baru apa pun. Untuk kebanyakan orang, perintah install adalah npm install atau bazel build. Untuk memastikan startup mesin yang cepat, kami menyimpan cache state disk setelah perintah install berjalan. Rancang agar dapat berjalan beberapa kali. Hanya state disk yang bertahan dari perintah install - proses yang dimulai di sini tidak akan hidup saat agen dimulai.

​
Perintah Startup

Setelah menjalankan install, mesin dimulai dan kami menjalankan perintah start diikuti dengan memulai terminals apa pun. Ini memulai proses yang harus hidup saat agen berjalan. Perintah start sering dapat dilewati. Gunakan jika dev environment Anda bergantung pada docker - letakkan sudo service docker start dalam perintah start. terminals adalah untuk kode aplikasi. Terminal ini berjalan dalam sesi tmux yang tersedia untuk Anda dan agen. Misalnya, banyak repo website menempatkan npm run watch sebagai terminal.

​
Spesifikasi environment.json

File environment.json dapat terlihat seperti: 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
Secara formal, spesifikasinya didefinisikan di sini.

​
Model

Hanya model yang kompatibel dengan Max Mode yang tersedia untuk agen latar belakang.

​
Harga

Pelajari lebih lanjut tentang harga Background Agent.

​
Keamanan

Background Agents tersedia dalam Privacy Mode. Kami tidak pernah melatih model dengan kode Anda dan hanya menyimpan kode untuk menjalankan agent. Pelajari lebih lanjut tentang Privacy mode. Yang perlu Anda ketahui:
  1. Berikan hak akses baca-tulis kepada aplikasi GitHub kami untuk repositori yang ingin Anda edit. Kami menggunakan ini untuk mengkloning repositori dan membuat perubahan.
  2. Kode Anda berjalan di dalam infrastruktur AWS kami dalam VM yang terisolasi dan disimpan di disk VM selama agent dapat diakses.
  3. Agent memiliki akses internet.
  4. Agent secara otomatis menjalankan semua perintah terminal, memungkinkannya untuk melakukan iterasi pada pengujian. Ini berbeda dari foreground agent, yang memerlukan persetujuan pengguna untuk setiap perintah. Menjalankan secara otomatis menimbulkan risiko eksfiltrasi data: penyerang dapat melakukan serangan prompt injection, menipu agent untuk mengunggah kode ke situs web berbahaya. Lihat penjelasan OpenAI tentang risiko prompt injection untuk background agents.
  5. Jika privacy mode dinonaktifkan, kami mengumpulkan prompt dan lingkungan pengembangan untuk meningkatkan produk.
  6. Jika Anda menonaktifkan privacy mode saat memulai background agent, kemudian mengaktifkannya selama agent berjalan, agent akan terus berjalan dengan privacy mode dinonaktifkan hingga selesai.