WebMCP araçlarında hata ayıklama

Web sitenizin yapay zeka ajanlarına sunduğu istemci tarafı yapay zeka araçlarını incelemek, hata ayıklamak ve test etmek için Chrome Geliştirici Araçları'ndaki WebMCP panelini kullanın. Panel, kayıt, şema doğrulama ve çağrı geçmişi dahil olmak üzere araç yaşam döngüsünün tamamını uçtan uca görmenizi sağlar.

WebMCP bölmesini açma

WebMCP bölmesi, Uygulama panelinde bulunur. Bu ayarı açmak için aşağıdaki adımları uygulayın:

  1. WebMCP araçlarını kullanan bir sayfada Chrome Geliştirici Araçları'nı açın.
  2. Application (Uygulama) sekmesini tıklayın.
  3. Kenar çubuğunun üst düzeyinde WebMCP bölmesini seçin.
Uygulama kenar çubuğunda WebMCP bölmesi seçili olan Geliştirici Araçları Uygulama paneli.

Arayüze genel bakış

WebMCP paneli, araçlarınızı yönetip izlemenize yardımcı olmak için iki bölmeli bir düzen kullanır:

  • Çağrılan Araçlar: Yapay zeka ajanı ile sayfa arasındaki etkileşimlerin kronolojik günlüğü.
  • Kullanılabilir Araçlar: Etkin sekmede algılanan tüm WebMCP araçlarının canlı listesi.

Mevcut araçlar

Kullanılabilir araçlar bölümünde, araç adları ve açıklamaları yapay zeka ajanı'na göründüğü şekilde gösterilir. Ayrıca, her araç için çağrı sayacı da içerir. Bu sayaç, geçerli oturum sırasında bir aracın kaç kez çağrıldığını gösterir.

Filtreleme için tıklanabilir durum simgeleriyle birlikte çağırma sayacını gösteren Kullanılabilir Araçlar listesi.

Çağrılan araçlar

Çağrılan araçlar günlüğü, araç etkileşimlerinin kalıcı bir kaydını sağlar. Günlükte bir giriş seçtiğinizde aşağıdaki ayrıntıları inceleyebilirsiniz:

  • Durum: Çağrının sonucu (Tamamlandı, İptal Edildi, Devam Ediyor veya Hata).
  • Giriş: Temsilcinin tahmin ettiği ve araca gönderdiği parametreler.
  • Çıkış: Araç tarafından sağlanan dönüş değeri veya hata mesajı.

Günlüğü filtreleme

Çağrılan araçların listesini aşağıdaki ölçütlere göre daraltmak için Filtre çubuğunu kullanın:

  • Ad veya açıklama: Belirli bir ada veya amaca uygun araçları bulmak için metin girin.
  • Durum türü: Aramaları mevcut durumlarına göre filtreleyin (ör. Tamamlandı, Hata, İptal Edildi veya Devam Ediyor).
  • Araç türü: HTML'de tanımlanan bildirim temelli araçları ve JavaScript'te tanımlanan emir temelli araçları filtrelemek için seçin. Tüm araç türlerini görmek için hiçbir filtrenin etkin olmadığından emin olun.

Test araçlarını manuel olarak test etme

Aracınızın güvenilirliğini bağımsız olarak test etmek için yapay zeka aracısının karar mantığını atlayabilirsiniz. Bu, belirli bir temsilci istemini beklemeden işlev mantığını doğrulamak için kullanışlıdır.

  1. Kullanılabilir Araçlar listesinde, test etmek istediğiniz aracı tıklayın. Alternatif olarak, Çağrılan Araçlar günlüğünde bir aracın üzerine gelerek Oynat (➜) simgesini gösterin ve tıklayın. Manuel test alanı açılır.

  2. Manuel test alanında, giriş alanlarına parametreleri girin veya mevcut parametreleri düzenleyin.

  3. Aracı çalıştır'ı tıklayın.

Çağrılan Araçlar listesindeki bir öğenin üzerine gelerek Oynat simgesini gösterme ve önceden doldurulmuş manuel test alanını açma.

Entegrasyon sorunlarını giderme

WebMCP paneli, yaygın entegrasyon hatalarını teşhis etmenize yardımcı olur:

  • Şema ihlalleri: Araç parametreleri veya döndürülen değerler tanımlanan şemayla eşleşmiyorsa çıkış bölmesinde hata mesajları gösterilir.
  • Ajan reddi: Ajanın, aracınızı belirli bir istem için hiç değerlendirip değerlendirmediğini görmek üzere Kullanılabilir Araçlar listesindeki çağırma sayacını kontrol edin.

Otomasyon ve temsilciler

WebMCP, yapay zeka ajanlarının sitenizin araçlarını keşfedip bunlarla etkileşim kurabileceği ajan tabanlı web için tasarlanmıştır. Aracı destekli geliştirme için Chrome DevTools for agents projesi, yapay zeka aracılarının WebMCP araçlarınızı test etmesine ve kullanmasına yardımcı olmak için bu protokolü kullanan özel bir arayüz sağlar.

Komut satırı işaretleri

Ajanlar için Chrome Geliştirici Araçları'ndaki WebMCP araçları (list_webmcp_tools ve execute_webmcp_tool) varsayılan olarak devre dışıdır. Etkinleştirmek için sunucu bağımsız değişkenlerinize --categoryExperimentalWebmcp işaretini ekleyin:

"args": ["chrome-devtools-mcp@latest", "--categoryExperimentalWebmcp"]

Daha fazla seçenek için Yapılandırma başlıklı makaleyi inceleyin.

İlgili kaynaklar

WebMCP ve temsilci tabanlı web hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara göz atın: