Nisan sürümü çoğunlukla tek bir şeyle ilgili: Yapay Zeka Aracısı (AI Agent) geliştirmeyi incelemeyi kolaylaştırmak.
Aracılar oluşturuyorsanız, zor kısmın her zaman nihai cevap olmadığını zaten biliyorsunuzdur. Cevap ortaya çıkmadan önce olan her şeydir. Aracı, kullanıcının ne istediğini düşündü? Hangi aracı çağırdı? O araçtan ne geri geldi? İstek (prompt) başarısız mı oldu, yoksa iş mantığı mı başarısız oldu?
Bu ay, Apidog bu tür çalışmalar için yeni araçlar ekliyor: Yapay Zeka Aracısı Hata Ayıklayıcısı (AI Agent Debugger), A2A Hata Ayıklayıcı (A2A Debugger), daha büyük geçişler için Postman API içe aktarımı, yayınlanmış dokümanlarda daha iyi bir "Yapay Zekaya Sor" (Ask AI) deneyimi ve özel model sağlayıcıları.
İşte değişenler👇
⭐ Yeni Güncellemeler
🔥 Yapay Zeka Aracısı Hata Ayıklayıcısı: Aracının Tüm Çalışmasını İnceleyin
Apidog, bir süredir SSE uç noktaları için görsel hata ayıklamayı destekliyor. Bu, akış modeli yanıtları, ilerleme güncellemeleri, gerçek zamanlı bildirimler ve diğer olay odaklı API'ler için faydalı olmuştur.
Ancak aracı hata ayıklaması, bir akış görüntüleyiciden fazlasına ihtiyaç duyar.
Bir model yanıtı size sadece aracının nerede bittiğini söyler. Oraya nasıl geldiğini söylemez. Gerçek projelerde, genellikle aradaki adımları görmeniz gerekir: konuşma dönüşleri, model çağrıları, MCP araç çağrıları, özel Beceri (Skill) yürütmesi, araç sonuçları ve nihai çıktı.
Yeni Yapay Zeka Aracısı Hata Ayıklayıcısı bunun için geliştirilmiştir.
Sadece nihai yanıtı kontrol etmek yerine, aracının yürütme yolunu Apidog içinde takip edebilirsiniz. Her konuşma turu, model çağrısı, MCP aracı çağrısı, Beceri çalıştırması ve nihai sonuç tek bir yerde kaydedilir.
Bu, pratik hata ayıklama sorularını yanıtlamayı çok daha kolaylaştırır:
- İstek (prompt) modele yeterli bağlam sağladı mı?
- Aracı doğru aracı seçti mi?
- MCP aracı beklenen sonucu döndürdü mü?
- Sorun model yapılandırmasından, araç parametrelerinden mi, yoksa iş mantığından mı kaynaklandı?
Aracı sistemleri hızla karmaşık hale gelebilir. Bu, ekiplere gerçekte ne olduğunu görmeleri için daha temiz bir yol sunar.
🤝 A2A Hata Ayıklayıcısı: Aracılar Arası İletişimi Test Edin
Çoklu aracı sistemleri daha yaygın hale geliyor. Aracılar birlikte çalışmaya başladığında, görevleri geçip, mesajları doğru şekilde değiştirip sonuçları doğru bir şekilde döndürüp döndürmediklerini kontrol etmek için güvenilir bir yola ihtiyacınız vardır.
Apidog artık Google'ın A2A veya Aracılar Arası (Agent-to-Agent) protokolü için hata ayıklamayı destekliyor.
A2A isteklerini doğrudan gönderebilir, istek parametrelerini inceleyebilir, yanıtları kontrol edebilir ve etkileşimin sonucunu doğrulayabilirsiniz. Bu, ekiplerin ayrı araçlar arasında geçiş yapmadan veya ham protokol detaylarını elle okumadan aracılar arası iletişimi test etmelerine yardımcı olur.
İki yeni hata ayıklama aracı arasındaki fark basittir:
- Yapay Zeka Aracısı Hata Ayıklayıcısı, tek bir aracının bir görevi yürütürken içinde neler olduğunu kontrol eder.
- A2A Hata Ayıklayıcısı, bir aracının başka bir aracıyla iletişim kurup kuramayacağını kontrol eder.
Aracılar üzerinde çalışan çoğu ekip er ya da geç her ikisine de ihtiyaç duyacaktır.
📦 Postman API Aracılığıyla Postman Verilerini İçe Aktarın
Postman geçişi artık daha büyük ekipler için daha iyi bir seçeneğe sahip.
Apidog zaten yerel Postman dosyalarını içe aktarmayı destekliyordu. Artık Çalışma Alanlarını (Workspaces), Koleksiyonları (Collections) ve Ortamları (Environments) Postman API aracılığıyla da içe aktarabilirsiniz.
Bu, yeni projeler oluştururken toplu geçiş için tasarlanmıştır. Uygulamada, tüm bir Postman Çalışma Alanını Apidog'a taşımaya daha yakındır. Postman hesabınızda birden fazla Çalışma Alanı varsa, Apidog içe aktarımdan sonra karşılık gelen projeleri oluşturacaktır.
Bu, daha az yerel dışa aktarma, yükleme ve temizleme adımı anlamına gelir. Küçük içe aktarımlar için yerel dosyalar hala işe yarar. Daha büyük çalışma alanı geçişleri için API yolu çok daha az zahmetli olmalıdır.
📄 Yayınlanmış Belgelerdeki "Yapay Zekaya Sor" Artık Yan Panelde Açılıyor
Yayınlanmış belgelerdeki "Yapay Zekaya Sor" artık bir yan panelde çalışıyor.
Okuyucular, mevcut belgeyi açık tutarak onun hakkında sorular sorabilirler. Bu küçük bir kullanıcı arayüzü değişikliği gibi görünse de, çok fazla ileri-geri gitmeyi ortadan kaldırıyor. API belgelerini okuyabilir, bir soru sorabilir, takip edebilir ve yine de sayfadaki yerinizi koruyabilirsiniz.
Özellikle, cevabın sayfanın bir yerinde olabileceği ancak hızlıca bulunmasının zor olduğu daha uzun belgeler için çok kullanışlıdır.
🧠 Özel Yapay Zeka Model Sağlayıcıları
Ekipler, özel bir Temel URL ile özel sağlayıcıları da bağlayabilir. Şirketiniz zaten kendi barındırdığı bir model hizmeti veya dahili bir model geçidi kullanıyorsa, bir yapay zeka ile ilgili iş akışında hata ayıklamanız gerektiğinde her seferinde araç değiştirmek yerine bu kurulumu Apidog'a getirebilirsiniz.
🐞 Hata Düzeltmeleri ve Küçük İyileştirmeler
Bu ay ayrıca bir dizi düzeltme ve yaşam kalitesi güncellemesi yayınladık:
- OpenAPI akıllı birleştirmesinin uç nokta yanıt örneklerini korumadığı bir sorun düzeltildi.
- Bir alt daldan korumalı bir ana dala birleştirmenin, seçili olmayan uç noktaları içerebileceği bir sorun düzeltildi.
- Dallardan uç nokta sürümleri oluştururken yanlış açılır menü gösterimi düzeltildi.
- CLI aracılığıyla testler çalıştırılırken TestData ve TestCase'lerin çalışmadığı bir sorun düzeltildi.
- OpenAPI dışa aktarımının alakasız modüllerden yanıt bileşenlerini içerdiği bir sorun düzeltildi.
- Yorumlu JSON için Markdown dışa aktarım biçimlendirmesi düzeltildi.
crypto is not definedhatasından kaynaklanan bir Word dışa aktarım hatası düzeltildi.- Temel Kimlik Doğrulama (Basic Auth) etkinleştirilmiş Knife4j'yi içe aktarırken kullanıcı adı ve parola alanlarının gösterilmediği bir sorun düzeltildi.
- Etiketler sayı olduğunda bir uç nokta filtreleme hatası düzeltildi.
apidog endpoint list --branchkomutunun belirtilen dal için veri döndürmediği bir sorun düzeltildi.- Birkaç MCP aracı parametresi, filtreleme ve hata mesajı sorunu düzeltildi.
- Oluşturulan kodun
typescriptThreePlusyapılandırma seçeneğini içermediği bir sorun düzeltildi.
🌟 Bunun Anlamı
Nisan, Yapay Zeka Aracısı ürünleri geliştiren ekipler için pratik bir sürümdür.
Yapay Zeka Aracısı Hata Ayıklayıcısı, tek bir aracı çalışmasını incelemenize yardımcı olur. A2A Hata Ayıklayıcısı, aracılar arasındaki iletişimi test etmenize yardımcı olur. Postman API içe aktarımı, geçişi daha az zahmetli hale getirir. "Yapay Zekaya Sor" yan paneli, yayınlanmış belgelerin kullanımını kolaylaştırır. Özel model sağlayıcıları, ekiplere yapay zeka kurulumları üzerinde daha fazla kontrol sağlar.
Bunların hiçbiri gösterişli olmak uğruna gösterişli değil. Bunlar, aracı geliştirme demolar aşamasından gerçek projelere geçtiğinde ihtiyaç duymaya başlayacağınız türden araçlardır.
💬 Sohbetimize Katılın
Diğer API mühendisleri ve Apidog ekibiyle bağlantı kurun:
- Gerçek zamanlı tartışmalar ve destek için Discord topluluğumuza katılın.
- Teknik konuşmalar için Slack topluluğumuza katılın.
- En son güncellemeler için X (Twitter)'da bizi takip edin.
Not: Tüm güncellemeler hakkında tam ayrıntılar için Apidog Değişiklik Günlüğü'nü kontrol edin!
Saygılarımızla,
Apidog Ekibi