Cursor Cloud Agents
AI SmartTalk'ı Cursor Cloud Agents ile bağlayarak, sohbetlerinizden veya iş akışlarınızdan doğrudan otonom AI kodlama asistanları başlatın. Cursor Cloud Agents, depoları okuyabilir, kod üretebilir, taahhütler oluşturabilir ve otomatik olarak pull request'ler açabilir.
Genel Bakış
Cursor Cloud Agents entegrasyonu, aşağıdakileri yapmanızı sağlar:
- AI kodlama ajanlarını GitHub depolarınızda başlatın
- Doğal dil talimatları aracılığıyla kod üretimini otomatikleştirin
- Görevler tamamlandığında pull request'ler otomatik olarak oluşturun
- Ajan ilerlemesini izleyin ve konuşma geçmişini görüntüleyin
- Çalışan ajana takip talimatları ekleyin
- SmartFlow iş akışlarından kodlama görevlerini tetikleyin
Ön Koşullar
Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Aktif bir AI SmartTalk hesabı
- Cloud Agents erişimi olan bir Cursor hesabı
- Cursor kontrol panelinizden alınan bir Cursor API anahtarı
- Cursor hesabınızdan erişilebilen GitHub depoları
Adım Adım Kurulum
Adım 1: Cursor API Anahtarınızı Alın
- Cursor Cloud Agent kontrol panelinize gidin
- API ayarlarınıza gidin
- AI SmartTalk için yeni bir API anahtarı oluşturun
- API anahtarını kopyalayın
Adım 2: Cursor Entegrasyonuna Erişim
- AI SmartTalk hesabınıza giriş yapın
- Yönetim → Asistanlarım → [Asistan Adınız] yolunu izleyin
- Sol kenar çubuğunda Bağlayıcılar üzerine tıklayın
- Cursor Cloud Agents'ı bulun ve üzerine tıklayın
Adım 3: Bağlantıyı Yapılandırın
- Yapılandırmayı Ayarla'ya tıklayın
- Cursor API Anahtarınızı girin
- Yapılandırmayı Kaydet'e tıklayın
- AI SmartTalk, API anahtarınızı otomatik olarak doğrular
Adım 4: Depoları Senkronize Edin
Bağlandıktan sonra, AI SmartTalk otomatik olarak Cursor hesabınızdaki erişilebilir GitHub depolarını senkronize eder. Ayrıca, istediğiniz zaman depo listesini manuel olarak güncelleyebilirsiniz.
Kontrol Paneli
Bağlandıktan sonra, Cursor entegrasyon kontrol paneli kapsamlı bir genel bakış sunar:
İstatistikler Genel Bakışı
| Ölçüt | Açıklama |
|---|---|
| Toplam Ajanlar | Başlatılan ajan sayısı |
| Çalışan | Şu anda aktif olan ajanlar |
| Tamamlanan | Tamamlanan ajanlar |
| Mevcut Modeller | Ajanlar için mevcut AI modelleri |
Son Asistanlar
Kontrol paneli, en son ajanlarınızı aşağıdaki bilgilerle listeler:
- Ajan ID referansı
- Durum: Çalışıyor, Tamamlandı, Başarısız, Oluşturuluyor veya İptal Edildi
- Ajanın çalıştığı Depo
- Oluşturma tarihi
- Hızlı eylemler: Detayları Görüntüle ve PR'yi Görüntüle
Kontrol paneli, ajanlar çalışırken her 30 saniyede bir otomatik olarak yenilenir.
Bir Ajan Başlatma
Kontrol Panelinden
- Yeni Asistan Başlat'a tıklayın
- Başlatma formunu doldurun:
| Alan | Gerekli | Açıklama |
|---|---|---|
| Depo | Evet | Aşağıdan bir GitHub deposu seçin |
| Görev Açıklaması | Evet | Ajanın ne yapması gerektiğini doğal dilde tanımlayın |
| Dal | Hayır | Üzerinde çalışılacak Git dalı (varsayılan: main) |
| AI Modeli | Hayır | Ajan için belirli bir AI modeli seçin |
| Otomatik PR oluştur | Hayır | Tamamlandığında otomatik olarak bir pull request oluşturun (varsayılan: etkin) |
| Dal Adı | Hayır | Pull request için özel dal adı |
- Ajanı Başlat'a tıklayın
Görev Açıklaması Örnekleri
- "Kimlik doğrulama modülü için birim testleri ekleyin"
- "Veritabanı bağlantı havuzunu bağlantı geri dönüşümünü kullanacak şekilde yeniden yapılandırın"
- "Kullanıcı oturumlarının mobilde erken sona erdiği hatayı düzeltin"
- "Tüm API yanıt nesneleri için TypeScript tür tanımlamaları ekleyin"
- "Kullanıcı tercihleri için bir REST API uç noktası oluşturun"
Ajanları Yönetme
Ajan Detaylarını Görüntüleme
Herhangi bir ajan üzerinde Detayları Görüntüle'ye tıklayarak şunları görebilirsiniz:
Genel Bakış Sekmesi:
- Ajan ID'si ve mevcut durumu
- Depo ve dal bilgileri
- Pull request bağlantısı (oluşturulmuşsa)
- Yapılan işin özeti
- Oluşturma zaman damgası
Konuşma Sekmesi:
- Ajanın çalışma mesaj geçmişi
- Kullanıcı talimatları ve AI yanıtları
- Adım adım ilerleme kaydı
Takip Talimatları Ekleme
Çalışan bir ajana ek talimatlar gönderebilirsiniz:
- Ajan detaylarını açın
- Takip talimatınızı girin (örneğin, "Ayrıca kullanıcı bulunamadığında kenar durumu için hata işleme ekleyin")
- Ajan, yeni bağlamla çalışmaya devam eder
Bir Ajanı Silme
Kaynakları temizlemek için:
- Ajan kartındaki silme eylemine tıklayın
- Silmeyi onaylayın
- Ajan ve kaynakları kaldırılır
SmartFlow Entegrasyonu
Cursor Cloud Agents, SmartFlow iş akışlarında eylemler olarak kullanılabilir ve güçlü otomasyon senaryoları sağlar.
Mevcut SmartFlow Eylemleri
| Eylem | Açıklama |
|---|---|
| Kodlama Ajanı Başlat | Belirli talimatlarla bir depoda bir ajan başlatın |
| Takip Ekle | Çalışan bir ajana ek talimatlar gönderin |
| Ajan Durumunu Al | Bir ajanın ilerlemesini ve durumunu kontrol edin |
| Ajanı Sil | Bir ajanı kaldırın ve kaynakları temizleyin |
Örnek: Hata Raporunda Otomatik Düzeltme
Trigger: Chat Service (kullanıcı bir hata bildirdiğinde)
Actions:
1. AI Request:
Prompt: Hata tanımını ve etkilenen depoyu çıkar
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Bu hatayı düzelt: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Bunu düzeltmek için bir kodlama ajanı başlattım. PR hazır olduğunda sizi bilgilendireceğim."
4. Wait / Poll:
Ajan Durumunu periyodik olarak kontrol et
5. Send Message:
Text: "Düzeltme hazır! PR'yi burada gözden geçirin: {{pr_url}}"
Örnek: Planlı Kod İyileştirmeleri
Trigger: Planlı İş Akışı (haftalık)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Tüm eski bağımlılıkları gözden geçirin ve güncelleyin"
Branch: chore/update-deps
Auto-create PR: true
Detaylı SmartFlow eylem parametreleri için Cursor SmartFlow Actions sayfasına bakın.
Kullanım Senaryoları
Geliştirici Destek Botu
Kullanıcıların sohbet aracılığıyla kod değişiklikleri talep etmelerine izin verin:
- "Kayıt formuna giriş doğrulaması ekleyebilir misiniz?"
- "Yeni kullanıcı alanları için bir geçiş betiği oluşturun lütfen"
Otomatik Hata Düzeltme
Hata raporlarından veya izleme uyarılarından kodlama ajanlarını tetikleyerek otomatik düzeltme PR'leri oluşturun.
Kod İnceleme Otomasyonu
Kod incelemek, test eklemek veya PR geri bildirimine dayalı olarak belgeleri iyileştirmek için ajanları başlatın.
Planlı Bakım
Bağımlılıkları güncellemek, linting düzeltmeleri çalıştırmak veya raporlar oluşturmak için tekrarlayan iş akışları oluşturun.
Sorun Giderme
| Sorun | Çözüm |
|---|---|
| "Geçersiz API anahtarı" | API anahtarınızı Cursor kontrol panelinden yeniden oluşturun |
| "Depo bulunamadı" | Depoları yeniden senkronize etmek için Yenile'ye tıklayın. Repo'nun Cursor hesabınızdan erişilebilir olduğundan emin olun |
| Ajan "Oluşturuluyor" durumunda takıldı | Ajan sıraya alınmış olabilir. Birkaç dakika bekleyin ve durumu tekrar kontrol edin |
| Ajan başarısız oldu | Ajan detaylarını açarak konuşmayı ve hata mesajlarını görüntüleyin |
| PR oluşturulmadı | Otomatik PR oluşturma seçeneğinin etkin olduğunu ve ajanın başarıyla tamamlandığını kontrol edin |
| Erişilebilir depo yok | Cursor hesabınızın bağlı GitHub depolarına sahip olduğundan emin olun |
Entegrasyonu Yönetme
| Eylem | Nasıl |
|---|---|
| Bağlan | Entegrasyon yapılandırmasında API anahtarını girin |
| Kontrol panelini görüntüle | Cursor entegrasyon sayfasını açın |
| Depoları senkronize et | Depo listesini güncellemek için Yenile'ye tıklayın |
| Bağlantıyı kes | Yapılandırmadan API anahtarını kaldırın |
En İyi Uygulamalar
- Açık görev tanımları yazın: Talimatlarınız ne kadar spesifik olursa, ajanın çıktısı o kadar iyi olur.
- Uygun dalları kullanın: Ajanları doğrudan
mainüzerinde başlatmayın — inceleme için PR oluşturmalarına izin verin. - Otomatik PR oluşturmayı etkinleştirin: Ajan çalışmalarını gözden geçirmeyi ve birleştirmeyi kolaylaştırır.
- Çalışan ajanları izleyin: Gösterge panelini düzenli olarak kontrol edin veya SmartFlow bildirimlerini ayarlayın.
- Birleştirmeden önce gözden geçirin: Üretime geçmeden önce her zaman ajan tarafından oluşturulan PR'ları gözden geçirin.
- Küçük başlayın: Büyük yeniden yapılandırmalar denemeden önce iyi tanımlanmış görevlerle başlayın.