Arka plan ajanları ile uzak bir ortamda kod düzenleyen ve çalıştıran asenkron ajanlar oluşturun. Durumlarını görüntüleyin, takip mesajları gönderin veya istediğiniz zaman kontrolü elinize alın.

​
Nasıl Kullanılır

  1. Arka plan aracı kontrol panelini açmak için tuşuna basın; bu panel aracıları listeler, yenilerini oluşturur ve durumu görüntüler.
  2. Bir komut gönderdikten sonra, durumu görüntülemek ve makineye girmek için listeden aracınızı seçin.

Arka plan aracıları birkaç gün düzeyinde veri saklama gerektirir.

​
Geri Bildirim

Geri bildiriminizi Discord #background-agent kanalımıza veya background-agent-feedback@cursor.com adresine gönderin. Lütfen hataları, özellik isteklerini veya fikirlerinizi paylaşın.

​
Kurulum

Arka plan ajanları varsayılan olarak izole edilmiş ubuntu tabanlı bir makinede çalışır. Ajanların internet erişimi vardır ve paket yükleyebilirler.

​
GitHub bağlantısı

Arka plan ajanları repo’nuzu GitHub’dan klonlar ve ayrı bir dalda çalışarak kolay devir için repo’nuza push yapar. Repo’nuza (ve bağımlı repo’lara veya alt modüllere) okuma-yazma yetkisi verin. Gelecekte diğer sağlayıcıları (GitLab, BitBucket, vb.) destekleyeceğiz.

​
Temel Ortam Kurulumu

Gelişmiş durumlar için ortamı kendiniz kurun. Uzak makineye bağlı bir IDE örneği edinin. Makinenizi kurun, araçları ve paketleri yükleyin, ardından bir anlık görüntü alın. Çalışma zamanı ayarlarını yapılandırın:
  • Install komutu bir ajan başlamadan önce çalışır ve çalışma zamanı bağımlılıklarını yükler. Bu npm install veya bazel build çalıştırmak anlamına gelebilir.
  • Terminaller ajan çalışırken arka plan süreçlerini çalıştırır - web sunucusu başlatmak veya protobuf dosyalarını derlemek gibi.
En gelişmiş durumlar için makine kurulumu için bir Dockerfile kullanın. Dockerfile sistem düzeyinde bağımlılıkları kurmanıza olanak tanır: belirli derleyici sürümlerini, hata ayıklayıcıları yükleyin veya temel OS görüntüsünü değiştirin. Tüm projeyi COPY etmeyin - çalışma alanını yönetir ve doğru commit’i kontrol ederiz. Bağımlılık yüklemesini yine de install script’inde halledin. Geliştirme ortamınız için gerekli gizli anahtarları girin - bunlar veritabanımızda şifrelenmiş olarak saklanır (KMS kullanarak) ve arka plan ajan ortamında sağlanır. Makine kurulumu .cursor/environment.json dosyasında bulunur, bu dosya repo’nuzda commit edilebilir (önerilen) veya özel olarak saklanabilir. Kurulum akışı environment.json oluşturma konusunda size rehberlik eder.

​
Bakım Komutları

Yeni bir makine kurarken temel ortamdan başlarız, ardından environment.json dosyanızdaki install komutunu çalıştırırız. Bu komut bir geliştiricinin dal değiştirirken çalıştıracağı komuttur - yeni bağımlılıkları yükler. Çoğu kişi için install komutu npm install veya bazel build’dir. Hızlı makine başlatmasını sağlamak için install komutu çalıştıktan sonra disk durumunu önbelleğe alırız. Birden çok kez çalışacak şekilde tasarlayın. install komutundan yalnızca disk durumu kalıcıdır - burada başlatılan süreçler ajan başladığında canlı olmayacaktır.

​
Başlatma Komutları

install çalıştırdıktan sonra makine başlar ve start komutunu çalıştırır, ardından terminals başlatırız. Bu, ajan çalışırken canlı olması gereken süreçleri başlatır. start komutu genellikle atlanabilir. Geliştirme ortamınız docker’a dayanıyorsa kullanın - start komutuna sudo service docker start koyun. terminals uygulama kodu içindir. Bu terminaller size ve ajana sunulan bir tmux oturumunda çalışır. Örneğin, birçok web sitesi repo’su terminal olarak npm run watch koyar.

​
environment.json Spesifikasyonu

environment.json dosyası şöyle görünebilir: 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
Resmi olarak, spesifikasyon burada tanımlanmıştır.

​
Modeller

Arka plan ajanları için yalnızca Max Mode uyumlu modeller kullanılabilir.

​
Fiyatlandırma

Background Agent fiyatlandırması hakkında daha fazla bilgi edinin.

​
Güvenlik

Background Agents, Gizlilik Modunda kullanılabilir. Kodunuz üzerinde asla eğitim yapmayız ve kodu yalnızca ajanı çalıştırmak için saklarız. Gizlilik modu hakkında daha fazla bilgi edinin. Bilmeniz gerekenler:
  1. Düzenlemek istediğiniz repolar için GitHub uygulamamıza okuma-yazma yetkisi verin. Bunu repoyu klonlamak ve değişiklik yapmak için kullanırız.
  2. Kodunuz, AWS altyapımızda izole edilmiş VM’lerde çalışır ve ajan erişilebilir durumdayken VM disklerinde saklanır.
  3. Ajan internet erişimine sahiptir.
  4. Ajan tüm terminal komutlarını otomatik olarak çalıştırır, böylece testler üzerinde iterasyon yapabilir. Bu, her komut için kullanıcı onayı gerektiren ön plan ajandan farklıdır. Otomatik çalıştırma, veri sızdırma riski getirir: saldırganlar prompt enjeksiyon saldırıları gerçekleştirerek ajanı kandırıp kodu kötü niyetli web sitelerine yükletebilir. OpenAI’nin background agents için prompt enjeksiyon riskleri hakkındaki açıklamasına bakın.
  5. Gizlilik modu devre dışıysa, ürünü geliştirmek için prompt’ları ve geliştirme ortamlarını topluyoruz.
  6. Background agent başlatırken gizlilik modunu devre dışı bırakır, ardından ajanın çalışması sırasında etkinleştirirseniz, ajan tamamlanana kadar gizlilik modu devre dışı olarak çalışmaya devam eder.