การบันทึกแบบมีโครงสร้างไปยังไคลเอ็นต์

การพิมพ์ข้อความไปยังเทอร์มินัลช่วยได้เฉพาะคุณเท่านั้น MCP ช่วยให้เซิร์ฟเวอร์ส่งข้อความ บันทึก ผ่านโพรโทคอล เพื่อให้แอปโฮสต์แสดงข้อความเหล่านั้นได้เช่นกัน

บันทึกจะเดินทางมาในรูปการแจ้งเตือน การแจ้งเตือน/ข้อความ ซึ่งมีระดับ ชื่อตัวบันทึกที่ใส่หรือไม่ใส่ก็ได้ และข้อมูลที่คุณต้องการบันทึก

ภายในเครื่องมือ คุณเข้าถึงการบันทึกผ่านออบเจ็กต์ บริบท ซึ่งเป็นตัวอ้างอิงเดียวกับที่ใช้รายงานความคืบหน้า ไม่จำเป็นต้องตั้งค่าเพิ่มเติม

ตัวช่วยที่ใช้บ่อยที่สุดคือ ctx.info ใช้สำหรับข้อความสถานะปกติที่คาดหมายได้ เพื่อช่วยให้ผู้ใช้ติดตามว่าเครื่องมือกำลังทำอะไรอยู่

ใช้ ctx.debug เมื่อคุณต้องการร่องรอยแบบละเอียด เช่น ค่าที่แยกวิเคราะห์แล้วหรือแขนงที่เลือก ซึ่งอาจมีมากเกินไปสำหรับการใช้งานทั่วไป

ใช้ ctx.warning เมื่อมีบางอย่างไม่เป็นไปตามปกติแต่ยังแก้ไขต่อได้ เช่น ฟิลด์เสริมที่หายไปและคุณเติมค่าปริยายให้

เรียกใช้ ctx.error สำหรับปัญหาที่เกิดขึ้นจริง วิธีนี้จะแจ้งไคลเอ็นต์ว่าขั้นตอนหนึ่งล้มเหลว โดยแยกจากการโยนข้อยกเว้นที่ทำให้การเรียกสิ้นสุดลง

MCP ใช้มาตราส่วน ระบบบันทึก ที่คุ้นเคย ได้แก่ debug, info, notice, warning, error, critical และระดับที่สูงกว่า ไคลเอ็นต์สามารถจัดเรียงและกำหนดสีตามระดับได้

ตัวช่วยจำนวนมากรับชื่อ ตัวบันทึก เพื่อจัดกลุ่มข้อความตามองค์ประกอบ คล้ายกับที่โมดูลการบันทึกมาตรฐานของ Python ทำ

ข้อความบันทึกออกจากโพรเซสของคุณและไปถึงไคลเอ็นต์ ดังนั้นให้ถือว่าข้อความเหล่านั้นมองเห็นได้ อย่าเขียน ข้อมูลลับ เช่น โทเค็นหรือรหัสผ่านลงในบันทึก

เช่นเดียวกับความคืบหน้า บันทึกแต่ละรายการคือ การแจ้งเตือน จึงไม่บล็อกเครื่องมือและไม่รอคำตอบ คุณสามารถบันทึกได้อย่างอิสระขณะที่งานดำเนินไป

ตอนนี้คุณสามารถส่งบันทึกตามระดับด้วย ctx.info, debug, warning และ error ตั้งชื่อตัวบันทึก และเก็บข้อมูลลับไม่ให้รั่วไหลได้แล้ว พัฒนาไปได้ดีมากครับ/ค่ะ!