Apidog CLI, uzun zamandır bir terminalden, CI işlem hattından, otomasyon iş akışından veya harici bir sistemden API testlerini çalıştırmak için komut satırı giriş noktası olmuştur.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId>Bu temel hala önemini koruyor. Ekiplerin hala API testlerini çalıştırmak, raporlar oluşturmak ve CI içinde kalite bariyerlerini sürdürmek için güvenilir bir yola ihtiyacı var. Ancak API geliştirme değişiyor. Yapay Zeka Temsilcileri (AI Agents) artık API tasarımı, test üretimi, hata ayıklama, geçiş ve bakım süreçlerine katılıyor.
Bu iş akışları için bir CLI, yalnızca mevcut testleri çalıştıran son adım olamaz. Aynı zamanda Temsilcilere API varlıklarını okumak, test varlıklarını oluşturmak veya güncellemek, yapılandırılmış değişiklikleri doğrulamak, bunları geri yazmak ve sonucu doğrulamak için istikrarlı bir yol sunmalıdır.
Yükseltilmiş Apidog CLI, orijinal test çalıştırma temelini korur ve geliştiriciler, komut dosyaları ve Yapay Zeka Temsilcileri için bir iş akışı katmanına genişletir. Bu makale, Yapay Zeka Temsilcisi çağında CLI'ın neden daha önemli olduğunu, Apidog CLI'da nelerin değiştiğini ve ekiplerin API testi otomasyonu için bunu nasıl kullanmaya başlayabileceğini açıklıyor.
Yapay Zeka Temsilcisi Çağında CLI Neden Daha Önemli?
Grafik arayüzler insanlar için tasarlanmıştır. Görsel, esnek ve keşif için faydalıdırlar. Ancak Yapay Zeka Temsilcileri, yapılandırılmış komutlar, öngörülebilir girdiler, öngörülebilir çıktılar ve açık doğrulama adımlarıyla en iyi şekilde çalışır.
CLI'ın önem kazandığı yer burasıdır. Bir CLI, Temsilcilere ve komut dosyalarına, geliştiricilerin Apidog'da yönettiği aynı kaynaklara tekrarlanabilir bir arayüz sağlar: API'ler, ortamlar, değişkenler, test senaryoları, test senaryo grupları, test paketleri, raporlar, içe/dışa aktarma verileri ve daha fazlası.
Uygulamada bu, Apidog'un hem insan kullanıcılarına hem de otomatik iş akışlarına hizmet edebileceği anlamına gelir. İnsanlar ürün arayüzünde tasarım yapmaya, hata ayıklamaya, incelemeye ve işbirliği yapmaya devam ederler. Temsilciler ve otomasyon, aynı varlıklar üzerinde kontrollü işlemler gerçekleştirmek için CLI'ı kullanabilir.
apidog run'dan Tam API ve Test İş Akışlarına
Önceki CLI deneyimi ağırlıklı olarak test yürütmeye odaklanmıştı. Bu durum, `apidog run`'ı bir CI kalite bariyeri olarak faydalı kıldı, ancak aynı zamanda CLI'ın genellikle iş akışının sonuna doğru ortaya çıktığı anlamına geliyordu. Yükseltilmiş CLI, daha fazla temel Apidog kaynağına yönelik kapsama alanını genişletir, böylece otomasyon daha erken aşamalarda katılabilir: proje bağlamını okuma, test varlıklarını hazırlama, yapılandırılmış değişiklikleri doğrulama ve ardından doğrulama çalıştırma.
Yükseltilmiş CLI ile kullanıcılar ve Temsilciler aşağıdaki gibi kaynaklarla çalışabilirler:
- Projeler ve proje meta verileri
- API'ler ve API tanımları
- Ortamlar ve değişkenler
- Test senaryoları
- Test senaryo grupları
- Test paketleri
- Raporlar
- İçe ve dışa aktarma iş akışları
- Hesaplar, dallar, çalıştırıcılar ve ilgili proje kaynakları
Bu durum, Apidog CLI'ın rolünü değiştiriyor. Artık her şey bittikten sonra testleri yürütmek için basit bir yol değil. Bir Temsilcinin projeyi anlaması, test varlıklarını oluşturması veya güncellemesi, değişiklikleri doğrulaması ve ardından doğrulama çalıştırması gereken geliştirme döngüsüne daha erken aşamalarda katılabiliyor.
Temsilci Odaklı Test için Daha Güvenli Bir Döngü
Bir Yapay Zeka Temsilcisi API geliştirme veya test etmeye yardımcı olduğunda, riskli kısım yalnızca içerik oluşturmak değildir. Riskli kısım, oluşturulan içeriği yeterli yapı veya doğrulama olmadan gerçek bir projeye yazmaktır.
Yükseltilmiş CLI, daha güvenli bir döngüyü mümkün kılar:
Bu döngü önemlidir çünkü birçok Apidog kaynağı yapılandırılmıştır. Test senaryoları ve test senaryo grupları, istek verileri, onaylamalar, değişken çıkarımı, ön-işlemciler, son-işlemciler, adım sırası, ortam referansları ve diğer detayları içerebilir. Eğer bir Temsilci yapıyı tahmin ederse, küçük hatalar yazma hatalarına, kullanıcı arayüzünde eksik görüntülenmeye veya beklendiği gibi çalışmayan testlere neden olabilir.
İşte bu yüzden `cli-schema` yükseltmenin önemli bir parçasıdır. Apidog'a karmaşık bir JSON dosyası yazmadan önce, bir Temsilci CLI'dan alanların ve yapının beklenen şemayla eşleşip eşleşmediğini doğrulamasını isteyebilir.
apidog cli-schema validate test-case-create --file ./test-case-create.json
apidog cli-schema validate test-scenario-update --file ./scenario-update.jsonKısacası: Temsilcinin oluşturmasına izin verin, ancak yazma işlemi gerçekleşmeden önce CLI'ın doğrulamasını sağlayın.
CLI ayrıca komut çıktısında Temsilci odaklı ipuçları da sağlayabilir. Bir kaynak oluşturulduktan veya güncellendikten sonra, bir sonraki adım genellikle "durmak" değildir. Daha güvenilir bir Temsilci, kaydedilen kaynağı geri okumalı, yapıyı onaylamalı ve uygun olduğunda testleri çalıştırmalıdır. Bu ipuçları, Temsilcilerin iş akışında daha az kör nokta ile ilerlemesine yardımcı olur.
Yetenekler Temsilcilere Operasyonel Muhakeme Yeteneği Kazandırır
CLI komutları bir Temsilciye yürütme gücü verir. Yetenekler ise bir Temsilciye operasyonel muhakeme yeteneği kazandırır.
Bir YETENEK, sadece bir komut referansı değildir. Yapay Zeka Temsilcileri için yazılmış bir işletim kılavuzuna daha yakındır: bir komutu ne zaman kullanmalı, hangi komut önce gelmeli, hangi alanlar tahmin edilmemeli, ne zaman doğrulanmalı, ne zaman geri okunmalı ve ne zaman testler çalıştırılmalı.
Örneğin, güvenilir bir Temsilci her zaman büyük bir test senaryo grubunu sıfırdan elle yazmamalıdır. Daha güvenli bir yöntem genellikle şöyledir:
- Temel senaryo grubunu oluşturun.
- API'lerden veya mevcut test senaryolarından adımları içe aktarın.
- Senaryo grubunun tam yapısını geri okuyun.
- Onaylamaları, değişken çıkarımını veya işlemcileri daha küçük adımlarla güncelleyin.
- Senaryo grubunu doğrulayın ve çalıştırın.
Yetenekler bu yöntemleri açık hale getirir. Temsilcilerin yanlış alan adı kullanma, yanlış enum değeri seçme, şema doğrulamasını atlama veya başarılı bir yazmanın nihai kaynağın zaten doğru olduğu anlamına geldiğini varsayma gibi yaygın hatalardan kaçınmasına yardımcı olur.
Apidog, Temsilcilerin CLI komutlarını, kaynak yapılarını ve görev iş akışlarını anlamalarına yardımcı olmak için 8 yardımcı Yetenek sunar. CLI ve Yetenekler bir araya gelerek Apidog'u yapay zeka destekli API geliştirme ve test etme için daha pratik hale getirir.
Yapay Zeka Dalları ile Daha Güvenli Proje Değişiklikleri
Bir Temsilci proje kaynaklarını değiştirdiğinde, güvenlik ve incelenebilirlik önemlidir. Bu nedenle, yükseltilmiş CLI, **Yapay Zeka Dalları** ile birlikte de kullanılabilir.
Temsilci değişiklikleri önce izole bir dalda yapabilir. Ekip farkları inceleyebilir, sonucu onaylayabilir ve ardından hedef dalla birleştirebilir. Bu, otomatik değişikliklerin ana dalı veya paylaşılan bir işbirliği dalını doğrudan etkilemesini önlemeye yardımcı olur.
Bu, Gerçek İş Akışlarında Neleri Ortaya Çıkarıyor?
Yükseltilmiş CLI'ın değeri, somut iş akışlarında en kolay şekilde görülebilir.
API Tanımlarından Testler Oluşturma
Bir Temsilci, bir projeden API tanımlarını okuyabilir, test senaryoları oluşturabilir, oluşturulan JSON'u `cli-schema` ile doğrulayabilir, test senaryolarını Apidog'a yazabilir, bunları geri okuyabilir ve doğrulama çalıştırabilir. Bu, test üretimini tek seferlik bir öneriden kontrollü bir iş akışına dönüştürür.
Karmaşık Test Senaryo Gruplarını Sürdürme
Çok adımlı senaryo grupları için Temsilci, adımları önce API'lerden veya mevcut test senaryolarından içe aktarabilir, ardından tam yapıyı geri okuduktan sonra onaylamaları, değişkenleri veya işlemcileri güncelleyebilir. Bu, büyük bir senaryo grubunu tek seferde yanlış oluşturma riskini azaltır.
apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual
apidog test-scenario get <scenarioId> --project <projectId> --with-case-detailProje Varlıklarını Taşıma ve Çoğaltma
Yükseltilmiş CLI, Apidog'un yerel verileri için içe ve dışa aktarma iş akışlarını da iyileştirir. Bu, proje geçişi, müşteri ortamlarını çoğaltma, test kurulumlarını kopyalama veya API'leri, şemaları, test senaryolarını ve senaryo gruplarını projeler arasında taşıma için faydalıdır.
apidog export --project <projectId> --format apidog --output ./project.apidog.json
apidog import --project <projectId> --format apidog --file ./project.apidog.jsonCI Kalite Bariyerlerini Sürdürme
Yeni Temsilciye hazır yetenekler CI'ı değiştirmez. Onu tamamlar. Ekipler, otomatik test yürütme ve raporlar için `apidog run`'ı temel giriş noktası olarak kullanmaya devam edebilirler.
apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId> -r "cli,html,junit" --out-dir ./apidog-reportsBaşlarken
Halihazırda Apidog CLI kuruluysa, önce mevcut sürümünüzü kontrol edin:
apidog -v**Apidog CLI sürümünüz** 2.2.5'ten eskiyse, yeni yetenekleri kullanmadan önce CLI'ı güncelleyin. Bu sürüm numarası Apidog uygulamasına değil, Apidog CLI'a atıfta bulunur.
Kullandığınız Yapay Zeka Temsilcisinden hem Apidog CLI'ı hem de yardımcı Yetenekleri yüklemesini bu komut istemini kopyalayarak isteyebilirsiniz:
Read the instructions and help me install Apidog CLI:
https://apidog.com/apidog-cli-installation-guide.mdManuel olarak yüklemeyi veya güncellemeyi tercih ediyorsanız, şunu çalıştırın:
npm install -g apidog-cli@latestTam komut referansı için Apidog CLI Seçenekleri sayfasına bakın.
İlk Temsilci Görevinizi Deneyin
CLI ve Yetenekler yüklendikten sonra başlamanın en kolay yolu, Temsilcinize küçük, düşük riskli bir API görevi vermektir. Örneğin, ondan bir Apidog projesinde basit bir sağlık kontrolü uç noktası oluşturmasını isteyin ve ardından sonucu onaylamak için geri okumasını sağlayın.
Bu komut istemini Yapay Zeka Temsilcinize kopyalayın:
Use Apidog CLI to help me create my first API endpoint in Apidog. First, check my Apidog CLI setup and list the projects I can access. Ask me which project to use. After I confirm, create a simple GET /health endpoint named Health Check with a 200 response example. Validate any structured input before writing, then read the endpoint back and summarize what was created.Bu, yeni kullanıcılara somut bir başlangıç noktası sunar: Temsilci kurulumu kontrol eder, bir projeye yazmadan önce sorar, küçük bir API tanımı oluşturur ve kaydedilen sonucu onaylar.
Sonraki adımlar:
- API'leri tek bir çalışma alanında tasarlamak, hata ayıklamak, test etmek ve belgelemek için Apidog'u indirin.
- Komut satırı API testi, CI otomasyonu ve Yapay Zeka Temsilcisi iş akışları için Apidog CLI hakkında daha fazla bilgi edinin.
Sıkça Sorulan Sorular
Apidog CLI Nedir?
Apidog CLI, API testlerini çalıştırmak, Apidog proje kaynaklarıyla çalışmak ve Apidog API ile test varlıklarını otomasyon iş akışlarına bağlamak için kullanılan bir komut satırı aracıdır.
Apidog CLI, CI'da API testlerini çalıştırabilir mi?
Evet. Ekipler, CI işlem hatlarında `apidog run` komutunu kullanarak API testlerini çalıştırabilir, raporlar oluşturabilir ve test iş akışlarında otomatik kalite bariyerlerini sürdürebilirler.
Apidog CLI, Yapay Zeka Temsilcilerine nasıl yardımcı olur?
Apidog CLI, Yapay Zeka Temsilcilerine API bilgilerini okumak, test varlıklarını oluşturmak veya güncellemek, değişiklikleri doğrulamak, bunları Apidog'a yazmak, sonucu geri okumak ve doğrulama için testleri çalıştırmak için yapılandırılmış bir yol sunar.
Apidog CLI'da cli-schema Nedir?
`cli-schema`, karmaşık JSON dosyalarının Apidog'a yazılmadan önce doğrulanmasına yardımcı olur. Bu, Temsilciler test senaryoları ve test senaryo grupları oluştururken veya güncellerken başarısız yazma işlemlerini, geçersiz alanları ve gereksiz yeniden deneme döngülerini azaltır.
Apidog CLI'ı nasıl yüklerim?
Bir Yapay Zeka Temsilcisinden Apidog CLI kurulum kılavuzunu takip etmesini ve hem CLI'ı hem de yardımcı Yetenekleri kurmasını isteyebilir veya `npm install -g apidog-cli@latest` komutuyla manuel olarak kurabilirsiniz.