İstemciye Yapılandırılmış Günlükleme

Terminalinize yazdırmak yalnızca size yardımcı olur. MCP, sunucunun protokol üzerinden günlük iletileri göndermesini sağlar; böylece ana uygulama da bunları gösterebilir.

Günlükler notifications/message bildirimi olarak iletilir. Bu bildirim bir düzey, isteğe bağlı bir günlükçü adı ve kaydetmek istediğiniz verileri taşır.

Bir aracın içinden günlük kaydına, ilerleme için kullandığınız tutamacın aynısı olan Context nesnesi üzerinden erişirsiniz. Ek bir kurulum gerekmez.

En sık kullanılan yardımcı ctx.info işlevdir. Bunu, kullanıcının aracın ne yaptığını takip etmesine yardımcı olan normal ve beklenen durum notları için kullanın.

Günlük kullanımda gürültü oluşturabilecek ayrıntılı izleri, örneğin ayrıştırılmış bir değeri veya seçilen bir dalı görmek istediğinizde ctx.debug kullanın.

Bir şeyler ters gittiğinde ancak durum düzeltilebilir olduğunda ctx.warning kullanın; örneğin eksik bir isteğe bağlı alanı varsayılan bir değerle doldurduğunuzda.

Gerçek sorunlar için ctx.error çağrısını yapın. Bu, istemciye bir adımın başarısız olduğunu bildirir; çağrıyı sonlandıran bir istisna oluşturmaktan farklıdır.

MCP, tanıdık syslog ölçeğini izler: debug, info, notice, warning, error, critical ve daha yüksek düzeyler. İstemciler düzeye göre sıralama ve renklendirme yapabilir.

Birçok yardımcı, iletilerin bileşene göre gruplanabilmesi için bir logger adı kabul eder; Python'ın standart günlük kaydı modülü de benzer şekilde çalışır.

Günlük iletileri işleminizden çıkarak istemciye ulaştığından, onları görünür kabul edin. Belirteç veya parola gibi gizli bilgileri asla günlüğe yazmayın.

İlerleme bildiriminde olduğu gibi her günlük kaydı da bir bildirimdir; bu nedenle aracınızı engellemez ve yanıt beklemez. Çalışma sürdükçe özgürce günlük kaydı oluşturabilirsiniz.

Rutin durum güncellemeleri için doğru yardımcıyı seçin.

Artık ctx.info, debug, warning ve error ile düzeyli günlükler oluşturabilir, günlükçülerinize ad verebilir ve gizli bilgileri dışarıda tutabilirsiniz. Harika ilerleme!