Arka plan agent’larıyla, uzak bir ortamda kodu düzenleyip çalıştıran eşzamansız agent’lar başlat. Durumlarını gör, takip mesajları gönder veya istediğin zaman kontrolü devral.

​
Nasıl Kullanılır

Arka plan ajanlarına iki şekilde erişebilirsin:
  1. Background Agent Kenar Çubuğu: Hesabınla ilişkili tüm arka plan ajanlarını görmek, mevcut ajanları aramak ve yenilerini başlatmak için yerel Cursor kenar çubuğundaki background agent sekmesini kullan.
  2. Background Agent Modu: Arayüzde background agent modunu açmak için tuşuna bas.
Bir istem gönderdikten sonra, durumunu görmek ve makineye girmek için listeden ajanını seç.

Arka plan ajanları birkaç günlük veri saklamayı gerektirir.

​
Geri Bildirim

Geri bildirimlerini Discord’daki #background-agent kanalımıza ya da background-agent-feedback@cursor.com adresine gönder. Lütfen hataları, özellik taleplerini veya fikirlerini paylaş.

​
Kurulum

Arka plan ajanları varsayılan olarak izole bir Ubuntu tabanlı makinede çalışır. Ajanların internet erişimi vardır ve paket kurabilirler.

​
GitHub bağlantısı

Arka plan ajanları repounu GitHub’dan klonlar, ayrı bir branch’te çalışır ve kolay devretme için repouna push eder. Repouna (ve bağlı repolar ya da submodule’lere) okuma-yazma yetkisi ver. Gelecekte diğer sağlayıcıları (GitLab, Bitbucket, vb.) da destekleyeceğiz.
IP Allow List Yapılandırması
Kuruluşun GitHub’ın IP allow list özelliğini kullanıyorsa, arka plan ajanları için erişimi yapılandırman gerekir. İletişim bilgileri ve IP adresleri dahil tam kurulum talimatları için GitHub entegrasyon dokümantasyonuna bak.

​
Temel Ortam Kurulumu

İleri seviye durumlar için ortamı kendin kur. Uzak makineye bağlı bir IDE instance’ı edin. Makineyi hazırla, araçları ve paketleri yükle, sonra bir snapshot al. Çalışma zamanı ayarlarını yapılandır:
  • install komutu, bir ajan başlamadan önce çalışır ve çalışma zamanı bağımlılıklarını kurar. Bu, npm install veya bazel build çalıştırmak olabilir.
  • Terminaller, ajan çalışırken arka plan süreçlerini çalıştırır — bir web sunucusu başlatmak ya da protobuf dosyalarını derlemek gibi.
Daha ileri durumlarda, makine kurulumu için bir Dockerfile kullan. Dockerfile sistem düzeyi bağımlılıkları ayarlamana izin verir: belirli derleyici sürümlerini kurmak, hata ayıklayıcılar eklemek ya da temel OS imajını değiştirmek. Tüm projeyi COPY etme — çalışma alanını biz yönetiyoruz ve doğru commit’i checkout ediyoruz. Bağımlılık kurulumunu yine install script’inde ele al. Geliştirme ortamın için gereken tüm secret’ları gir — bunlar veritabanımızda beklemede şifreli (KMS kullanarak) saklanır ve arka plan ajan ortamına sağlanır. Makine kurulumu .cursor/environment.json içinde yer alır; bu dosyayı repouna commit edebilirsin (önerilir) ya da özel olarak saklayabilirsin. Kurulum akışı, environment.json oluşturmanda sana rehberlik eder.

​
Bakım Komutları

Yeni bir makine kurarken temel ortamdan başlarız, ardından environment.json dosyandaki install komutunu çalıştırırız. Bu, bir geliştiricinin branch 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’dür. Makinenin hızlı başlaması için install komutu çalıştıktan sonra disk durumunu önbelleğe alırız. Birden çok kez çalışacak şekilde tasarla. Yalnızca install komutunun ürettiği disk durumu kalıcıdır — burada başlatılan süreçler ajan başladığında çalışır durumda olmayacaktır.

​
Başlangıç Komutları

install çalıştıktan sonra makine başlar ve start komutunu, ardından varsa terminals’ı çalıştırırız. Bu, ajan çalışırken ayakta olması gereken süreçleri başlatır. start komutu çoğu zaman atlanabilir. Geliştirme ortamın Docker’a dayanıyorsa kullan — sudo service docker start komutunu start komutuna koy. terminals uygulama kodu içindir. Bu terminaller, sana ve ajana açık bir tmux oturumunda çalışır. Örneğin, birçok web sitesi reposu bir terminale npm run watch koyar.

​
environment.json Şeması

environment.json dosyası şu şekilde görünebilir: 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
Resmi olarak, şema burada tanımlıdır.

​
Modeller

Arka plan ajanlarında yalnızca Max Mode ile uyumlu modeller kullanılabilir.

​
Fiyatlandırma

Background Agent fiyatlandırması hakkında daha fazlasını öğren.

​
Güvenlik

Background Agents, Gizlilik Modu’nda kullanılabilir. Kodun üzerinde asla eğitim yapmıyoruz ve kodu yalnızca agent’ı çalıştırmak için tutuyoruz. Gizlilik Modu hakkında daha fazlasını öğren. Bilmen gerekenler:
  1. Düzenlemek istediğin repolar için GitHub uygulamamıza okuma-yazma yetkisi ver. Bunu repoyu klonlamak ve değişiklik yapmak için kullanıyoruz.
  2. Kodun, AWS altyapımızda izole VM’lerde çalışır ve agent erişilebilir olduğu sürece VM disklerinde saklanır.
  3. Agent’ın internet erişimi vardır.
  4. Agent tüm terminal komutlarını otomatik olarak çalıştırır; bu da testler üzerinde yineleme yapmasını sağlar. Bu, her komut için kullanıcı onayı gerektiren foreground agent’tan farklıdır. Otomatik çalıştırma veri sızdırma riski doğurur: saldırganlar prompt injection saldırılarıyla agent’ı kandırıp kodu kötü amaçlı sitelere yükletmeye çalışabilir. Arka plan agent’ları için prompt injection riskleri hakkında OpenAI’nin açıklamasına bak.
  5. Gizlilik Modu devre dışıysa, ürünü geliştirmek için prompt’ları ve geliştirme ortamlarını topluyoruz.
  6. Bir background agent başlatırken Gizlilik Modu’nu devre dışı bırakır, sonra agent çalışırken tekrar etkinleştirirsen, agent tamamlanana kadar Gizlilik Modu devre dışı kalmaya devam eder.