Yapay zeka aracılarıyla WebMCP araçlarında hata ayıklama

WebMCP, web sitelerinin işlevlerini yapay zeka ajanları tarafından çağrılan yapılandırılmış araçlar olarak kullanıma sunması için önerilen bir web standardıdır. Ajanlar için Chrome Geliştirici Araçları, kodlama aracınızın bu araçlarla doğrudan etkileşim kurmasına olanak tanır. Böylece web sitenizi WebMCP'ye hazır hale getirme konusunda analiz yapmanıza ve önerilerde bulunmanıza yardımcı olur.

Ajanlar için Geliştirici Araçları'nı kullanarak uygulamanızın WebMCP araçlarını doğru şekilde kullanıma sunduğunu doğrulayabilir, bu araçların yürütülmesini test edebilir ve yapay zeka ajanlarının sitenizdeki ek işlevlerden yararlanabileceği alanları belirleyebilirsiniz. WebMCP, Modern Web Rehberi'nde yer alan ajan tabanlı beceriler yardımıyla web sitenizde uygulanabilir.

WebMCP ile çalışırken aşağıdakileri göz önünde bulundurun:

  • Deneysel işaret: WebMCP kategorisi varsayılan olarak etkin değildir. --categoryExperimentalWebmcp işaretini kullanın. Katılım hakkında daha fazla bilgi için WebMCP kaynak denemesine göz atın.
  • Tarayıcı gereksinimleri: Bu özellik için WebMCP özellikleri etkinleştirilmiş Chrome 149 veya sonraki bir sürüm gerekir. Bu, test ettiğiniz web sitesinin WebMCP kaynak denemesine kayıtlı olduğu veya yerel Chrome tarayıcınızda ilgili WebMCP işaretini manuel olarak etkinleştirdiğiniz anlamına gelir.
  • Hedef kitle ayrımı: Geliştirici Araçları MCP sunucusu, geliştiricilere yönelik bir hata ayıklama özelliği olsa da WebMCP araçları, web siteleriyle etkileşim kurmak için tarayıcı aracısı kullanan herkes tarafından çağrılabilir. Temsilciler için DevTools, kullanıcıya yönelik WebMCP araçlarını oluşturup test etmenize yardımcı olur.

WebMCP araçlarını test etme ve hatalarını ayıklama kullanım alanları

WebMCP'yi kullanmanın çeşitli yolları vardır. Her web sitesi farklıdır ve WebMCP araçlarının her seti de farklıdır. Web siteniz veya web uygulamanız için faydalı araçları tanımlama ve oluşturma ile ilgili çerçevemizi inceleyin.

Örneğin, bir kullanıcının acentesinin ilgili işlemleri tamamlamasına yardımcı olacak araçların bulunduğu bir seyahat acentesi web siteniz varsa araçlarınızın amaçlandığı şekilde çalıştığını test etmek için acentelerin DevTools ile kullanabileceği örnek istemleri aşağıda bulabilirsiniz.

Temsilcinize, test ve geliştirme sürecini kolaylaştırmak için WebMCP araçlarını listelemesini ve çalıştırmasını söyleyin.

Not: Aracı yürütme adımları, olası davranış örnekleridir. Birçok farklı türde aracı olduğu ve aracılar deterministik olmadığı için farklı sonuçlar görebilirsiniz.

WebMCP aracının görünürlüğünü doğrulama

Sitenize WebMCP desteği eklediğinizde kodlama aracınızdan, araçlarınızın tarayıcıya doğru şekilde sunulduğunu ve giriş şemalarının iyi tanımlandığını doğrulamasını isteyebilirsiniz.

Örnek istem:

Implement a 'book_flight' WebMCP tool to this page to help agents book flights. Verify that it's correctly registered and ready for AI agents to use.

Örnek ajan yürütme: Ajanınız, kullanıma sunulan araçların incelenmesi gerektiğini algılıyor ve list_webmcp_tools aracını bağımsız olarak çağırıyor. Çıkışı ayrıştırır, aracınızın başarıyla kaydedilip kaydedilmediğini onaylar ve şemanın iyi biçimlendirilmiş olduğunu doğrular.

WebMCP aracı yürütmesinde hata ayıklama

WebMCP aracınızın dahili mantığının, belirli girişlerle bir yapay zeka tarafından çağrıldığında beklendiği gibi çalıştığını onaylayın. Ajanınıza aracı çalıştırması ve uygulamanın yanıtını izlemesi talimatını verebilirsiniz.

Örnek istem:

Try using the 'add_to_cart' tool on this page to add product 12345. Let me know if it succeeds or if the application throws any errors.

Örnek temsilci yürütme: Temsilciniz, belirli bir işlemi test etme amacını tanıyor. Doğru giriş şemasını bağımsız olarak belirler, çalıştırmak için execute_webmcp_tool kullanır ve başarı durumunu bildirmek veya hataları ayıklamak için uygulamanın yanıtını (konsol günlüklerini kontrol etme dahil) izler.

Şema netliğiyle ilgili sorunları giderme

Bir yapay zeka aracısı, WebMCP aracını tekrar tekrar doğru şekilde çağıramadığında bunun nedeni genellikle belirsiz bir JSON şemasıdır. Aracınızdan, şemayı büyük dil modeli (LLM) açısından incelemesini ve iyileştirmeler önermesini isteyebilirsiniz.

Örnek istem:

My 'schedule_meeting' tool is failing to parse the various date formats sent by different AI agents. Can you review the tool's schema and suggest how I can improve the descriptions or constraints so agents know exactly which format is required?

Aracı yürütme örneği: Aracınız, kullanıma sunulan WebMCP araçlarını getirir ve inputSchema için schedule_meeting analizini yapar. Tarih parametresinde net bir açıklama veya biçim kısıtlaması olmadığını belirler ve kodunuzda uygulamanız için düzeltilmiş bir JSON şeması (örneğin, "Date in YYYY-MM-DD format" gibi bir açıklama ekleme) önerir.