ทรัพยากรแบบรายการกับแบบแม่แบบ
เสนอทั้งรายการตายตัวและรูปแบบที่สร้างขึ้นทันที
ทรัพยากรแบบรายการกับแบบแม่แบบ เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
สองวิธีในการนำเสนอข้อมูล
MCP เปิดเผยข้อมูลได้สองวิธี ได้แก่ ทรัพยากรแบบแสดงรายการที่มี URI ตายตัว หรือทรัพยากรแบบใช้แม่แบบที่มีตัวแทน การรู้ว่าควรเลือกแบบใดช่วยให้เซิร์ฟเวอร์ของคุณชัดเจน
แบบแสดงรายการ: ระบุได้และมีจำนวนน้อย
ทรัพยากรแบบแสดงรายการมี URI ที่ระบุแน่นอนและปรากฏใน resources/list ให้ใช้เมื่อมีรายการที่รู้จักและมีจำนวนไม่มาก ซึ่งไคลเอนต์สามารถเรียกดูได้
@mcp.resource("config://app")
def app_config() -> str:
return read_config()แบบใช้แม่แบบ: ไม่จำกัดตามรูปแบบ
ทรัพยากรแบบใช้แม่แบบใช้ตัวแทนในวงเล็บปีกกา จึงครอบคลุม URI ได้ไม่จำกัด ไม่สามารถแสดงรายการทั้งหมดได้ เพราะชุดข้อมูลไม่มีขอบเขตแน่นอน
@mcp.resource("file://{path}")
def read_file(path: str) -> str:
return open(path).read()ความแตกต่างของการแสดงรายการ
ไคลเอ็นต์เรียก รายการทรัพยากร เพื่อค้นหาทรัพยากรแบบตายตัว ส่วนแม่แบบจะแสดงอยู่ในรายการแม่แบบแยกต่างหาก โดยประกาศโครงสร้างแทนที่จะระบุรายการจริง
เรียกดูเทียบกับระบุที่อยู่
ลองนึกถึงความแตกต่างระหว่าง การเรียกดูเทียบกับการระบุที่อยู่ ทรัพยากรที่แสดงรายการไว้ก็เหมือนรายการอาหารที่คุณกวาดตาดู ส่วนแม่แบบก็เหมือนการพิมพ์ที่อยู่ที่คุณทราบอยู่แล้ว
เมื่อชุดข้อมูลมีขนาดเล็ก
หากข้อมูลของคุณเป็นชุดข้อมูลขนาดเล็กและไม่ค่อยเปลี่ยนแปลง ให้เลือกใช้ ทรัพยากรที่แสดงรายการ โมเดลจะเห็นตัวเลือกทั้งหมด จึงเลือกสิ่งที่ถูกต้องได้ง่าย
เมื่อชุดข้อมูลมีขนาดใหญ่มาก
หากมีรายการนับพันรายการ ให้ใช้แม่แบบแทน การแสดงรายการทั้งหมดจะ ท่วมไคลเอ็นต์ ดังนั้นให้ประกาศรูปแบบ แล้วปล่อยให้โมเดลเติมค่าเอง
weather://{city}/todayใช้ทั้งสองแบบร่วมกันได้อย่างอิสระ
เซิร์ฟเวอร์จริงมักใช้ทั้งสองแบบ ได้แก่ รายการที่แสดงไว้จำนวนหนึ่งสำหรับข้อมูลที่ใช้บ่อย และแม่แบบสำหรับรายการจำนวนมากที่เหลือ ทั้งสองแบบอยู่ร่วมกันได้อย่างลงตัว
ช่วยให้ค้นพบได้ง่ายขึ้น
แม่แบบไม่สามารถแจกแจงรายการทั้งหมดได้ แต่คุณเพิ่มทรัพยากร ดัชนีที่แสดงรายการ ขนาดเล็ก ซึ่งชี้ไปยัง URI ยอดนิยมได้ เพื่อมอบจุดเริ่มต้นที่มีประโยชน์ให้โมเดล
@mcp.resource("cities://index")
def cities() -> str:
return "london, paris, tokyo"อ่านเหมือนกันไม่ว่าจะพบด้วยวิธีใด
ไม่ว่าจะพบ URI ด้วยวิธีใด ไคลเอ็นต์ก็อ่านในลักษณะเดียวกัน คือเรียก การอ่านทรัพยากร เพียงครั้งเดียว การแสดงรายการหรือการใช้แม่แบบมีผลต่อการค้นพบเท่านั้น ไม่ได้เปลี่ยนวิธีดึงเนื้อหา
เหตุใดเรื่องนี้จึงสำคัญ
การเลือกระหว่างแบบแสดงรายการกับแบบแม่แบบกำหนดว่าโมเดลจะค้นหาข้อมูลของคุณได้ง่ายเพียงใด เลือก แบบแสดงรายการสำหรับการเรียกดู และใช้แม่แบบเมื่อจำเป็นต้องรองรับขนาดใหญ่ แล้วเซิร์ฟเวอร์ของคุณก็จะยังใช้งานได้ดี 🎯
ตรวจสอบอย่างรวดเร็ว
คุณควรใช้ทรัพยากรประเภทใดสำหรับรายการจำนวนหลายพันรายการ
สรุปทบทวน
คุณได้เรียนรู้ว่า ทรัพยากรที่แสดงรายการ เหมาะกับชุดข้อมูลขนาดเล็กที่เรียกดูได้ ส่วนทรัพยากรแบบแม่แบบรองรับคอลเลกชันขนาดใหญ่ และทั้งสองแบบก็ใช้ร่วมกันได้ดี ต่อไป: การแจ้งไคลเอ็นต์เมื่อมีการอัปเดต 🚀
เรียนรู้ Python ด้วย AI tutor — ฟรี
เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป
- คอร์ส
- 30
- บทเรียน
- 120
คำถามที่พบบ่อย
บทเรียน “ทรัพยากรแบบรายการกับแบบแม่แบบ” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “ทรัพยากรแบบรายการกับแบบแม่แบบ” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “ทรัพยากรแบบรายการกับแบบแม่แบบ”
เสนอทั้งรายการตายตัวและรูปแบบที่สร้างขึ้นทันที คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน MCP Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน
บทเรียน “ทรัพยากรแบบรายการกับแบบแม่แบบ” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม
ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- URI ทรัพยากรที่กำหนดพารามิเตอร์
- สร้างเนื้อหาเมื่อมีการอ่าน
- ทรัพยากรแบบรายการกับแบบแม่แบบ
- แจ้งไคลเอ็นต์เมื่อมีการอัปเดต