APIDOG Nisan Güncellemeleri: Yapay Zeka Agent Hata Ayıklayıcı, A2A Hata Ayıklayıcı ve Kolay Postman Geçişi

Nisan sürümü, Yapay Zeka Aracısı (AI Agent) geliştirme sürecini daha kolay incelemek ve hata ayıklamak için yayınlandı.

Apidog'u bugün deneyin

Aracı geliştirirken zor olan kısım çoğu zaman nihai cevap değildir. Asıl sorun, cevaba gelene kadar ne olduğunu anlayabilmektir:

• Aracı kullanıcının isteğini nasıl yorumladı?
• Hangi aracı çağırdı?
• Araçtan hangi çıktı döndü?
• Sorun prompt tarafında mı, araç parametrelerinde mi, yoksa iş mantığında mı?

Bu sürümde Apidog, bu soruları daha hızlı yanıtlamak için birkaç pratik özellik ekliyor:

• Yapay Zeka Aracısı Hata Ayıklayıcısı
• A2A Hata Ayıklayıcısı
• Postman API üzerinden içe aktarma
• Yayınlanmış belgelerde yan panelde çalışan “Yapay Zekaya Sor”
• Özel yapay zeka model sağlayıcıları

⭐ 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ı destekliyordu. Bu; akış model yanıtları, ilerleme güncellemeleri, gerçek zamanlı bildirimler ve olay odaklı API’ler için kullanışlıydı.

Ancak aracı hata ayıklaması yalnızca akışı izlemekten daha fazlasını gerektirir.

Bir model yanıtı genellikle sadece aracının nerede bittiğini gösterir. Geliştirme sırasında ise asıl ihtiyaç, aracının oraya nasıl geldiğini görebilmektir.

Yeni Yapay Zeka Aracısı Hata Ayıklayıcısı ile Apidog içinde şu adımları tek yerden inceleyebilirsiniz:

• Konuşma turları
• Model çağrıları
• MCP araç çağrıları
• Beceri (Skill) yürütmeleri
• Araç sonuçları
• Nihai çıktı

Bu özellikle aşağıdaki hata ayıklama senaryolarında işe yarar:

Kullanıcı isteği
  ↓
Model çağrısı
  ↓
Araç seçimi
  ↓
MCP aracı / Skill yürütmesi
  ↓
Araç sonucu
  ↓
Nihai cevap

Pratikte şu soruları daha hızlı yanıtlayabilirsiniz:

• Prompt modele yeterli bağlam verdi mi?
• Aracı doğru aracı seçti mi?
• MCP aracı beklenen sonucu döndürdü mü?
• Hata model yapılandırmasından mı kaynaklandı?
• Araç parametreleri yanlış mıydı?
• İş mantığı beklenen çıktıyı üretmedi mi?

Aracı sistemleri büyüdükçe, yalnızca nihai cevabı kontrol etmek yetersiz kalır. Bu hata ayıklayıcı, çalışmanın tamamını adım adım görmenizi sağlar.

🤝 A2A Hata Ayıklayıcısı: Aracılar Arası İletişimi Test Edin

Çoklu aracı sistemleri giderek daha yaygın hale geliyor. Birden fazla aracı birlikte çalıştığında, yalnızca tek bir aracının doğru çalışması yeterli değildir. Aracıların birbirine doğru görevleri aktarıp aktarmadığını, mesajları beklenen formatta gönderip göndermediğini ve sonuçları doğru döndürüp döndürmediğini de test etmeniz gerekir.

Apidog artık Google’ın A2A, yani Agent-to-Agent protokolü için hata ayıklamayı destekliyor.

A2A Hata Ayıklayıcısı ile şunları yapabilirsiniz:

• A2A isteklerini doğrudan göndermek
• İstek parametrelerini incelemek
• Yanıtları kontrol etmek
• Aracılar arası etkileşimin sonucunu doğrulamak

Bu, özellikle ham protokol detaylarını elle okumak veya farklı araçlar arasında geçiş yapmak istemeyen ekipler için daha pratik bir test akışı sağlar.

İki hata ayıklayıcının rolü kısaca şöyle ayrılır:

Araç	Ne için kullanılır?
Yapay Zeka Aracısı Hata Ayıklayıcısı	Tek bir aracının görev yürütme sürecini incelemek
A2A Hata Ayıklayıcısı	Bir aracının başka bir aracıyla iletişimini test etmek

Aracı tabanlı sistemler geliştiren ekipler genellikle her iki seviyede de hata ayıklamaya ihtiyaç duyar: önce tek aracının iç akışı, sonra aracılar arası iletişim.

📦 Postman API Aracılığıyla Postman Verilerini İçe Aktarın

Postman’dan geçiş yapan ekipler için içe aktarma süreci artık daha büyük çalışma alanlarına daha uygun hale geliyor.

Apidog zaten yerel Postman dosyalarını içe aktarmayı destekliyordu. Bu sürümle birlikte artık Postman API üzerinden şu verileri de içe aktarabilirsiniz:

• Workspaces
• Collections
• Environments

Bu özellik özellikle yeni projeler oluştururken toplu geçiş yapmak için tasarlandı. Pratikte, tüm bir Postman Workspace’i Apidog’a taşımaya daha yakın bir deneyim sunar.

Postman hesabınızda birden fazla Workspace varsa, Apidog içe aktarımdan sonra bunlara karşılık gelen projeleri oluşturur.

Tipik kullanım akışı şöyle düşünülebilir:

Postman hesabı
  ↓
Postman API
  ↓
Workspace / Collection / Environment seçimi
  ↓
Apidog projeleri

Küçük geçişlerde yerel Postman dosyaları hâlâ kullanılabilir. Ancak daha büyük ekiplerde ve birden fazla Workspace içeren yapılarda API üzerinden içe aktarma daha az manuel işlem gerektirir.

📄 Yayınlanmış Belgelerdeki “Yapay Zekaya Sor” Artık Yan Panelde Açılıyor

Yayınlanmış belgelerdeki “Yapay Zekaya Sor” özelliği artık yan panelde çalışıyor.

Bu değişiklikle okuyucular mevcut belgeyi açık tutarken soru sorabilir. Belge sayfasından ayrılmadan:

• API dokümanını okuyabilir
• Belirli bir bölüm hakkında soru sorabilir
• Cevabı inceleyebilir
• Sayfadaki konumunu kaybetmeden okumaya devam edebilir

Bu özellikle uzun API belgelerinde kullanışlıdır. Cevap dokümanın içinde olabilir, ancak hızlıca bulmak zor olabilir. Yan panel, belge okuma ve soru sorma akışını aynı ekranda tutar.

🧠 Özel Yapay Zeka Model Sağlayıcıları

Ekipler artık özel bir Temel URL kullanarak özel yapay zeka model sağlayıcılarını bağlayabilir.

Bu, özellikle aşağıdaki yapılara sahip ekipler için faydalıdır:

• Kendi barındırılan model servisi
• Dahili model geçidi
• Şirket içinde yönetilen özel yapay zeka altyapısı

Böyle bir kurulum kullanıyorsanız, yapay zeka ile ilgili iş akışlarını hata ayıklarken her seferinde farklı araçlara geçmek yerine bu sağlayıcıyı Apidog içinde kullanabilirsiniz.

🐞 Hata Düzeltmeleri ve Küçük İyileştirmeler

Bu sürümde ayrıca aşağıdaki düzeltmeler ve küçük iyileştirmeler yayınlandı:

• 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 defined hatasından kaynaklanan Word dışa aktarım hatası düzeltildi.
• 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 oluşan uç nokta filtreleme hatası düzeltildi.
• apidog endpoint list --branch komutunun 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 typescriptThreePlus yapılandırma seçeneğini içermediği bir sorun düzeltildi.

🌟 Bunun Anlamı

Nisan sürümü, Yapay Zeka Aracısı ürünleri geliştiren ekipler için daha uygulama odaklı bir hata ayıklama ve geçiş akışı sunuyor.

Özetle:

• Yapay Zeka Aracısı Hata Ayıklayıcısı, tek bir aracının çalışmasını adım adım incelemenize yardımcı olur.
• A2A Hata Ayıklayıcısı, aracılar arasındaki iletişimi test etmeyi kolaylaştırır.
• Postman API içe aktarma, daha büyük geçişlerde manuel dosya işlemlerini azaltır.
• “Yapay Zekaya Sor” yan paneli, yayınlanmış belgelerde okuma ve soru sorma deneyimini iyileştirir.
• Özel model sağlayıcıları, ekiplerin mevcut yapay zeka altyapılarını Apidog içinde kullanmasına olanak tanır.

Bu özellikler, aracı geliştirme süreci demo aşamasından gerçek projelere geçtiğinde ihtiyaç duyulan pratik araçlara odaklanı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