Ana içeriğe atla Navigasyona atla Alt bilgiye atla

AI Ajan Entegrasyonuna Genel Bakış

Claude Code, Cursor ve Cline'ın rdc aracılığıyla Rediacc altyapısını nasıl yönettiği: JSON çıktısı, ajan iç gözlemi ve güvenlik koruyucuları.

Açıkçası, rdc tasarım gereği ajan bilinçlidir. Claude Code, Cursor, Cline: bir alt kabukta rdc çağıran herhangi bir AI asistanı yapılandırılmış JSON çıktısı, makine tarafından okunabilir hatalar ve otonom Rediacc altyapı yönetimi için isteyeceğiniz güvenlik koruyucularını elde eder. Entegrasyonun nasıl çalıştığına bakalım.

Neden Self-Hosted + AI Ajanları

Rediacc’ın mimarisi ajanlar için oldukça uygun çalışır:

  • CLI öncelikli: Her işlem bir rdc komutudur, GUI gerekmez
  • SSH tabanlı: Ajanların eğitim verilerinden en iyi bildiği protokol
  • JSON çıktı: Tüm komutlar tutarlı bir zarfla --output json destekler
  • Docker izolasyonu: Her depo kendi daemon’ına ve ağ ad alanına sahiptir
  • Betiklenebilir: --yes onayları atlar, --dry-run yıkıcı işlemleri önizler

Entegrasyon Yaklaşımları

1. AGENTS.md / CLAUDE.md Şablonu

Başlamanın en hızlı yolu. AGENTS.md şablonumuzu proje kök dizininize kopyalayın:

  • Claude Code için CLAUDE.md
  • Cursor için .cursorrules
  • Windsurf için .windsurfrules

Dosyayı yerleştirin; ajan tahmin etmek zorunda kalmadan çalışabilmek için ihtiyaç duyduğu tam komut referansına, mimari bağlama ve kurallara sahip olur.

2. JSON Çıktı Hattı

Ajanlar rdc’yi bir alt kabukta çağırdığında, çıktı otomatik olarak JSON’a geçer (TTY olmayan algılama). Her JSON yanıtı tutarlı bir zarf kullanır:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

Hata yanıtları retryable ve guidance alanlarını içerir:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine status\" or \"rdc repo list\""
  }]
}

Ajanlar İçin Temel Bayraklar

BayrakAmaç
--output json / -o jsonMakine tarafından okunabilir JSON çıktısı
--yes / -yEtkileşimli onayları atla
--quiet / -qBilgilendirici stderr çıktısını bastır
--fields name,statusÇıktıyı belirli alanlarla sınırla
--dry-runYıkıcı işlemleri çalıştırmadan önizle

Güvenlik ve Koruyucular

CLI, ajanları terminaldeki bir kullanıcıyla aynı şekilde ele almaz. Hassas işlemlerin gerçekleştirilebilmesi için mevcut durumu önceden bildiğinizin kanıtlanması gerekir (--current bayrağı), etkileşimli editör akışları varsayılan olarak reddedilir ve her red işlemi denetim günlüğüne kaydedilir. AI Ajan Güvenliği ve Koruyucular referansı tam güvenlik duvarı tablosunu, bilgi geçidi modelini, REDIACC_ALLOW_CONFIG_EDIT kapsam geçersiz kılma özelliğini ve karma zincirli denetim günlüğünü kapsar.

Sonraki Adımlar