Bugbot

Bugbot, pull request'leri inceler; hataları, güvenlik açıklarını ve kod kalitesi sorunlarını tespit eder.

Bugbot'u Otomasyonlar bölümünde yapılandırın.

Nasıl çalışır

Bugbot, PR diff'lerini analiz eder; açıklamalar ve düzeltme önerileri içeren yorumlar bırakır. Her PR güncellemesinde otomatik olarak veya manuel olarak tetiklendiğinde çalışır.

• Her PR güncellemesinde otomatik inceleme çalıştırır
• Herhangi bir PR'ye cursor review veya bugbot run yorumu yazarak manuel tetikleme
• Mevcut PR yorumlarını bağlam olarak kullanır: yinelenen önerileri önlemek ve önceki geri bildirimlerden yararlanmak için bağlı PR yorumlarını (üst düzey ve satır içi) okur
• Cursor'da düzelt bağlantıları sorunları doğrudan Cursor'da açar
• Web'de düzelt bağlantıları sorunları doğrudan cursor.com/agents üzerinde açar

Kurulum

Bugbot'u kullanmaya başlamak için depolarınızı Cursor kontrol paneli üzerinden bağlayın.

• GitHub (GitHub Enterprise Server dahil): GitHub entegrasyonu sayfasına göz atın
• GitLab (GitLab Self-Hosted dahil): GitLab entegrasyonu sayfasına göz atın
• Bitbucket (Bitbucket Data Center dahil): Bitbucket entegrasyonu sayfasına göz atın

Bağlantıyı kurduktan sonra, belirli depolarda etkinleştirmek için otomasyon içindeki Bugbot sayfasını açın.

CI kontrol durumları

Bugbot, her inceleme çalıştırması için bir durum yayımlar. GitHub'da bu, Cursor Bugbot adlı bir kontrol olarak görünür. Bitbucket'ta ise cursor-bugbot anahtarına sahip bir build durumu olarak görünür. Durumda şu sonuçlar kullanılır:

• success: Bugbot hiçbir sorun bulmadı ve önceki çalıştırmalardan çözülmemiş Bugbot yorumu yok.
• neutral: Bugbot sorun buldu, çalıştırma daha yeni bir commit nedeniyle iptal edildi veya Bugbot dahili bir hatayla karşılaştı. Bugbot bulgu bildirdiğinde varsayılan sonuç budur.
• failure: Bugbot sorun buldu ve kontrol, çözülmemiş sorunlar varsa başarısız olacak şekilde yapılandırıldı.

Dal koruması kullanıyorsanız, Bugbot'un merge işleminden önce çalışmasını sağlamak için Bugbot kontrolunu veya build durumunu zorunlu tutun. Bulgular varsayılan olarak neutral olduğundan, yalnızca durumu zorunlu tutmak bulgular nedeniyle merge işlemlerini engellemez. Kuruluşunuz için çözülmemiş sorunlarda başarısız olma davranışı kullanılabiliyorsa, çözülmemiş bulguların başarısız durum üretmesi için bunu etkinleştirin. Bugbot skipped sonucu yayımlamaz.

Bugbot Autofix etkinleştirildiğinde GitHub ayrıca ayrı bir Cursor Bugbot Autofix kontrolü de gösterebilir. Bu kontrol yalnızca success veya neutral sonuçlarını kullanır.

Yapılandırma

Analiz

İnceleme etkinliklerini ve sonuçlarını görüntülemek için Otomasyonlar'da Bugbot öğesini açın.

API

Kurumsal ekipler, incelemeleri tetiklemek ve inceleme başına analiz verilerini almak için Bugbot API'sini kullanabilir. Cursor kontrol paneli → API Keys sayfasından bir API anahtarı oluşturun ve Basic Authentication ile kimlik doğrulaması yapın.

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42"  }'

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42",    "dryRun": true  }'

{  "outcome": "success",  "message": "Bugbot review queued",  "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",  "dry_run": false}

{  "outcome": "error",  "message": "Bugbot is disabled for this repository"}

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'startDate=2026-06-01' \  --data-urlencode 'endDate=2026-06-29' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42' \  --data-urlencode 'page=1' \  --data-urlencode 'pageSize=100'

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'dryRun=true' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42'

{  "data": [    {      "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",      "timestamp": "2026-06-29T19:42:18.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 2,      "cost_cents": 42.5,      "dry_run": false,      "publication_status": "posted",      "bugs": [        {          "comment_id": "2147483999",          "resolution_status": "resolved",          "severity": "high"        },        {          "comment_id": "2147484000",          "resolution_status": "unresolved",          "severity": "medium"        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "page": 1,    "pageSize": 100  }}

{  "data": [    {      "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",      "timestamp": "2026-06-29T20:15:03.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 1,      "cost_cents": null,      "dry_run": true,      "publication_status": "dry_run",      "bugs": [        {          "comment_id": null,          "resolution_status": null,          "severity": "medium",          "title": "Unbounded retry loop",          "description": "retry() recurses without a ceiling.",          "locations": [            { "file": "src/net.ts", "start_line": 5, "end_line": 9 }          ]        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "dryRun": true,    "page": 1,    "pageSize": 100  }}

İnceleme tetikleme ve alma

1. Pull request URL'siyle POST /bugbot/review çağrısı yapın. SCM'ye gönderi paylaşmadan analiz etmek için "dryRun": true değerini iletin.
2. Döndürülen request_id değerini kaydedin.
3. repo ve prNumber ile filtreleyerek GET /analytics/team/bugbot-reviews uç noktasını yoklayın. Kuru çalıştırma incelemesi tetiklediyseniz dryRun=true kullanın.
4. request_id değeri tetikleme yanıtındaki değerle eşleşen öğeyi bulun.

Bir inceleme kuyruğa alındıktan sonra analizlerin kullanılabilir hâle gelmesi kısa sürebilir.

Artımlı incelemeler

Bugbot, varsayılan olarak her push işleminde pull request'in tüm diff'ini inceler. Yalnızca önceki Bugbot incelemesinden sonraki değişiklikleri incelemek için Bugbot otomasyon bölümünde Artımlı İnceleme seçeneğini etkinleştirin.

Efor Düzeyleri

Efor düzeyleri, Bugbot'un inceleme sırasında akıl yürütmeye ne kadar zaman ayıracağını belirler. Daha yüksek efor düzeyleri daha fazla hata bulabilir, ancak incelemeler daha uzun sürebilir ve daha fazla kullanım tüketebilir.

Şu efor düzeylerinden birini seçin:

• Default: Verimlilik ve hız için optimize edilmiştir. İncelemeler daha düşük maliyetlidir, ancak Bugbot daha az hata bulabilir.
• Yüksek: Akıl yürütmeye daha fazla zaman ayırır. İncelemeler daha maliyetlidir ve daha uzun sürer, ancak Bugbot daha fazla hata bulabilir.
• Özel: Bugbot'un ne zaman daha uzun ve daha derin incelemeler kullanması gerektiğini belirtmenizi sağlar. Cursor, talimatlarınıza göre efor düzeylerini dinamik olarak ayarlar.

Kurallar

İncelemeleri ekip kuralları, depo kuralları ve proje .cursor/BUGBOT.md dosyalarıyla yönlendirin.

Ekip kuralları

Ekip yöneticileri, ekibin tüm depoları için geçerli olan kuralları Bugbot otomasyon bölümünde oluşturabilir. Bu kurallar, etkinleştirilmiş tüm depolarda kullanılabilir; böylece kuruluş genelindeki standartlar kolayca uygulanabilir.

Kural limitleri

Her kural, incelemeye dahil edildiğinde 30.000 karakterde kesilir. Bugbot'un bir incelemeye dahil ettiği kuralların toplam uzunluğu 100.000 karakterle sınırlıdır. Bu toplam limiti aşarsanız bazı kurallar atlanabilir. Zorunlu ekip kurallarına, zorunlu olmayan kurallara göre öncelik verilir.

Bir incelemenin kullandığı kuralları görün

Bir pull request'e bugbot run verbose=true veya cursor review verbose=true yorumu ekleyin. Bugbot, bu çalıştırmada kullanılan tüm kuralları içeren bir tablo yayınlar ve kısaltılan veya atlanan kuralları işaretler.

Depo kuralları

Proje kuralları

İncelemeler için projeye özgü bağlam sağlamak üzere .cursor/BUGBOT.md dosyaları oluşturun. Bugbot, kök dizindeki .cursor/BUGBOT.md dosyasını ve değiştirilen dosyalardan yukarı doğru ilerlerken bulduğu ek dosyaları her zaman içerir.

project/  .cursor/BUGBOT.md          # Her zaman dahil edilir (proje genelindeki kurallar)  backend/    .cursor/BUGBOT.md        # Arka uç dosyaları incelenirken dahil edilir    api/      .cursor/BUGBOT.md      # API dosyaları incelenirken dahil edilir  frontend/    .cursor/BUGBOT.md        # Ön uç dosyaları incelenirken dahil edilir

Öğrenilen kurallar

Bugbot depo kuralları bölümünde kuruluşlarınız ve depolarınız için öğrenmeyi etkinleştirin.

Kurallar, ekibinizin ilgili depodaki GitHub etkinliklerinden otomatik olarak oluşturulur veya depo geçmişinden manuel olarak geriye dönük eklenir.

Herhangi bir PR'de @cursor remember [fact] şeklinde yorum yaparak Bugbot'a satır içi yeni kurallar da öğretebilirsiniz. Bugbot, bu bilgiyi öğrenilen kural olarak kaydeder ve gelecekteki incelemelerde uygular.

Cursor, zaman içinde ekibinizin etkinlikleri hakkında daha fazla bilgi edindikçe kuralları otomatik olarak etkinleştirir veya devre dışı bırakır.

Manuel kurallar

Bugbot depo kurallarında, tek tek depolar için manuel kurallar oluşturabilirsiniz.

Kural analizi

Bir Bugbot kuralına ilişkin analizler, kuralın gerçek PR'lerdeki performansını gösterir:

Örnekler

Herhangi bir değiştirilen dosya /\beval\s*\(|\bexec\s*\(/i dize kalıbını içeriyorsa:- Başlığı "Tehlikeli dinamik yürütme" olan, engelleyici bir Bug ekleyin. Gövdesi:  "eval/exec kullanımı tespit edildi. Güvenli alternatiflerle değiştirin veya ayrıntılı bir yorum ve testlerle gerekçelendirin."- Bug'ı PR yazarına atayın.- "security" etiketini uygulayın.

PR bağımlılık dosyalarını (package.json, pnpm-lock.yaml, yarn.lock, requirements.txt, go.mod, Cargo.toml) değiştiriyorsa:- Yerleşik License Scan'i çalıştırın.- Yeni eklenen veya yükseltilen herhangi bir bağımlılığın lisansı {GPL-2.0, GPL-3.0, AGPL-3.0} kümesindeyse:  - Başlığı "Yasaklı lisans tespit edildi" olan engelleyici bir Bug ekleyin.  - İhlale neden olan paket adlarını, sürümlerini ve lisanslarını Bug gövdesine ekleyin.  - "compliance" ve "security" etiketlerini uygulayın.

React projelerinde **/*.{js,jsx,ts,tsx} ile eşleşen dosyalar için:Değiştirilen bir dosya /componentWillMount\s*\(/ içeriyorsa:- Başlığı "Kullanımdan kaldırılmış React yaşam döngüsü yöntemi" olan engelleyici bir Bug ekleyin.- Gövde: "componentWillMount'u constructor veya useEffect ile değiştirin. React belgelerine bakın."- Yan etkileri useEffect'e taşıyan bir otomatik düzeltme kod parçacığı önerin.

PR, {server/**, api/**, backend/**} içindeki dosyaları değiştiriyor ve {**/*.test.*, **/__tests__/**, tests/**} içinde değişiklik yoksa:- Başlığı "Backend değişiklikleri için test eksik" olan engelleyici bir Bug ekleyin.- Gövde: "Bu PR backend kodunu değiştiriyor ancak buna eşlik eden testler içermiyor. Lütfen test ekleyin veya güncelleyin."- "quality" etiketini uygulayın.

Herhangi bir değiştirilen dosya /(?:^|\s)(TODO|FIXME)(?:\s*:|\s+)/ içeriyorsa:- Başlığı "TODO/FIXME yorumu bulundu" olan engelleyici olmayan bir Bug ekleyin.- Gövde: "TODO/FIXME'yi takip edilen bir issue başvurusuyla, örneğin `TODO(#1234): ...` ile değiştirin veya kaldırın."- TODO zaten /#\d+|[A-Z]+-\d+/ issue kalıbına başvuruyorsa Bug'ı otomatik olarak çözüldü şeklinde işaretleyin.

Agent'inizde çalıştırın

Kodu push etmeden önce Bugbot'u agent'inizden çalıştırmak için /review-bugbot veya /review becerilerini kullanın.

Hangi diff incelenir: /review-bugbot, Default olarak dalınızdaki değişiklikleri inceler: base dalına göre commit edilmiş ve edilmemiş tüm değişiklikler. Daha dar kapsamlı geri bildirim almak için yalnızca commit edilmemiş değişikliklerinizi incelemesini isteyin.

Hangi dalla karşılaştırılır: /review-bugbot, Default base dalınızla karşılaştırır. Base dalınız main gibi Default değilse, agent'e hangi dalla karşılaştıracağını söyleyin veya bunu bağlamdan çıkarmasına izin verin.

Pull request'inizle senkronizasyon

/review-bugbot incelemeleri, bağlı SCM'nizdeki (GitHub, GitLab veya Bitbucket) Bugbot ile senkronize kalır.

/review-bugbot, arka planda incelenen diff'in yama kimliğini saklar. SCM'nizdeki Bugbot aynı yama kimliğine sahip bir diff gördüğünde incelemeyi atlar ve bu diff'i daha önce incelediğini belirten bir yorum bırakır.

Yaygın bir kullanım örneği: /review-bugbot komutunu çalıştırın, ardından aynı diff ile bir pull request açın. Bugbot incelemeyi tanır ve uzak PR incelemesini atlar.

Autofix

Bugbot Autofix, PR incelemelerinde tespit edilen hataları düzeltmek için otomatik olarak bir Cloud Agent başlatır.

Nasıl çalışır

Bugbot, bir PR incelemesi sırasında hata bulduğunda otomatik olarak şunları yapabilir:

1. Bildirilen sorunları analiz edip düzeltmek üzere bir Cloud Agent başlatmak
2. Düzeltmeleri mevcut dala veya yeni bir dala push etmek (ayarlarınıza bağlı olarak)
3. Sonuçları orijinal PR'ye yorum olarak göndermek

Yapılandırma

Autofix davranışını Bugbot otomasyon bölümünden yapılandırın.

Gereksinimler

Autofix için şunlar gereklidir:

• İsteğe bağlı kullanım fiyatlandırmasının etkin olması
• Depolamanın etkin olması (eski Gizlilik Modunda kullanılamaz)

Faturalandırma

Autofix, Cloud Agent kredilerini kullanır ve planınızdaki ücretler üzerinden faturalandırılır. Cloud Agent faturalandırması mevcut fiyatlandırma planınıza tabidir.

MCP desteği

Bugbot, yapay zekâ araçlarınızın Bugbot'la doğrudan etkileşim kurabilmesi için MCP sunucularınızla entegre edilmiştir. Bugbot'un inceleme sürecine yön vermek için ek araçlar sağlamak üzere MCP sunucusunu kullanın.

Başlamak için:

1. MCP sunucusunun kurulum talimatları için MCP belgelerine bakın.
2. Araçları otomasyon içindeki Bugbot'a ekleyin.

Yönetici Yapılandırma API'si

Ekip yöneticileri, depoları yönetmek ve hangi kullanıcıların Bugbot'u kullanabileceğini belirlemek için Bugbot Admin API'yi kullanabilir. Depo yönetimini otomatikleştirmek, Bugbot'u birden fazla depoda etkinleştirmek veya kullanıcı sağlamayı dahili araçlarla entegre etmek için bu API'yi kullanın.

Kimlik Doğrulama

Tüm uç noktalar, Bearer token olarak gönderilen bir ekip Admin API Key'i gerektirir:

Authorization: Bearer $API_KEY

Bir API anahtarı oluşturmak için:

1. Cursor kontrol panelindeki API Anahtarları sayfasına gidin
2. New API Key seçeneğine tıklayın
3. API anahtarını kaydedin

Tüm uç noktalar, ekip başına dakikada 60 istekle sınırlıdır.

Depoları etkinleştirme veya devre dışı bırakma

Bir depo için Bugbot'u etkinleştirmek veya devre dışı bırakmak üzere /bugbot/repo/update uç noktasını kullanın:

curl -X POST https://api.cursor.com/bugbot/repo/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "repoUrl": "https://github.com/your-org/your-repo",    "enabled": true,    "manualTriggerOnly": false  }'

Parametreler:

• repoUrl (string, gerekli): Deponun tam URL'si
• enabled (boolean, gerekli): Bugbot'u etkinleştirmek için true, devre dışı bırakmak için false
• manualTriggerOnly (boolean, isteğe bağlı): true olduğunda Bugbot, bu depodaki PR güncellemelerinde otomatik olarak çalışmaz. cursor review veya bugbot run yorumu eklemek gibi manuel tetikleyiciler çalışmaya devam eder.

Depoları listeleme

Ekibiniz için Bugbot ayarlarıyla birlikte tüm depoları listelemek üzere /bugbot/repos uç noktasını kullanın:

curl https://api.cursor.com/bugbot/repos \  -H "Authorization: Bearer $API_KEY"

Yanıt, her deponun etkinlik durumunu, yalnızca manuel ayarını ve zaman damgalarını içerir.

Kullanıcı erişimini yönetme

Ekibinizin Bugbot lisanslarını hangi GitHub, GitLab veya Bitbucket kullanıcılarının kullanabileceğini belirlemek için /bugbot/user/update uç noktasını kullanın. Kurumsal kuruluşlar, Bugbot sağlamayı dahili erişim talep araçlarıyla entegre etmek için bunu kullanır.

Önkoşullar

Bu uç noktayı çağırmadan önce ekip Bugbot ayarlarınızdan izin listesi veya engelleme listesi modunu etkinleştirin:

• İzin listesi modu ("Only..."): Yalnızca listedeki kullanıcılar Bugbot'u kullanabilir
• Engelleme listesi modu ("Everyone but..."): Listedekiler dışındaki tüm kullanıcılar Bugbot'u kullanabilir

Her iki mod da etkin değilse API hata döner.

Kullanıcı ekleme veya kaldırma

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "username": "octocat",    "allow": true  }'

Parametreler:

• username (string, gerekli): GitHub, GitLab veya Bitbucket kullanıcı adı (büyük/küçük harf duyarsız)
• allow (boolean, gerekli): Erişim izni verilip verilmeyeceği veya erişimin iptal edilip edilmeyeceği

allow parametresinin davranışı etkin moda bağlıdır:

Yanıt:

{  "outcome": "success",  "message": "Updated team-level allowlist for @octocat",  "updatedTeamSettings": true,  "updatedInstallations": 0}

Örnek: dahili bir araçla kullanıcı sağlama

Bu API'yi dahili bir erişim talep portalına bağlayın. Bir çalışan Bugbot erişimi istediğinde portal, çalışanı eklemek için API'yi çağırır. Çalışan şirketten ayrıldığında veya erişimini kaybettiğinde ise çalışanı kaldırmak için API'yi çağırır.

Erişim verin:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": true}'

Erişim iznini iptal et:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": false}'

Fiyatlandırma

Bugbot, kullanıma dayalı faturalandırma uygular.

Faturalandırma

Sorun Giderme

Bugbot çalışmıyorsa:

1. Ayrıntılı günlükleri, yüklenen Bugbot kurallarını ve istek kimliğini görmek için cursor review verbose=true veya bugbot run verbose=true yorumunu ekleyerek ayrıntılı modu etkinleştirin
2. Bugbot'un depoya erişimi olduğunu doğrulamak için izinleri kontrol edin
3. Depo sağlayıcısı entegrasyonunuzun kurulu ve etkin olduğunu doğrulamak için kurulumu doğrulayın

Sorun bildirirken ayrıntılı moddan aldığınız istek kimliğini ekleyin.

SSS