Ana içeriğe atla
Background Agents ve Bugbot, depoları klonlamak ve değişiklikleri push’lamak için Cursor GitHub uygulamasını gerektirir.

Kurulum

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

GitHub’da Agent kullanma

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

İzinler

GitHub uygulaması, arka plandaki agent’larla çalışmak için belirli izinler gerektirir:
İzinAmaç
Depo erişimiKodunu klonlamak ve çalışma branch’leri oluşturmak
Pull request’lerİncelemene sunulmak üzere agent değişiklikleriyle PR’ler oluşturmak
IssuesAgent’ları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 pipeline’larını ve dağıtım durumunu izlemek
Tüm izinler, arka plandaki agent işlevselliği için gereken asgari ayrıcalık ilkesine göre belirlenir.

IP Allow List Yapılandırması

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

Destekle İletişime Geç

IP allowlist’leri yapılandırmadan önce, bu özelliği ekibin için etkinleştirmek üzere hi@cursor.com adresiyle iletişime geç. Aşağıdaki her iki yapılandırma yöntemi için de bu gereklidir. Cursor GitHub uygulaması, IP listesini zaten önceden yapılandırılmış olarak içerir. Bu listeyi otomatik olarak devralmak için yüklü uygulamalar için allowlist’i etkinleştirebilirsin. Bu önerilen yaklaşım, çünkü listeyi bizim güncellememize olanak tanır ve kuruluşun güncellemeleri otomatik olarak alır. Bunu etkinleştirmek için:
  1. Kuruluşunun Security ayarlarına git
  2. IP allow list ayarlarına ilerle
  3. “Allow access by GitHub Apps” seçeneğini işaretle
Ayrıntılı talimatlar için GitHub’ın belgelerine bak.

IP’leri allowlist’ine doğrudan ekle

Kuruluşun GitHub’da IdP tanımlı allowlist’ler kullanıyorsa veya önceden yapılandırılmış allowlist’i kullanamıyorsa, IP adreslerini manuel olarak ekleyebilirsin:
184.73.225.134
3.209.66.12
52.44.113.131
IP adresleri listesi ara sıra değişebilir. IP allow list kullanan takımlara, IP adresleri eklenmeden veya kaldırılmadan önce önceden haber verilir.

Sorun Giderme

  • Depoya erişim yetkisiyle GitHub uygulamasını yükle
  • Özel depolar için depo izinlerini kontrol et
  • GitHub hesabı izinlerini doğrula
  • Uygulamaya pull request’lere yazma izni ver
  • Dal koruma kurallarını kontrol et
  • Uygulamanın kurulumu süresi dolduysa yeniden yükle
  • Organizasyon düzeyinde kurulup kurulmadığını kontrol et
  • github.com/apps/cursor üzerinden yeniden yükle
  • Kurulum bozulduysa destekle iletişime geç
I