Ana içeriğe atla

​
Genel Bakış

Nudgen CLI, Yapay Zeka Odaklı bir yaklaşımla tasarlanmıştır. İnsanlar için güzel bir TUI sunarken, her komut aynı zamanda makineler arası iletişim için optimize edilmiştir.

​
Agentic Model

Bir yapay zeka ajanı (Claude, GPT veya özel bir otomasyon ajanı gibi) CLI’yı kullandığında şu modelleri izlemelidir:
  1. JSON Çıktısı: Makine tarafından yorumlanabilir veriler almak için her komutun sonuna --json ekleyin.
  2. Bağlam Farkındalığı: İşlemleri gerçekleştirmeden önce daima ekip bağlamını doğrulayın.
  3. Etkileşimsiz: Etkileşimli TUI istemlerini atlamak için ilgili bayrakları (flags) kullanın.

​
JSON Otomasyonu

Her liste ve durum komutu bir --json bayrağını destekler. Bu, biçimlendirilmiş bir tablo yerine temiz bir JSON yapısı döndürür. 
# Tüm kampanyaları JSON formatında al
nudgen campaigns list --json

# Mevcut ekipteki kişileri al
nudgen contacts list --json

​
Ajanlar için Çoklu Ekip Çalışma Alanı

Nudgen birden fazla ekibi desteklediğinden, bir ajan kaynakları oluşturmadan veya güncellemeden önce doğru ekipte işlem yaptığından emin olmalıdır. Önerilen İş Akışı:
  1. Mevcut Ekibi Kontrol Et: 
    nudgen teams current --json
  2. Ekibi Değiştir (Gerekirse): Önceki adımdaki id, hedef ekip ile eşleşmiyorsa geçiş yapın: 
    nudgen teams switch <target-team-id>
  3. Veri Komutunu Çalıştır: campaigns, contacts veya brand komutlarıyla devam edin.

​
Ajan Geliştiricileri İçin En İyi Pratikler

  • Hata Yönetimi: Çıkış kodunu (Exit Code) izleyin. Sıfır olmayan bir çıkış kodu, bir hatayı (doğrulama, ağ veya yetkilendirme) gösterir.
  • Hız Sınırı (Rate Limiting): CLI, Nudgen API’si ile iletişim kurar. Ajan betiklerinizin hız sınırlarını uygun şekilde yönettiğinden emin olun.
  • Sessiz Mod: Bir komutun her istem için belirli bir bayrağı yoksa, ajanınızın TUI döngüsünde takılı kalmadan stdout/stderr akışlarını yönetebildiğinden emin olun.