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

AI Ajan Entegrasyonuna Genel Bakış

Claude Code, Cursor ve Cline gibi AI kodlama asistanlarının otonom dağıtım ve yönetim için Rediacc altyapısıyla nasıl entegre olduğu.

AI kodlama asistanları, rdc CLI aracılığıyla Rediacc altyapısını otonom olarak yönetebilir. Bu kılavuz entegrasyon yaklaşımlarını ve nasıl başlayacağınızı kapsar.

Neden Self-Hosted + AI Ajanları

Rediacc’ın mimarisi doğal olarak ajan dostudur:

  • 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

Bu, ajana mevcut komutlar, mimari ve kurallar hakkında tam bağlam sağlar.

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 query\" or \"rdc config repository list\""
  }]
}

3. Ajan Yetenekleri Keşfi

rdc agent alt komutu yapılandırılmış iç gözlem sağlar:

# List all commands with arguments and options
rdc agent capabilities

# Show detailed schema for a specific command
rdc agent schema "machine query"

# Execute a command with JSON stdin
echo '{"name": "prod-1"}' | rdc agent exec "machine query"
CLI başvurusu: rdc agent capabilities · rdc agent schema

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

Sonraki Adımlar