AgentLoop:AI Kodlama Aracılarının Dahil Edilmesi

LoongSuite Pilot'a Genel Bakış

LoongSuite Pilot, geliştirici makinelerinde çalışan hafif bir toplayıcıdır. Yüklü AI Kodlama Araçlarını otomatik olarak keşfeder ve gerekli kanca (hook) veya eklentileri dağıtır. LoongSuite Pilot, farklı arıcılardan gelen ham etkinlik verilerini tek tip bir olay biçimine dönüştürür ve bu verileri AgentLoop tarafından kullanılan günlük veya izleme arka ucuna raporlar.

Senaryolar

Ekibiniz günlük geliştirme çalışmaları için Claude Code, Codex, Cursor veya Qoder gibi AI Kodlama Araçlarını kullanıyorsa, aşağıdaki senaryolar için istemci tarafı etkinlik verilerini toplamak amacıyla LoongSuite Pilot'ı kullanabilirsiniz:

• Ekip genelinde hangi AI Kodlama Araçlarının kullanıldığını görüntüleyin.

• Oturumları, model çağrılarını, araç çağrılarını ve hata olaylarını analiz edin.

• Aracıya göre ayrılmış belirteç kullanımını takip edin.

• Günlük sorguları, izleme bağlantıları veya özel arayüzler aracılığıyla aracı çalışma zamanı davranışını araştırın.

• Veriler raporlanmadan önce istemler, tamamlamalar ve araç parametreleri gibi hassas içerikleri filtreleyin.

Desteklenen AI Kodlama Araçları

Aşağıdaki tablolar, sırasıyla Linux / macOS ve Windows üzerinde LoongSuite Pilot tarafından desteklenen aracıları ve veri toplama yeteneklerini listeler.

Linux / macOS Desteği

Windows Desteği

Ön Koşullar

Başlamadan önce aşağıdaki genel gereksinimlerin karşılandığından emin olun:

• Hedef AI Kodlama Aracısı yüklü olmalı ve en az bir kez kullanılmış olmalıdır.

• AI Kodlama Aracısı dahil etme kaynakları AgentLoop konsolunda başlatılmış olmalı ve otomatik olarak oluşturulan kurulum komutunu elde etmiş olmalısınız.

macOS / Linux

Makinenizde ayrıca aşağıdaki gereksinimlerin de karşılandığından emin olun:

• Genellikle Node.js veya npm'i önceden yüklemeniz gerekmez. Yükleyici, yönetilen bir Node.js çalışma zamanını ve önceden oluşturulmuş bağımlılıkları indirip sabitler.

• curl veya wget yüklü olmalıdır.

• Kurulum komutundaki OSS indirme URL'lerine erişebilmelisiniz.

Windows

Makinenizde ayrıca aşağıdaki gereksinimlerin de karşılandığından emin olun:

• Windows 10 veya üzeri.

• PowerShell 5.1 veya üzeri.

• Genellikle Node.js veya npm'i önceden yüklemeniz gerekmez ve kurulum komutundaki OSS indirme URL'lerine erişebilmelisiniz.

Geri Dönüş: Platform desteklenmediği veya indirme başarısız olduğu için yönetilen Node.js çalışma zamanı kullanılamıyorsa, yükleyici sistem Node.js'sine geri döner. Bu durumda, Node.js 18 veya üzeri ve npm yüklü olmalıdır.

Bilinen platform sınırlamaları: Windows ARM64 ve musl kullanan Linux dağıtımları (örneğin, Alpine) için şu anda eşleşen bir yönetilen Node.js yapısı bulunmamaktadır. Bu platformlarda, sistem Node.js 18 veya üzerini ve npm'i önceden hazırlayın.

LoongSuite Pilot'ı Yükleme

AgentLoop kullanıcıları için, AgentLoop konsolunda otomatik olarak oluşturulan kurulum komutunu kopyalamanızı öneririz. Komuttaki kaynak adları ve bağlantı parametreleri (true ve false hariç), dahil etme kaynağı başlatma sırasında otomatik olarak oluşturulur.

CMS ve SLS parametre değerlerini AgentLoop konsolundan alın.

macOS / Linux

# Run the installation command. Replace all parameter values with the ones obtained above.
curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh install \
  --collect-log "true" \
  --collect-trace "true" \
  --sls-project "your_SLS_Project_name" \
  --sls-logstore "your_SLS_Logstore_name" \
  --sls-endpoint "your_SLS_endpoint" \
  --cms-license-key "your_Trace_License_Key" \
  --cms-endpoint "your_Trace_endpoint" \
  --cms-workspace "your_Trace_workspace" \
  --service-name-prefix "your_service_name_prefix"

Windows

# Download the installer script
Invoke-WebRequest `
    -Uri 'https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.ps1' `
    -OutFile installer.ps1

# Run the installer. Replace all parameter values with the ones obtained above.
.\installer.ps1 install `
    -CollectLog 'true' `
    -CollectTrace 'true' `
    -SlsProject "your_SLS_Project_name" `
    -SlsLogstore "your_SLS_Logstore_name" `
    -SlsEndpoint "your_SLS_endpoint" `
    -CmsLicenseKey "your_Trace_License_Key" `
    -CmsEndpoint "your_Trace_endpoint" `
    -CmsWorkspace "your_Trace_workspace" `
    -ServiceNamePrefix "your_service_name_prefix"

Yükleyici otomatik olarak aşağıdaki işlemleri gerçekleştirir:

• Makinenizde desteklenen AI Kodlama Araçlarını algılar.

• Verilerini toplamak istediğiniz aracıları seçmenize olanak tanır.

• İlgili kanca (hook) veya eklentileri dağıtır.

• Yerel yapılandırmayı yazar.

• LoongSuite Pilot arka plan hizmetini başlatır.

Kurulum tamamlandıktan sonra, hizmet durumunu kontrol etmek için aşağıdaki komutları çalıştırın:

loongsuite-pilot status
loongsuite-pilot info

Varsayılan olarak, LoongSuite Pilot yerel yapılandırmayı, çalışma zamanı durumunu ve JSONL toplama sonuçlarını mevcut kullanıcının ana dizini altındaki .loongsuite-pilot dizinine yazar. Varsayılan yollar aşağıdaki gibidir:

LoongSuite Pilot'ı Yönetme

Yerel pano, LoongSuite Pilot toplama hizmetiyle birlikte başlar ve durur. Ayrı bir izleme komutu çalıştırmanıza gerek yoktur. Toplama hizmeti başladıktan sonra aşağıdaki varsayılan adresi açın. Özel bir bağlantı noktası yapılandırdıysanız, 8765 yerine o bağlantı noktasını kullanın:

http://127.0.0.1:8765/

LoongSuite Pilot'ı kaldırmak ve yerel verileri korumak için aşağıdaki komutu çalıştırın:

macOS / Linux:

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh uninstall

Windows:

.\installer.ps1 uninstall

Hem kurulum dosyalarını hem de yerel verileri kaldırmak için aşağıdaki komutu çalıştırın:

macOS / Linux:

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh uninstall --purge

Windows:

.\installer.ps1 uninstall -Purge

Aracı Toplamayı Yapılandırma

Kurulumdan sonra, yerel yapılandırma dosyasındaki agents bölümünü değiştirerek belirli bir AI Kodlama Aracısından veri toplanıp toplanmayacağını kontrol edebilirsiniz. Varsayılan yapılandırma dosyası yolu aşağıdaki gibidir:

{
  "agents": {
    "claude-code": {
      "enabled": true
    },
    "cursor": {
      "enabled": true
    },
    "qoder": {
      "enabled": false
    }
  }
}

Örneğin, Claude Code ve Cursor'dan veri toplamak ancak Qoder'ı devre dışı bırakmak için yukarıda gösterilen yapılandırmayı kullanın. Yapılandırmayı değiştirdikten sonra LoongSuite Pilot'ı yeniden başlatın:

loongsuite-pilot restart

Veri Maskellemeyi Yapılandırma

LoongSuite Pilot, normalleştirilmiş olaylardaki yaygın kimlik bilgilerini ve kişisel hassas verileri, çıktı arka ucuna gönderilmeden önce maskeleyebilir. Maskeleme, istemler, tamamlamalar, araç parametreleri veya araç sonuçlarının kimlik bilgileri veya kişisel hassas veriler içerebileceği senaryolarda uygulanır.

Maskeleme ilkesini etkinleştirmek veya ayarlamak için yerel yapılandırma dosyasını değiştirin. Varsayılan yapılandırma dosyası yolu aşağıdaki gibidir:

Tüm maskeleme kurallarını etkinleştirmek için:

{
  "mask": {
    "mode": "all"
  }
}

Yalnızca belirli maskeleme kurallarını etkinleştirmek için:

{
  "mask": {
    "mode": "custom",
    "types": [
      "apiKey",
      "idCard",
      "phone",
      "email",
      "ipAddress",
      "bankCard"
    ]
  }
}

Aşağıdaki tabloda maskeleme modları açıklanmaktadır.

Aşağıdaki tabloda maskeleme türleri açıklanmaktadır.

LoongSuite Pilot öncelikli olarak kullanıcı veya araç içeriği içerebilecek alanları tarar, örneğin:

• LLM giriş ve çıkış mesajları.

• Araç çağrısı parametreleri.

• Araç çağrısı sonuçları.

• Bilinen aracı içerik alanları.

Model adları, belirteç sayıları, gecikme süresi, Git dalları ve çalışma alanı yolları gibi kararlı meta veriler, kimlik bilgisi içerik alanları olarak taranmaz.

Yapılandırmayı değiştirdikten sonra LoongSuite Pilot'ı yeniden başlatmak için aşağıdaki komutu çalıştırın:

loongsuite-pilot restart

Dahil Etme Sonucunu Doğrulama

Kurulum veya yapılandırma değişikliklerinden sonra, dahil etmenin başarılı olduğunu doğrulamak için şu adımları izleyin.

loongsuite-pilot status
loongsuite-pilot info

ls ~/.loongsuite-pilot/logs/output
tail -f ~/.loongsuite-pilot/logs/output/*.jsonl

Get-ChildItem "$env:USERPROFILE\.loongsuite-pilot\logs\output"

Get-ChildItem "$env:USERPROFILE\.loongsuite-pilot\logs\output\*.jsonl" |
  Sort-Object LastWriteTime |
  Select-Object -Last 1 |
  Get-Content -Wait

SSS