Bu, Apidog'un API testi ve API yaşam döngüsü yönetimi için bir komut satırı aracı olan Apidog CLI'ı nasıl geliştirdiğini paylaşan 10 bölümlük bir seridir. Sırasıyla okuyun veya ilginizi çeken herhangi bir gönderiye atlayın:
| Başlık | Odak Noktası | |
|---|---|---|
| 1 | 126 MCP Aracı İnşa Ettik. Ama Ajan İçin En İyi Çözüm Bu Değil | Problem keşfi |
| 2 | Neden Yepyeni Apidog CLI Geliştirdik | Mimari geliştirme |
| 3 | Altın Kural: CLI Gerçekleri Üretir, Model Gerçeklere Göre Hareket Eder | Temel felsefe |
| 4 | agentHints: CLI'lara Ajanlarla Konuşmayı Öğretmek |
Yapılandırılmış çıktı |
| 5 | BECERİ: Operasyonel Deneyimi Kod Olarak Göndermek | Operasyonel deneyim |
| 6 | Sayılar Yalan Söylemez: %30 Daha Az Araç Çağrısı, %25 Daha Az Token | Nicel sonuçlar |
| 7 | PRD'den Test Döngüsüne: Apidog CLI ile Eksiksiz Bir Ajan İş Akışı | Pratik eğitim |
| 8 | CI/CD Uyumluluğunun Ajan Araçları İçin Neden Tartışılmaz Olduğu | DevOps perspektifi |
| 9 | Yapay Zeka Dalı: Yapay Zeka Ajanları ile Daha Güvenli Proje Değişiklikleri | Güvenlik katmanı |
| 10 | Önce Şartname Dündü. Önce Beceri'ye Hoş Geldiniz. | Vizyon & gelecek |
API geliştirme, Yapay Zeka Ajanları ile değişiyor. Beceri Odaklı yaklaşım, şartnameleri, testleri ve senaryoları yürütülebilir, doğrulanabilir becerilere dönüştürerek Ajan çağı için mevcut yaklaşımları tamamlıyor.
Şartname Odaklı Dönem
Yıllarca, birçok geliştirme ekibinin işbirliği süreçleri Şartname Odaklıydı.
Neydi Bu?
| Prensip | Açıklama |
|---|---|
| Önce API'leri tasarlayın | Uygulamadan önce API'yi tanımlayın |
| Dokümantasyon etrafında işbirliği yapın | Ekipler paylaşılan şartnameye başvurur |
| Erken mocklayın | Frontend mock'a karşı geliştirme yapabilir |
| Birlikte hata ayıklayın | Sorunlar paylaşılan formatta görünür |
| Şartnameye karşı test edin | Uygulamanın tasarımla eşleştiğini doğrulayın |
| Hazır olunca yayınlayın | Belgelendirilmiş, test edilmiş API'leri yayınlayın |
Değer
| Fayda | Neden Önemli |
|---|---|
| Açık sözleşmeler | Frontend/backend ne bekleyeceğini bilir |
| Paralel geliştirme | Ekipler bağımsız çalışır |
| Azaltılmış sürtünme | Yanlış iletişim erken yakalanır |
| Stabil test | Testler belgelendirilmiş davranışla eşleşir |
| Canlı dokümantasyon | Şartname ürünle birlikte gelişir |
Şartname Odaklı yaklaşım, insan odaklı API geliştirme için doğru yaklaşımdı.
Yeni Tüketici: Yapay Zeka Ajanları
Yapay Zeka Kodlama ortaya çıktıktan sonra, API varlıklarının tüketicileri değişti.
Ajanlar da bu varlıkları tüketmeye başladı.
Ajanların İhtiyaç Duydukları
| Ajan Aktivitesi | Gerekli Varlık |
|---|---|
| Uç noktaları okuyun | API dokümantasyonu |
| Testler ekleyin | Uç nokta tanımları, şemalar |
| Otomasyon çalıştırın | Test senaryoları, ortamlar |
| Raporlara göre kodu düzeltin | Hata detayları, yanıt verileri |
| Değişikliğin kullanılabilir olup olmadığını yargılayın | Test sonuçları, kapsama |
Bu bağlamda, Apidog'daki API dokümantasyonu, test senaryoları ve test durumları yalnızca insanlar için işbirliği materyalleri değildir.
Bunlar, Ajanlar için deterministik olarak çağrılabilir varlıklardır.
Varlık Dönüşümü
| Varlık | Şartname Odaklı (İnsan Görünümü) | Beceri Odaklı (Ajan Görünümü) |
|---|---|---|
| API dokümantasyonu | İşbirliği materyali | Çağrılabilir veri kaynağı |
| Test durumları | Kalite artefaktı | Yürütülebilir doğrulama |
| Test senaryoları | Test iş akışı | Otomasyon hedefi |
| Ortamlar | Yapılandırma | Çalışma zamanı bağlamı |
| Raporlar | İnceleme çıktısı | Geri bildirim sinyali |
Varlıklar "okunabilir"den "çağrılabilir"e dönüşüyor.
Beceri Odaklı Tanım
Şartname Odaklı yaklaşım üzerine inşa etmek:
| Neler Kalıyor | Neden |
|---|---|
| Uç nokta spesifikasyonları | Hala net sözleşmelere ihtiyaç var |
| Test durumları | Hala kalite artefaktlarına ihtiyaç var |
| İş senaryoları | Hala iş akışı kapsamına ihtiyaç var |
| Dokümantasyon | Hala insan referansına ihtiyaç var |
Artı:
| Eklenen Ne | Amaç |
|---|---|
| Yürütülebilir beceriler | Ajanlar iş akışlarını çağırabilir |
| Doğrulanabilir adımlar | Her aşamada kalite kontrolleri |
| İzlenebilir zincirler | Ajan eylemlerinin denetim izi |
Beceri Odaklı = Şartname Odaklı + Ajan yürütme katmanı.
Sistem Mimarisi
| Katman | Sorumluluk | Örnek |
|---|---|---|
| Apidog | API ve test varlıklarını yönetir | Uç noktalar, şemalar, test durumları, senaryolar |
| CLI | Deterministik yürütme sağlar | Komutlar, doğrulama, çıktı |
| BECERİ | Görev yargısı ve yollar sağlar | İş akışı rehberliği, sıralama kuralları |
| Ajanlar | Hedefleri anlar, yürütür, ayarlar | Claude Code, Cursor, Trae, Codex |
Her katmanın belirli bir rolü vardır.
Nasıl Birlikte Çalışırlar
Kullanıcı: "Geri ödeme API'si için testler oluştur ve doğrulama çalıştır"
↓
Ajan: Görev türünü anlar (BECERİ yardımcı olur)
↓
Ajan: Uç noktaları okumak için CLI'yı çağırır (CLI yürütür)
↓
Ajan: Test durumları oluşturur (Ajan yaratır)
↓
CLI: Yapıyı doğrular (cli-şema doğrular)
↓
Ajan: Test durumları yazar (CLI yürütür)
↓
CLI: agentHints döndürür (CLI rehberlik eder)
↓
Ajan: Geri okur, ayarlar (Ajan ipuçlarını takip eder)
↓
Ajan: Testleri çalıştırır (CLI yürütür)
↓
CLI: Rapor döndürür (CLI geri bildirim sağlar)
↓
Ajan: Kullanıcıya özetler (Ajan tamamlar)İş Akışı Dönüşümü
Şartname Odaklı İş Akışı (İnsan Odaklı)
İnsan şartnameyi tasarlar
↓
İnsan belgeler
↓
İnsan mock oluşturur
↓
İnsan hata ayıklaması yapar
↓
İnsan testler yazar
↓
İnsan yayınlarÖzellikler:
| Yön | Açıklama |
|---|---|
| Sürücü | İnsan |
| Odak | İşbirliği |
| Geri Bildirim | Manuel inceleme |
| Hız | İnsan hızı |
| Hatalar | İnsan yakalar |
Beceri Odaklı İş Akışı (Ajan Destekli)
İnsan hedefi belirtir
↓
Ajan mevcut varlıkları okur
↓
Ajan değişiklikler oluşturur
↓
CLI doğrular
↓
Ajan yazar
↓
CLI sonraki adımlara rehberlik eder
↓
Ajan doğrular
↓
İnsan sonucu incelerÖzellikler:
| Yön | Açıklama |
|---|---|
| Sürücü | Ajan (insan hedefi tarafından yönlendirilir) |
| Odak | Yürütme |
| Geri Bildirim | Otomatik doğrulama |
| Hız | Ajan hızı |
| Hatalar | CLI yakalar |
Ekipler Ne Yapmalı
Acil Adımlar
| Adım | Eylem |
|---|---|
| 1. Yükle | npm install -g apidog-cli@latest |
| 2. BECERİ Yükle | apidog skill install |
| 3. Küçük bir görev dene | Ajan'a düşük riskli bir görev ver |
| 4. Desenleri öğren | Ajan iş akışını gözlemle |
| 5. Kapsamı genişlet | Görevin karmaşıklığını kademeli olarak artır |
İlk Ajan Görevi Örneği
Apidog CLI'yı kullanarak Apidog'da ilk API uç noktamı oluşturmama yardım et.
Önce, Apidog CLI kurulumumu kontrol et ve erişebileceğim projeleri listele.
Hangi projeyi kullanacağımı bana sor. Onayladıktan sonra, 200 yanıt örneği
ile Sağlık Kontrolü adlı basit bir GET /health uç noktası oluştur.
Yazmadan önce yapılandırılmış tüm girdiyi doğrula, ardından uç noktayı
geri oku ve ne oluşturulduğunu özetle.Bu şunları sağlar:
| Fayda | Açıklama |
|---|---|
| Kurulum kontrolü | Ajan ortamı doğrular |
| Proje seçimi | Ajan yazmadan önce sorar |
| Küçük oluşturma | Düşük riskli ilk görev |
| Doğrulama | Yazmadan önce cli-şema |
| Geri okuma | Ne oluşturulduğunu doğrular |
| Özet | İnsan net bir sonuç alır |
Başlangıç Komutları
# Apidog CLI'ı yükle
npm install -g apidog-cli@latest
# Eşlik eden BECERİyi yükle
apidog skill install
# Sürümü kontrol et (2.2.5+ gerekli)
apidog -v
# Kimlik doğrula
apidog auth login
# Projeleri listele
apidog project listGelecek
| Trend | Yön |
|---|---|
| Ajan katılımı | API geliştirme görevlerinin daha fazlası Ajanlar tarafından yürütülecek |
| CLI + BECERİ desenleri | Olgun, standartlaştırılmış iş akışları |
| Daha fazla Beceri | Farklı bağlamlar için alana özgü Beceri'ler |
| Daha iyi yakınsama | Kritik düğümler için geliştirilmiş mühendislik |
| İnsan-Ajan işbirliği | İnsan ve Ajan arasında kesintisiz aktarım |
Gelecek, Ajan destekli API geliştirmesidir.
Serinin Tam Özeti
Tüm yolculuğu ele aldık:
| Bölüm | Konu | Temel İçgörü |
|---|---|---|
| 1 | Problem | 126 MCP aracı → rastgele araçlardan oluşan duvar |
| 2 | Dönüm Noktası | Karmaşıklık bağlamdan mühendisliğe kaydı |
| 3 | Felsefe | CLI doğrular, Ajan oluşturur |
| 4 | Tasarım | agentHints sonraki adımlara rehberlik eder |
| 5 | Deneyim | BECERİ iş akışı bilgisini paketler |
| 6 | Doğrulama | %30 daha az çağrı, %25 daha az token |
| 7 | Uygulama | PRD → OpenAPI → Testler → Doğrulama |
| 8 | Temel | CI/CD temel olmaya devam ediyor |
| 9 | Dürüstlük | Dört zorluk devam ediyor |
| 10 | Vizyon | Şartname Odaklı → Beceri Odaklı |
Son Prensip
Şartname Odaklı, insan işbirliği içindi. Beceri Odaklı, Ajan yürütmesi içindir.
| Dönem | Yaklaşım | Tüketici |
|---|---|---|
| Geleneksel | Şartname Odaklı | İnsanlar |
| Ajan Çağı | Beceri Odaklı | İnsanlar + Ajanlar |
Varlıklar çağrılabilir hale gelir. İş akışları yürütülebilir hale gelir. Kalite doğrulanabilir hale gelir.
Beceri Odaklı'ya hoş geldiniz.
Temel Çıkarımlar
- Şartname Odaklı, insan odaklı geliştirme için doğruydu
- Ajanlar artık API varlıklarının tüketicileridir
- Varlıklar okunabilirden çağrılabilir hale dönüşür
- Beceri Odaklı = Şartname Odaklı + Ajan yürütme
- Sistem: Apidog (varlıklar) → CLI (yürütme) → BECERİ (yargılama) → Ajanlar (eylem)
- İnsan hedefi belirler, Ajan yürütür, CLI doğrular
- Küçük başlayın, desenleri öğrenin, kapsamı genişletin
Tek bir çalışma alanında API'leri tasarlamak, mock'lamak, test etmek ve belgelemek için Apidog'u indirin. Komut satırı API testi, CI otomasyonu ve Yapay Zeka Ajan iş akışları için Apidog CLI hakkında daha fazla bilgi edinin.