Apidog'un Yapay Zeka Aracısı Hata Ayıklayıcı'sı (AI Agent Debugger), Ücretsiz plan dahil tüm Apidog planlarında en son istemciyle birlikte kullanılabilir. Bu araçla yapay zeka aracılarını OpenAI ve Anthropic modellerine karşı çalıştırabilir, MCP sunucularına bağlanabilir, İzleme (Traces) panelinde model ve araç çağrılarını inceleyebilir ve çalıştırma başına tahmini maliyeti takip edebilirsiniz.
Bu rehberde Yapay Zeka Aracısı Hata Ayıklayıcı'yı kimlerin kullanabileceğini, hangi model ve MCP bağlantı yöntemlerinin desteklendiğini, nasıl etkinleştirileceğini ve mevcut Apidog projelerinizde nelerin değişmediğini adım adım ele alacağız.
Mevcut Özellikler
Yapay Zeka Aracısı Hata Ayıklayıcı, standart Apidog istemcisinin parçasıdır. Ayrı lisans, eklenti planı veya kullanıcı başına ek ücret gerektirmez.
Kullanım koşulları:
- Ücretsiz, Temel, Profesyonel ve Kurumsal planlarda kullanılabilir.
- Varsayılan olarak etkindir; ayrıca bir ayar açmanız gerekmez.
- En son Apidog istemci sürümünü kullanmanız gerekir.
- Eski istemci sürümlerinde Yapay Zeka Aracısı Hata Ayıklayıcı sekmesi görünmez.
Pratik kontrol listesi:
1. Apidog istemcisini güncelleyin.
2. Uygulamayı yeniden başlatın.
3. Üst sekme çubuğunda "Yapay Zeka Aracısı Hata Ayıklayıcı" sekmesini kontrol edin.
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 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 destek kapsamında değil |
Özel OpenAI uyumlu bir sağlayıcı kullanıyorsanız yapılandırma mantığı şu şekildedir:
Provider: OpenAI uyumlu
Base URL: Sağlayıcınızın OpenAI uyumlu API uç noktası
API Key: Sağlayıcı hesabınızdaki API anahtarı
Model: Sağlayıcının desteklediği model adı
MCP Sunucusu Bağlantı Yöntemleri
Hata ayıklayıcı, Model Bağlam Protokolünü (Model Context Protocol, MCP) doğal olarak destekler. Üç taşıma yöntemiyle MCP sunucularına bağlanabilirsiniz.
1. STDIO
Yerel alt süreç olarak çalışan MCP sunucuları için uygundur. Aktif geliştirme sırasında en pratik seçenektir.
Kullanım senaryosu:
Yerel MCP sunucusu geliştiriyorsunuz.
Sunucuyu terminalden çalıştırmak yerine Apidog üzerinden aracı döngüsüne bağlıyorsunuz.
Araç çağrılarını ve dönüş verilerini Traces panelinden inceliyorsunuz.
2. HTTP Akışlı (Streamable)
HTTP üzerinden erişilebilen barındırılmış MCP sunucuları için kullanılır.
Kullanım senaryosu:
MCP sunucunuz uzak bir ortamda çalışıyor.
Apidog üzerinden HTTP uç noktasına bağlanıyorsunuz.
Aracının bu sunucudaki araçları nasıl çağırdığını izliyorsunuz.
3. SSE
Server-Sent Events tabanlı eski bağlantı yöntemidir. Hâlâ yaygın kullanıldığı için geriye dönük uyumluluk amacıyla desteklenir.
MCP kimlik doğrulama seçenekleri
MCP sunucuları için iki kimlik doğrulama deseni desteklenir:
- Standart başlıklar ile API anahtarı
- OAuth 2.0 tam belirteç değişimi
Örnek başlık yapısı:
Authorization: Bearer <API_KEY>
Hata Ayıklayıcının Kapsadığı Alanlar
Yapay Zeka Aracısı Hata Ayıklayıcı, bir aracı çalıştırmasının yürütme zincirini incelemenizi sağlar.
İzleyebileceğiniz başlıca veriler:
- Tam istek ve yanıt yükleriyle model çağrıları
- Model tarafından ifşa edildiğinde model düşünme izleri
- OpenAI o-serisi
- Anthropic genişletilmiş düşünce
- Parametre değerleri ve dönüş verileriyle araç çağrıları
- MCP sunucusu trafiği
- İzleme (Traces) panelinde listelenen araç ve model adımları
- Çalıştırma başına performans metrikleri:
- Yanıt süresi
- Giriş belirteçleri
- Çıkış belirteçleri
- Tahmini maliyet
- Beceriler:
- Kaydedilmiş sistem istemi
- Araç listesi
- Parametre paketleri
Yerleşik araçlar:
bash
web_fetch
read
edit
write
grep
glob
kill_shell
Tipik hata ayıklama akışı:
1. Aracıya bir görev verin.
2. Model çağrısını Traces panelinde açın.
3. Modelin hangi aracı çağırdığını kontrol edin.
4. Araç parametrelerini inceleyin.
5. Araç dönüş verisini kontrol edin.
6. Son yanıtın bu verilere göre oluşup oluşmadığını doğrulayın.
7. Gerekirse istemi, araç listesini veya parametreleri değiştirip yeniden çalıştırın.
Hata Ayıklayıcının Kapsamadığı Alanlar
Bu araç geliştirme ve hata ayıklama odaklıdır. Aşağıdaki kullanım alanları için ayrı araç veya akış kullanmanız gerekir.
- Ü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ı çalıştırmak 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 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?
Ek kurulum gerekmez. En son istemciyi kullanıyorsanız özellik varsayılan olarak açıktır.
Adımlar:
- Apidog'u en son sürüme güncelleyin.
- Apidog'u açın.
- Üst sekme çubuğundan Yapay Zeka Aracısı Hata Ayıklayıcı sekmesine tıklayın.
- Bir model sağlayıcı seçin.
- Kullanmak istediğiniz modeli seçin.
- Temel URL'yi kontrol edin.
- Sağlayıcıdan otomatik doldurulabilir.
- Özel OpenAI uyumlu uç nokta kullanıyorsanız üzerine yazabilirsiniz.
- API anahtarınızı girin.
- Boş bir iş parçacığında Çalıştır seçeneğine tıklayarak bağlantıyı doğrulayın.
Örnek yapılandırma:
Provider: OpenAI
Model: Hesabınızda kullanılabilir bir model
Base URL: Sağlayıcı tarafından doldurulan varsayılan URL
API Key: OpenAI API anahtarınız
Anthropic için örnek yapılandırma:
Provider: Anthropic
Model: Claude 4.7 Sonnet / Opus / Haiku
API Key: Anthropic API anahtarınız
Özel OpenAI uyumlu uç nokta için:
Provider: OpenAI
Base URL: https://your-provider.example.com/v1
API Key: Sağlayıcınızdan aldığınız anahtar
Model: Sağlayıcının model adı
Proje düzeyinde yapılandırma gerekmez. Hata ayıklayıcı kendi çalışma alanında çalışır.
Değişmeyenler
Yapay Zeka Aracısı Hata Ayıklayıcı mevcut Apidog projelerinizi değiştirmez.
Aynı kalanlar:
- Mevcut Apidog projeleri
- API tanımları
- Test paketleri
- MCP sunucusu test akışı
- A2A Hata Ayıklayıcı
- API uç nokta hata ayıklama
- Taklit sunucular
- OpenAPI düzenleme
- Fatura ve plan kademeleri
Yapay Zeka Aracısı Hata Ayıklayıcı yeni bir Apidog kredisi tüketmez.
Temel model API çağrıları için ödeme, OpenAI veya Anthropic hesabınızın faturalandırma modeline göre yapılır. Apidog bu kullanım için ek ücret almaz.
Ekip ve Kurumsal Yöneticiler İçin
Ekip ortamında kullanım için dikkat edilmesi gereken noktalar:
- 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ı kullanıcının istemcisinde yerel olarak depolanır.
- API anahtarları Apidog sunucularına iletilmez.
- Çalışma alanı sahipleri, standart Apidog ortam değişkenleriyle 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 takip eder:
- Başlıklar
- OAuth 2.0
Ekipler için önerilen yapı:
1. Her geliştirici kendi model sağlayıcı API anahtarını kullanır.
2. Paylaşılan MCP sunucusu uç noktaları ortam değişkenleriyle yönetilir.
3. MCP erişim kontrolü MCP sunucusu tarafında uygulanır.
4. Hata ayıklama sırasında Traces paneliyle model ve araç çağrıları doğrulanır.
Bilinen Sınırlamalar
Kullanırken aşağıdaki sınırlamaları dikkate alın:
- OpenAI ve Anthropic dışındaki sağlayıcı genişlemesi yol haritasındadır.
- Bu arada OpenAI uyumlu sağlayıcılar için Temel URL geçersiz kılmayı kullanabilirsiniz.
- İzleme paylaşımı yalnızca yereldir.
- Bir izlemeyi paylaşmak için Ham görünüm JSON'ını kopyalayabilir veya panelin ekran görüntüsünü alabilirsiniz.
- Maliyet tahmini, yayınlanmış model fiyatlandırmasına dayalı yerel bir yaklaşımdır.
- Faturalandırma doğrulaması için sağlayıcınızın kullanım panelini esas alın.
Özet Akış
Yapay Zeka Aracısı Hata Ayıklayıcı'yı kullanmaya başlamak için en kısa yol:
1. Apidog'u güncelleyin.
2. Yapay Zeka Aracısı Hata Ayıklayıcı sekmesini açın.
3. OpenAI veya Anthropic sağlayıcısını seçin.
4. API anahtarınızı girin.
5. Gerekirse MCP sunucunuzu bağlayın.
6. Aracıyı çalıştırın.
7. Traces panelinden model çağrılarını, araç çağrılarını, parametreleri ve maliyeti inceleyin.
Bu akış, yapay zeka aracılarınızı geliştirirken model davranışını, araç kullanımını ve MCP entegrasyonlarını tek bir hata ayıklama alanında takip etmenizi sağlar.
Top comments (0)