Bulut Ajanları
Bulut ajanları aynı agent temellerine dayanır, ancak yerel makinenizde değil, bulutta tam geliştirme ortamlarına sahip yalıtılmış VM'lerde çalışır. Bu geliştirme ortamı, dizüstü bilgisayarınızdaki kuruluma benzer: klonlanmış repolar, yüklenmiş bağımlılıklar, gizli bilgiler, başlatma komutları ve ağ erişimi.
Etkili geliştirme ortamları, agent'lara kod tabanınız ve kuruluşunuz hakkında tam bağlam sağlar; böylece yaptıkları işi test edip doğrulayabilirler.
Neden Bulut ajanlarını kullanmalısınız?
İstediğiniz kadar ajanı paralel olarak çalıştırabilirsiniz ve yerel makinenizin internete bağlı olmasını gerektirmezler.
Kendi sanal makinelerine erişimleri olduğundan, bulut ajanları değiştirilen yazılımı derleyebilir, test edebilir ve onunla etkileşime girebilir. Ayrıca masaüstünü ve tarayıcıyı kontrol etmek için bilgisayarları kullanabilirler. Bulut ajanları MCP sunucularını destekler; bu da onlara veritabanları, API'ler ve üçüncü taraf hizmetler gibi harici araçlara ve veri kaynaklarına erişim sağlar.
Bulut ajanları çoklu repo ortamlarında da çalışabilir. Bir görev ayrı frontend, backend, altyapı veya paylaşılan kütüphane repolarına yayılıyorsa bir tane kullanın. Agent, tüm çalışma alanını inceleyebilir, koordineli değişiklikler yapabilir ve değişiklik yaptığı repolarda pull request'ler açabilir.
Nasıl erişebilirsiniz
Bir depodan herhangi birinin bir bulut ajanı'nı başlatabilmesi için önce bir Cursor hesabı yöneticisinin hesap için kaynak denetimi bağlantısını kurması gerekir. GitHub (Cloud and Enterprise Server), GitLab (Cloud and Self-Hosted), Bitbucket Cloud veya Azure DevOps kurun.
Bulut ajanı'nı çalıştığınız her yerden başlatabilirsiniz:
- Cursor for iOS: Cursor iOS app üzerinden agent başlatın ve yönetin
- Cursor Web: cursor.com/agents üzerinden herhangi bir cihazda agent başlatın ve yönetin
- Cursor Desktop: Agent girdi alanının altındaki açılır menüden Cloud'u seçin
- Slack: Bir agent başlatmak için @cursor komutunu kullanın
- GitHub or Bitbucket: GitHub'da bir PR veya issue'ya ya da Bitbucket'ta bir PR'a
@cursoryorumu ekleyerek bir agent başlatın - Linear: Bir agent başlatmak için @cursor komutunu kullanın
- API: Bir agent başlatmak için API'yi kullanın
Android'de Chrome'da cursor.com/agents adresini açın ve Progressive Web App (PWA) için Uygulamayı Yükle'ye dokunun. Yerel iPhone ve iPad uygulaması ve daha fazla mobil seçenek için Cursor for iOS sayfasına bakın.
Cursor'u Slack'te kullanın
Agent'leri tetikleme ve bildirim alma dahil, Slack entegrasyonunu ayarlama ve kullanma hakkında daha fazla bilgi edinin.
Nasıl çalışır
Depo sağlayıcısı bağlantısı
Bulut ajanları reponuzu GitHub, GitLab, Azure DevOps Services veya Bitbucket Cloud’dan klonlar ve ayrı bir dalda çalışır, ardından devretmeniz için değişiklikleri reponuza gönderir.
Reponuz ile bağımlı repolar veya alt modüller üzerinde okuma-yazma yetkilerine sahip olmanız gerekir.
Ortamlar
Agent'lar, yalnızca çalıştıkları ortamlar kadar yeteneklidir. Kod yazabilen ama test çalıştıramayan, servisleri sorgulayamayan veya API'lere erişemeyen bir agent, işini uçtan uca tamamlayamaz.
bulut ajanlarınız için bir geliştirme ortamı kurmamak, mühendislerinize bilgisayar vermemek gibidir. Bu nedenle ortam kurulumu, bulut ajanlarının verimliliğini artırmak için en önemli adımdır. bulut ajanlarının mühendisler gibi çalışmasını sağlar: kod yazmak, işi test edip doğrulamak ve yazılımı kullanıma sunmak.
Ortamları, agent yönlendirmeli kurulumla, kayıtlı bir anlık görüntüyle veya .cursor/environment.json içindeki bir Dockerfile ile yapılandırabilirsiniz. Başlamak için Cloud agent setup bölümüne bakın. Builds, agent'ların repo ve bağımlılıkları hazır şekilde başlaması için her ortamı arka planda hazırlar.
bulut ajanı kontrol paneli, bir agent'ın hangi ortamı ve Build'i kullandığını ortam ayrıntıları ve sürüm geçmişiyle birlikte gösterir. agent sayfasında, o çalıştırmada kullanılan ortamı incelemek için sayfanın üst kısmındaki depo adının üzerine gelin. Yapılandırma ayrıntıları için Cloud agent setup bölümüne bakın.
Çalışma zamanı ve ortam denetimleri
Cursor, her Cloud Agent için VM sağlama, yalıtım, anlık görüntü, başlatma, çıktı ve kapasiteyi yönetir. Gizli bilgiler ekleyebilir, giden alan adlarını kısıtlayabilir, Tailscale veya benzer bir istemciyle özel ağlara bağlanabilir ve desteklenen source control yolları için private connectivity kullanabilirsiniz.
Ortam ve ağ denetimlerinin tam listesi için Cloud Agent güvenliği ve ağı sayfasına bakın. Self-hosted seçeneğini değerlendiriyorsanız çoğu ekibin neden Cursor Cloud ile başladığı sayfasına bakın.
Modeller
Bulut ajanları, özenle seçilmiş bir model kümesi kullanır. Desteklenen modellerde bağlam penceresi boyutunu seçebilirsiniz.
MCP desteği
Bulut ajanları, ekibiniz için yapılandırılmış MCP (Model Context Protocol) sunucularını kullanabilir. MCP sunucularını cursor.com/agents üzerindeki MCP açılır menüsü aracılığıyla ekleyip yönetin.
Hem HTTP hem de stdio taşıma türleri desteklenir. İhtiyaç duyan MCP sunucuları için OAuth da desteklenir. Kurulum ayrıntıları için cloud agent yetenek sayfasına bakın.
Bulut Ajanları ayrıca, transkriptler, çalıştırma etkinlikleri, ortam ayrıntıları ve kurulum günlükleri dahil çalıştırma tanılamaları için yerleşik bir Cursor Cloud MCP içerir.
Hook desteği
Bulut ajanları, deponuzdaki .cursor/hooks.json dosyasındaki komut tabanlı hook'ları çalıştırır. Kurumsal planlarda ayrıca ekip hook'larını ve kurumsal olarak yönetilen hook'ları da çalıştırırlar.
Bu sayede işler bulutta çalışırken formatlayıcılar, denetim betikleri ve ilke kontrolleri etkin kalır. Desteklenen hook'lar arasında araç ve dosya hook'ları (preToolUse, beforeShellExecution, afterFileEdit) ile yaşam döngüsü hook'ları (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought ve stop) bulunur.
Hook'lar, salt okunur bir ortamda gerçekleştirilen erken keşif amaçlı turlar sırasında çalışmaz; agent yazılabilir bir ortama sahip olduktan sonra çalışmaya başlar. Bazı hook'lar IDE'ye özeldir (Tab hook'ları, workspaceOpen). ~/.cursor/hooks.json içindeki kullanıcı düzeyindeki hook'lar da kullanılamaz; çünkü bulut VM'lerinin yerel home dizininize erişimi yoktur.
Tam destek matrisi ve ayrıntılar için Hook'lar: Cloud agent desteği bölümüne bakın.
Çıktılar ve uzak masaüstü denetimi
bulut ajanları, değişikliklerini göstermek için çıktı içeren, merge etmeye hazır PR'ler üretir. Değiştirilen yazılımı kullanmak için bulut ajanının uzak masaüstünü de denetleyebilirsiniz.
- Çıktılar: Bulut ajanları, ekran görüntüleri, videolar ve loglar üretir; böylece tam olarak nelerin değiştiğini ve bulut ajanının yaptığı işi nasıl doğruladığını görebilirsiniz.
- Uzak masaüstü denetimi: dalı yerelde çekmeden, tam bir development ortamında yazılımı kendiniz test etmek için bulut ajanının masaüstünün denetimini alın. Çalışmaya devam etmesi için denetimi tekrar bulut ajanına bırakın.
Çıktılar, computer use ve uzak masaüstü denetimi hakkında ayrıntılı bilgi için bulut ajanı yetenekleri sayfasına bkz.
Agent'leri ekibinizle paylaşın
Bir agent'in URL'sini ekip arkadaşınızla paylaşın; çalıştırmayı açıp konuşmayı, kod değişikliklerini ve agent'in ürettiği çıktıları görebilir.
Agent'ler, başlatıldıkları Cursor ekibinin üyeleri tarafından görülebilir. Cursor ayrıca her görüntüleyenin depo erişimini de doğrular: bir ekip arkadaşınızın agent'ini açmak için Integrations altında kendi kaynak denetimi hesabınızı bağlayın ve agent'in çalıştığı depoya erişiminiz olduğundan emin olun. Ekip üyeliği tek başına erişim sağlamaz.
Görüntüleme salt okunurdur. Ekip arkadaşlarınızın takip mesajları gönderip işi sürdürmesini sağlamak için bir ekip yöneticisi ekip takip mesajları özelliğini etkinleştirebilir.
İlgili sayfalar
- cloud agent yetenekleri hakkında daha fazla bilgi edinin.
- cloud agent setup hakkında daha fazla bilgi edinin.
- Cloud Agent Builds hakkında daha fazla bilgi edinin.
- cloud agent güvenliği hakkında daha fazla bilgi edinin.
- OIDC tokenları hakkında daha fazla bilgi edinin.
- cloud agent ayarları hakkında daha fazla bilgi edinin.
Faturalandırma
Bulut ajanları, seçilen model için API fiyatlandırmasına göre ücretlendirilir. Bağlam penceresi boyutunu seçebilirsiniz; daha büyük bir bağlam penceresi token kullanımını ve maliyetleri artırabilir. Bunları ilk kez kullanmaya başladığınızda bir harcama limiti belirlemeniz istenir.
Sorun Giderme
- Oturum açtığınızdan ve GitHub, GitLab, Azure DevOps veya Bitbucket hesabınızı bağladığınızdan emin olun.
- Gerekli depo izinlerine sahip olduğunuzu kontrol edin.
- Ücretli bir Cursor planında olmanız gerekir.
- Gizli bilgileri cursor.com/dashboard/cloud-agents adresine eklediğinizden emin olun
- Gizli bilgiler çalışma alanı/ekip kapsamındadır; doğru hesabı kullandığınızdan emin olun
- Yeni gizli bilgiler ekledikten sonra cloud agent'ı yeniden başlatmayı deneyin
- Bu sekmeyi görmüyorsanız gerekli izinlere sahip olduğunuzdan emin olun
Anlık görüntüler temel ortam yapılandırmanızı (kurulu paketler, sistem bağımlılıkları vb.) kaydeder.
Anlık görüntü oluşturma sırasında .env.local dosyalarını içerseniz, bunlar da kaydedilir. Ancak, ortam değişkenlerini yönetmek için Cursor ayarlarındaki Secrets sekmesini kullanmanız önerilir.
- Ekip arkadaşınız sizinle aynı Cursor ekibine ait olmalıdır.
- Kendi kaynak denetimi hesaplarını Integrations altında bağlamaları ve agent'ın çalıştığı depoya erişimlerinin olması gerekir.
- Ayrıntılar için Agent'ları ekibinizle paylaşın bölümüne bkz.
Çalışma alanı yöneticinizin Cursor Slack uygulamasını kurduğunu ve sizin de gerekli izinlere sahip olduğunuzu doğrulayın.
Adlandırma Geçmişi
Bulut ajanları daha önce Background Agents olarak adlandırılıyordu.