Apidog'un Yapay Zeka Aracısı Hata Ayıklayıcı'sı (AI Agent Debugger), Ücretsiz dahil olmak üzere tüm planlarda, en son Apidog istemcisinde mevcuttur. Hata ayıklayıcı, yapay zeka aracılarını OpenAI ve Anthropic modellerine karşı çalıştırmanıza, MCP sunucularına bağlanmanıza, bir İzleme (Traces) panelinde her model çağrısını ve araç çağrısını incelemenize ve çalıştırma başına maliyeti izlemenize olanak tanır.
Bu makale, Yapay Zeka Aracısı Hata Ayıklayıcı'yı kimlerin kullanabileceğini, neyi desteklediğini, neyi desteklemediğini, nasıl etkinleştirileceğini ve mevcut Apidog projelerinizle ilgili nelerin aynı kaldığını açıklamaktadır.
Mevcut Özellikler
Yapay Zeka Aracısı Hata Ayıklayıcı, standart Apidog istemcisiyle birlikte gelir. Ayrı bir lisans, eklenti planı veya koltuk başına ücret yoktur.
- Ücretsiz, Temel, Profesyonel ve Kurumsal planların tümü Yapay Zeka Aracısı Hata Ayıklayıcı'yı içerir.
- Özellik varsayılan olarak etkindir; herhangi bir ayarı değiştirmeye gerek yoktur.
- En son Apidog istemci sürümünü kullanıyor olmanız gerekir. Eski istemcilerde Yapay Zeka Aracısı Hata Ayıklayıcı sekmesi bulunmaz.
Desteklenen Model Sağlayıcıları
| Sağlayıcı | Durum | Modeller |
|---|---|---|
| OpenAI | Destekleniyor | GPT-5.5, GPT-5.5 Instant, o-serisi ve OpenAI hesabındaki herhangi bir model |
| Anthropic | Destekleniyor | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Özel OpenAI uyumlu uç noktalar | Temel URL geçersiz kılma yoluyla destekleniyor | OpenAI uyumlu bir API sunan herhangi bir sağlayıcı |
| Diğer sağlayıcılar (Google, Mistral, xAI) | Yol haritasında | Şu anda birinci sınıf değil |
MCP Sunucusu Bağlantı Yöntemleri
Hata ayıklayıcı, Model Bağlam Protokolünü (Model Context Protocol) doğal olarak konuşur. Üç taşıma yöntemi desteklenir:
- STDIO. Yerel alt süreç. Aktif geliştirme altındaki MCP sunucuları için en iyisi.
- HTTP Akışlı (Streamable). HTTP üzerinden erişilebilir barındırılan MCP sunucuları.
- SSE. Eski Sunucu Tarafından Gönderilen Olaylar (Server-Sent Events). Hala yaygın; geriye dönük uyumluluk için destekleniyor.
MCP sunucuları için kimlik doğrulama iki deseni kapsar: standart başlıklar (API anahtarı) ve OAuth 2.0 (tam belirteç değişimi).
Hata Ayıklayıcının Kapsadığı Alanlar
Hata ayıklayıcı, bir aracı çalıştırmasının tüm yürütme zincirini yakalar:
- Tam istek ve yanıt yükleriyle model çağrıları.
- Model onları ifşa ettiğinde (OpenAI o-serisi, Anthropic genişletilmiş düşünce) model düşünme izleri.
- Parametre değerleri ve dönüş verileri ile araç çağrıları.
- Diğer araç çağrıları gibi İzleme (Traces) panelinde listelenen MCP sunucusu trafiği.
- Yerleşik araçlar:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Çalıştırma başına performans metrikleri: yanıt süresi, giriş belirteçleri, çıkış belirteçleri, tahmini maliyet.
- Beceriler: bir senaryoyu yeniden çalıştırmak için kaydedilmiş sistem istemi + araç listesi + parametre paketleri.
Hata Ayıklayıcının Kapsamadığı Alanlar
- Üretim gözlemlenebilirliği. Uzun vadeli trafik günlükleme için özel bir gözlemlenebilirlik aracı kullanın.
- Otomatik regresyon testi. Fikstürlere karşı istem ızgaraları için Promptfoo gibi bir test düzeneği kullanın.
- Aracıdan Aracıya (A2A) protokol trafiği. A2A için Apidog’un ayrı A2A Hata Ayıklayıcı'sını kullanın.
- Tek başına MCP sunucusu doğrulama. Bir aracı döngüsü olmadan tek bir MCP sunucusunun araçlarını ve kaynaklarını test etmek için Apidog'un MCP sunucusu test akışını kullanın.
Nasıl Etkinleştirilir
- Apidog'u en son sürüme güncelleyin.
- Apidog'u açın ve üst sekme çubuğunda Yapay Zeka Aracısı Hata Ayıklayıcı'ya tıklayın.
- Bir model sağlayıcı ve model seçin.
- Temel URL'yi (sağlayıcıdan otomatik doldurulur) onaylayın veya özel bir uç nokta için üzerine yazın.
- API anahtarınızı yapıştırın.
- Bağlantıyı onaylamak için boş bir iş parçacığında Çalıştır'a tıklayın.
Proje düzeyinde yapılandırma gerekmez. Hata ayıklayıcı kendi çalışma alanında çalışır.
Değişmeyenler
- Mevcut Apidog projeleri, API tanımları ve test paketleri etkilenmez.
- MCP sunucusu test akışı ve A2A Hata Ayıklayıcı paralel olarak çalışmaya devam eder.
- API uç nokta hata ayıklama, taklit sunucular ve OpenAPI düzenleme değişmeden kalır.
- Fatura ve plan kademeleri değişmeden kalır; Yapay Zeka Aracısı Hata Ayıklayıcı yeni bir kredi tüketmez.
Temel model API çağrıları için OpenAI veya Anthropic hesabınızın faturalandırıldığı şekilde ödeme yaparsınız. Apidog kullanım için ek ücret almaz.
Ekip ve Kurumsal Yöneticiler İçin
- Yapay Zeka Aracısı Hata Ayıklayıcı kullanıcı başına etkindir. Her üye kendi sağlayıcı API anahtarını kullanır.
- Hata ayıklayıcıya girilen API anahtarları her kullanıcının istemcisinde yerel olarak depolanır. Apidog sunucularına iletilmezler.
- Çalışma alanı sahipleri, standart Apidog ortam değişkenleri aracılığıyla paylaşılan MCP sunucusu uç noktalarını merkezi olarak yönetebilir.
- MCP sunucuları için denetim ve erişim kontrolleri, MCP sunucusunun kendi kimlik doğrulama modelini (başlıklar veya OAuth 2.0) takip eder.
Bilinen Sınırlamalar
- OpenAI ve Anthropic'in ötesinde sağlayıcı genişlemesi yol haritasında; bu arada OpenAI uyumlu sağlayıcılar için Temel URL geçersiz kılmayı kullanın.
- İzleme paylaşımı yalnızca yereldir. Bir izlemeyi paylaşmak için Ham görünüm JSON'ını kopyalayın veya paneli ekran görüntüsü alın.
- Maliyet tahmini, yayınlanmış model fiyatlandırmasına dayalı yerel bir yaklaşımdır; faturalandırma için sağlayıcınızın kullanım paneline başvurun.