Background Agents ve Bugbot, depoları klonlamak ve değişiklikleri göndermek için Cursor GitHub uygulamasını gerektirir.

Kurulum

  1. Dashboard > Integrations sayfasına git
  2. GitHub’ın yanındaki Connect düğmesine tıkla
  3. Depoyu seç: All repositories veya Selected repositories
GitHub hesabının bağlantısını kesmek için Integrations dashboard’a geri dön ve Disconnect Account’a tıkla.

GitHub’da Agent Kullanma

GitHub entegrasyonu, pull request’ler ve issue’lar üzerinden arka planda agent iş akışlarını doğrudan çalıştırmanı sağlar. Herhangi bir PR ya da issue’ya @cursor [prompt] yazarak bir agent’ın bağlamı okumasını, düzeltmeleri uygulamasını ve commit’leri push etmesini tetikleyebilirsin. Bugbot etkinse, @cursor fix yazarak Bugbot’un önerdiği düzeltmeyi okuyup sorunu ele alacak bir arka plan agent’ını tetikleyebilirsin.

İzinler

GitHub uygulaması, arka plan ajanlarıyla çalışmak için belirli izinler gerektirir:
İzinAmaç
Depo erişimiKodunu klonlamak ve çalışma dalları oluşturmak
Pull request’lerİncelemene sunulmak üzere ajan değişiklikleriyle PR oluşturmak
IssuesAjanların bulduğu veya düzelttiği hata ve görevleri takip etmek
Kontroller ve durumlarKod kalitesi ve test sonuçlarını raporlamak
Actions ve iş akışlarıCI/CD ardışık düzenlerini ve dağıtım durumunu izlemek
Tüm izinler, arka plan ajanı işlevselliği için gereken asgari ayrıcalık ilkesine göre verilir.

IP Allow List Yapılandırması

Organizasyonun depolarına erişimi kısıtlamak için GitHub’ın IP allow list özelliğini kullanıyorsa, ekibin için IP allow list işlevini etkinleştirmek üzere önce destekle iletişime geçmen gerekiyor.

Destekle İletişime Geç

IP allow list’leri yapılandırmadan önce, bu özelliği ekibin için etkinleştirmek amacıyla hi@cursor.com adresiyle iletişime geç. Bu, aşağıdaki her iki yapılandırma yöntemi için de gereklidir. Cursor GitHub uygulamasının IP listesi önceden yapılandırılmıştır. Yüklü uygulamalar için allow list’i etkinleştirerek bu listeyi otomatik olarak devralabilirsin. Bu, listenin tarafımızdan güncellenmesine olanak tanıdığı ve organizasyonunun güncellemeleri otomatik olarak aldığı için önerilen yaklaşımdır. Bunu etkinleştirmek için:
  1. Organizasyonunun Security ayarlarına git
  2. IP allow list ayarlarına git
  3. “Allow access by GitHub Apps” seçeneğini işaretle
Ayrıntılı talimatlar için GitHub’ın dokümantasyonuna bak.

IP’leri doğrudan allow list’ine ekle

Organizasyonun GitHub’da IdP tanımlı allow list’ler kullanıyorsa veya önceden yapılandırılmış allow list’i kullanamıyorsa, IP adreslerini manuel olarak ekleyebilirsin:
184.73.225.134
3.209.66.12
52.44.113.131
IP adresleri listesi nadiren değişebilir. IP allow list kullanan takımlara, IP adresleri eklenmeden veya kaldırılmadan önce önceden bildirim yapılır.

Sorun giderme