Hermes Agent terminalinizden çalışır, oturumlar arasında öğrendiklerini hatırlar ve işleri halletmek için gerçek kabuk komutlarına başvurur. Son kısım başlangıç noktasıdır: eğer bir komut çalıştırabiliyorsa, API testlerinizi de çalıştırabilir.
Bunları bağlayan çalıştırıcı, apidog-cli adlı bir npm paketi olan Apidog CLI'dır. Apidog'da görsel olarak oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştırır ve Hermes'in üzerinde işlem yapabileceği bir durum koduyla çıkar. Bu kılavuz, Hermes'e özgü yarıyı kapsar: komutu çalıştıran terminal aracı, Hermes'e iş akışınızı öğreten bağlam dosyası, çalıştırmanın kendi döngüsüne nasıl dahil olduğu ve Hermes'e çalışırken API spesifikasyonunuzu sunan isteğe bağlı Apidog MCP sunucusu.
CLI henüz yüklü değilse, bir ajanı yükleme ve kimlik doğrulama sürecinde yönlendiren bir yapay zeka kodlama aracısıyla Apidog CLI nasıl yüklenir kılavuzuyla başlayın. apidog --version bir sayı yazdırdığında geri gelin. Ayrıca, en az bir kaydedilmiş test senaryosu olan bir Apidog hesabına ihtiyacınız var; eğer yoksa Apidog'u indirin.
"Hermes'te CLI'ı kullanmak" ne anlama geliyor
Nous Research tarafından geliştirilen Hermes Agent, terminalinizde çalışır, yapay zeka modellerinizle iletişim kurar ve yerleşik araçlar aracılığıyla hareket eder. Burada önemli olan terminal aracıdır: Hermes, çalışma dizininizde onu çağırarak kabuk komutlarını çalıştırır, ardından çıktıyı kendi muhakemesine geri okur. Yüklenecek bir Apidog eklentisi yoktur ve buna ihtiyacınız da yoktur. Hermes'te Apidog CLI'ı kullanmak üç şey anlamına gelir:
- Hermes'e iş akışını bir kez öğretin: Hermes'in başlangıçta yüklediği bir bağlam dosyasına yazarak, böylece komutu, bayrakları ve çıkış kodunun doğruluk kaynağı olduğunu bilir.
- Hermes'in
apidog runkomutunu çalıştırmasını sağlayın:terminalaracı aracılığıyla, diğer komutlar gibi. - İsteğe bağlı olarak Apidog MCP sunucusunu bağlayın: Böylece Hermes, bu testlerin kontrol ettiği kodu yazarken API spesifikasyonunuzu okuyabilir.
Bağlam dosyası, bunu genel bir "terminali aç ve yaz" kılavuzu yerine Hermes'e özgü bir şekle sokar ve tek seferlik "testlerimi çalıştır" komutunu kendi başına başvurduğu bir şeye dönüştürür.
Mekanizma: bir bağlam dosyası, sohbet hatırlatıcısı değil
Hermes, bir oturumun başlangıcında proje bağlamını yükler. Bağlam motoru, çalışma dizininizi CLAUDE.md ve AGENTS.md dahil olmak üzere talimat dosyaları için tarar ve bunları sistem istemine enjekte eder. Bu, Claude Code ve Codex'in kullandığı aynı kuraldır, bu nedenle deponuzda zaten bir AGENTS.md varsa, Hermes onu da okur.
İşte bu yüzden CLI'ı sohbette belirtmek yerine bir bağlam dosyasına yazarsınız. Bir oturuma yazılan bir senaryo kimliği, oturum sona erdiğinde kaybolur; AGENTS.md dosyasındaki ise bundan böyle her takım arkadaşı ve her Hermes çalıştırması için orada olacaktır. (Hermes ayrıca bir SOUL.md okur, ancak bu ajanın kişiliği içindir, projeniz için değil. Test talimatlarını AGENTS.md içinde tutun.)
Adım 1: Bağlam dosyanıza bir Apidog bloğu ekleyin
Deponuzun kök dizinindeki AGENTS.md dosyasını açın veya oluşturun ve Hermes'e CLI'ın var olduğunu, nasıl çalıştırılacağını ve sonucun nasıl okunacağını anlatan bir bölüm ekleyin. Ona gerçek komutu ve kimliği verin, bir açıklama değil.
## API testing with the Apidog CLI
This repo uses the Apidog CLI (`apidog-cli`, the `apidog` command) to run API
test scenarios. The scenarios live in our Apidog project, not in this repo.
When you change an API handler, route, or response shape, run the relevant
Apidog scenario through the terminal tool before considering the change done:
apidog run -t 605067 -e 1629989 -n 1 -r cli
- `-t 605067` is the checkout-flow test scenario.
- `-e 1629989` is the staging environment.
- The machine is already authenticated via `apidog login`, so do NOT pass
an access token and do NOT print one.
Treat the exit code as the source of truth: `0` means every assertion passed,
non-zero means a failure. If it exits non-zero, read the failing assertion in
the report and fix the code, then re-run. Do not report a pass on a non-zero
exit.
605067 yerine gerçek senaryo kimliğinizi ve 1629989 yerine Hermes'in normal çalışması sırasında vurması gereken ortamı (genellikle hazırlık veya yerel geliştirme, asla üretim değil) yazın. Doğru kimlikleri almak için, Apidog'un senaryonun CI/CD sekmesinde (sonraki bölümde ele alınacak) oluşturduğu apidog run komutunu kopyalayın ve erişim jetonunu yapıştırmadan önce çıkarın, çünkü makine zaten oturum açmış durumdadır ve bir jeton taahhüt edilmiş bir dosyada bulunmamalıdır.
Bu bloğu iki şey çalışır hale getirir. Komutu tam olarak adlandırır, böylece Hermes bayrakları tahmin etmez. Ve geçme/kalma kuralını sade bir dille belirtir, böylece Hermes'in çıkış kodunun kendi özetinden daha öncelikli olduğunu bilir, bu da sizi en yaygın ajan hatasından kurtarır: kırmızı bir çalıştırmanın üzerine kendinden emin bir "testler geçti" ifadesi.
Adım 2: Apidog'dan komutu alın
Hermes'ten herhangi bir şey çalıştırmasını istemeden önce bilinen iyi bir komut alın. Senaryonuzu Apidog'da açın, CI/CD sekmesine geçin ve komut satırı seçeneğini belirleyin. Apidog, kimlikler ve erişim jetonu önceden doldurulmuş olarak tam apidog run komutunu oluşturur:
apidog run --access-token YOUR_ACCESS_TOKEN -t 605067 -e 1629989 -n 1 -r cli
605067 senaryo kimliği ve 1629989 ortam kimliğidir; sizinkiler farklı olacaktır. Kurulum sırasında CLI'ı doğruladığınız için, --access-token kısmını çıkarın ve kimlikleri koruyun. Bağlam dosyanızın Hermes'e kullanmasını söylediği komut budur.
Adım 3: Hermes'in testi çalıştırmasını sağlayın
Deponuzda Hermes'i başlatın, ardından kontrolü çalıştırmasını isteyin. Blok yerindeyken, istem kısadır:
AGENTS.md'nin anlattığı şekilde Apidog API test senaryomuzu çalıştırın. Zaten kimliği doğrulanmış durumdayım, bu yüzden bir erişim jetonu geçmeyin. apidog run -t 605067 -e 1629989 -n 1 -r cli kullanın. Bana tam çıktıyı gösterin ve çıkış kodunu söyleyin.Hermes, komutu çalışma dizininizde yürütmek için terminal aracını çağırır ve -r cli raporlayıcısı, her bir isteği ve onayı izlediğiniz bağlamına adım adım bir sonuç akışı sağlar. Hermes komutları bir onay katmanı aracılığıyla yönlendirdiği için, yapılandırmanıza bağlı olarak çalıştırmadan önce bir istem görebilirsiniz. Hazırlık ortamına karşı salt okunur bir test senaryosu, izin verilmesi uygun olan güvenli, çalışma alanında bir komut türüdür.
Kontrolünüz: özete değil, çıkış koduna bakın. apidog run, her onay geçtiğinde 0, biri başarısız olduğunda ise sıfır olmayan bir kodla çıkar. Bu davranış, bunun bir geçit olarak çalışmasının, CI ve Hermes için, tüm nedenidir. Eğer Hermes “testler geçti” der ama çıkış kodu sıfır değilse, bu yanlıştır; koda güvenin. Bu, Adım 1 bloğunun önlediği hatadır.
Farklı bir rapor formatı veya daha fazla yineleme için, Hermes'in gerçek bayrak listesini okuması için apidog run --help komutunu çalıştırmasını sağlayın. Tam Apidog CLI kılavuzu, html, json ve junit raporlayıcıları dahil olmak üzere her bayrağı belgelemektedir.
Adım 4: Hermes'in kendi döngüsü içinde test yapması
Mesele, siz sormayı bıraktığınızda ve AGENTS.md ona söylediği için Hermes senaryoyu kendi başına çalıştırdığında ne olduğudur. Bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin: kodu düzenler, terminal aracı aracılığıyla hazırlık ortamına karşı Apidog senaryonuzu çalıştırır, çıkış kodunu okur ve ona göre hareket eder. Yeşilse, devam eder. Kırmızıysa, raporu açar, hangi onaylamanın başarısız olduğunu okur (durum kodu, eksik alan, yanlış değer), bir düzeltme dener ve tekrar çalıştırır. API testi, zaten birim testlerinizi yürüttüğü aynı düzenleme-test-düzeltme döngüsünün bir parçası haline gelir. Tek bir talimat yazdınız ve komutu zaten çalıştığı sisteme entegre etti.
Bu, herhangi bir ajan iş akışını güvenli kılan delege et-doğrula modelidir. Hermes komutu çalıştırır ve sonucu okur; siz Apidog'da senaryolar yazmaya devam edersiniz ve çıkış kodlarını dürüstçe okuyup okumadığını kontrol edersiniz. Yavaş bir çalıştırma, büyük bir klasör veya yüksek yineleme sayısı için, terminal aracı background=true bayrağını alır, böylece Hermes taramayı başlatabilir, çalışmaya devam edebilir ve engellemek yerine çıkış kodunu sorgulayabilir. Daha geniş kalıp için, API testleri için yapay zeka ajanları nasıl kullanılır ve Apidog yapay zeka test donanımına bakın.
İsteğe bağlı: Apidog MCP sunucusunu bağlayın
CLI, Hermes'in çalıştırmasını sağlar; Apidog MCP sunucusu ise kod yazarken API spesifikasyonunuzu okumasını sağlar. İkisi birbiri üzerine kuruludur: MCP, Hermes'e şemanızı besler, böylece sözleşmeye uygun kod üretir, ve CLI bu kodu gerçek senaryolara karşı doğrular.
Hermes, Model Bağlam Protokolü'nü kutudan çıkar çıkmaz destekler. ~/.hermes/config.yaml dosyasını düzenleyin ve mcp_servers bölümünün altına bir giriş ekleyin. Apidog'unki gibi yerel bir stdio sunucusu için bu, bir command, bir args dizisi ve herhangi bir env değeridir:
mcp_servers:
apidog:
command: "npx"
args: ["-y", "apidog-mcp-server@latest", "--project=YOUR_PROJECT_ID"]
env:
APIDOG_ACCESS_TOKEN: "YOUR_ACCESS_TOKEN"
Kaydettikten sonra, Hermes içinde /reload-mcp komutunu çalıştırın veya yeniden başlatın. Hermes, başlangıçta MCP sunucularını keşfeder ve araçlarını mcp_apidog_<tool> olarak adlandırılmış normal kayıt defterine kaydeder, böylece ajan normal akıl yürütme sırasında bunlara başvurabilir. Proje kimliği ve jetonu dahil tam kurulum için Apidog MCP sunucusu kılavuzuna bakın. Bu döngünün paketlenmiş bir versiyonu için Claude Becerileri ile Apidog CLI kılavuzuna bakın.
Yerel döngüden CI'a
Hermes senaryoyu yerel olarak çalıştırıp çıkış koduna göre hareket ettiğinde, ardışık düzeninizin kullanacağı tam komutu doğrulamış olursunuz. CI'a geçiş küçüktür: aynı apidog run komutu, ancak jeton depolanan bir giriş yerine maskeli bir sır olarak geçirilir. Hermes'ten adımı yazmasını isteyin, çünkü komutu bağlam dosyanızdan biliyor:
apidog-cli'yi kuran ve erişim jetonunu APIDOG_ACCESS_TOKEN adlı bir depo sırrından okuyarak apidog run -t 605067 -e 1629989 -r junit komutunu çalıştıran bir GitHub Actions adımı yazın.Bu adımın mekaniği (sırlar, raporlayıcılar, çıkış kodu kontrolü) GitHub Actions'ta Apidog CLI kılavuzunda yer almaktadır. Aynı komut daha sonra terminalinizde, Hermes'in döngüsünde ve CI'da olmak üzere üç yerde, hepsi tek bir çıkış koduyla çalışır.
Sık karşılaşılan sorunlar
- Hermes bağlam bloğunu yok sayıyor. Genel bir komut veya hiç komut çalıştırmazsa, dosyanın adının tam olarak
AGENTS.md(veyaCLAUDE.md) olduğunu ve Hermes'in başladığı dizinde bulunduğunu doğrulayın. Oturumu yeniden başlatmak yeni bir okuma yapılmasını sağlar. - Sadece komutu çalıştırmak yerine öneriyor. Hermes, komutları bir onay katmanının arkasındaki
terminalaracı aracılığıyla çalıştırır. Bekleyen bir çalıştırmayı onaylayın; eğer yapılandırmanız terminal komutlarını reddediyorsa,apidog runiçin izni gevşetin. apidog whoamikimliğinizin doğrulanmadığını gösteriyor. Giriş, Hermes'te değil, makinenizde saklanır. Kendiniz yeni bir jetonlaapidog login --with-tokenkomutunu çalıştırın, ardından Hermes'tenapidog whoamiile onaylamasını isteyin. Jetonu sohbetin dışında tutun.- Bir bayrak uyduruyor. Bir "bilinmeyen seçenek" hatası, Hermes'in sürümünüzde bulunmayan bir bayrağı tahmin ettiği anlamına gelir.
apidog run --helpkomutunu çalıştırmasını sağlayın ve gerçek bayrağı kopyalayın. - Başarısız bir çalıştırmada geçti raporu veriyor. En maliyetli olanı ve çıkış kodu kuralının hem
AGENTS.mddosyanızda hem de manuel kontrolünüzde olmasının nedeni budur. Özet ile çıkış kodu uyuşmadığında, kod kazanır.
Özet
Hermes kurulumu tek bir dosya ve tek bir alışkanlıktan ibarettir: komutu, kimlik doğrulama kaynağını ve çıkış kodu kuralını sabitleyen bir AGENTS.md bloğu, ayrıca Hermes'in apidog run komutunu terminal aracı aracılığıyla çalıştırmasına izin verme ve çıkış kodunu kendiniz kontrol etme alışkanlığı. Apidog MCP sunucusunu ~/.hermes/config.yaml aracılığıyla ekleyin, böylece kod yazarken spesifikasyonunuzu da okuyabilir.
Senaryoları Apidog'da görsel olarak yazmaya devam edersiniz; Hermes sadece onları çalıştırır. Buradan, aynı komutu GitHub Actions'ta Apidog CLI ile ardışık düzeninize yönlendirin veya tam kılavuzdaki tüm bayrak referansını okuyun.
Sıkça sorulan sorular
Apidog CLI'yı kullanmak için bir Hermes eklentisine ihtiyacım var mı?
Hayır. Hermes, kabuk komutlarını terminal aracı aracılığıyla çalıştırır, bu nedenle apidog run komutunu doğrudan çağırır. Hermes'e özel tek kurulum, AGENTS.md bloğu ve isteğe bağlı MCP sunucusudur.
Hermes'e iş akışını öğreten talimatları nereye koymalıyım?
Hermes'in başlangıçta yüklediği bir bağlam dosyasına. Bağlam motoru, çalışma dizinini AGENTS.md ve CLAUDE.md gibi dosyalar için tarar ve bunları sistem istemine enjekte eder. Apidog bloğunuzu repo kökündeki AGENTS.md dosyasına koyun ve o repodaki her oturum onu okuyacaktır.
Hermes'in geçen bir testi sahte bildirmemesini nasıl sağlarım?
Sadece bir özet değil, çıkış kodunu rapor etmesini sağlayın ve bu kodu kendiniz kontrol edin. apidog run yalnızca her onay geçtiğinde 0 ile çıkar. Düz yazı ve kod uyuşmadığında, koda güvenin.
Apidog MCP sunucusunu Hermes'e nasıl bağlarım?
~/.hermes/config.yaml dosyasına apidog-mcp-server komutu ve proje kimliğinizle bir mcp_servers girişi ekleyin, ardından /reload-mcp komutunu çalıştırın veya Hermes'i yeniden başlatın. Başlangıçta sunucuyu keşfeder ve araçlarını kaydeder. Apidog MCP sunucusu kılavuzu proje kimliğini ve jetonu kapsar.
Bu, diğer yapay zeka kodlama ajanlarında da aynı şekilde çalışır mı?
CLI her yerde aynıdır; sadece ajana öğretme şekli farklılık gösterir. Hermes AGENTS.md dosyasını okur ve komutları terminal aracı aracılığıyla çalıştırır; diğer ajanlar kendi talimat dosyalarını kullanır. Kurulum ve kimlik doğrulama aynıdır, bu nedenle kurulum kılavuzu herhangi bir ajan için geçerlidir.