URI ทรัพยากรที่กำหนดพารามิเตอร์
ดึงค่าตัวแปรโดยตรงจากเส้นทาง URI
URI ทรัพยากรที่กำหนดพารามิเตอร์ เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 1 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
รูปแบบเดียว ทรัพยากรมากมาย
ทรัพยากรแบบคงที่มีที่อยู่ตายตัวหนึ่งรายการ ส่วน URI ที่มีพารามิเตอร์ คือรูปแบบที่ใช้แทนทรัพยากรทั้งกลุ่มได้พร้อมกัน ✨
ตัวแทนที่อยู่ในวงเล็บปีกกา
คุณระบุส่วนที่เปลี่ยนแปลงได้ของ URI ด้วย ตัวแทน ในวงเล็บปีกกา เช่น users://{user_id}/profile วงเล็บปีกกานั้นคือช่องสำหรับใส่ค่า
users://{user_id}/profileแม่แบบคือคำสัญญา
แม่แบบทรัพยากรบอกไคลเอนต์ว่า URI ใดก็ตามที่ตรงกับรูปแบบนี้ถือว่าใช้ได้ โมเดลสามารถใส่ค่าจริงเพื่อขอข้อมูลที่ต้องการได้โดยเฉพาะ
ใช้ตัวตกแต่งเพื่อลงทะเบียน
ใน Python SDK คุณลงทะเบียนแม่แบบได้เช่นเดียวกับเครื่องมือ โดยใช้ตัวตกแต่ง @mcp.resource และส่งรูปแบบ URI เป็นอาร์กิวเมนต์
@mcp.resource("users://{user_id}/profile")
def get_profile(user_id: str) -> str:
return f"Profile for {user_id}"ชื่อต้องตรงกัน
ตัวแทนทุกตัวใน URI ต้องปรากฏเป็น พารามิเตอร์ของฟังก์ชัน ที่มีชื่อเดียวกัน SDK จะส่งค่า {user_id} ตรงไปยังอาร์กิวเมนต์ user_id ของคุณ
รองรับมากกว่าหนึ่งตัวแปร
คุณสามารถเก็บค่าตัวแปรหลายรายการใน URI เดียวได้ ตัวแทน หลายรายการ แต่ละตัวจะจับคู่กับพารามิเตอร์ของตนเอง ทำให้รูปแบบเดียวระบุข้อมูลที่เฉพาะเจาะจงมากได้
@mcp.resource("repos://{owner}/{name}/readme")
def readme(owner: str, name: str) -> str:
return load_readme(owner, name)ค่าเข้ามาเป็นสตริง
ส่วนที่จับได้จะเข้ามาจาก URI ในรูปแบบ ข้อความ หากต้องการตัวเลข คุณต้องแปลงค่าเองภายในฟังก์ชันก่อนนำไปใช้
def get_page(page: str) -> str:
n = int(page)
return render_page(n)ตัวแทนหนึ่งตัวต่อหนึ่งส่วน
โดยค่าเริ่มต้น ตัวแทนจะจับ ส่วนเส้นทางเดียว ซึ่งเป็นข้อความระหว่างเครื่องหมายทับสองตัว ตัวแทนจะหยุดที่เครื่องหมายทับถัดไป จึงไม่กลืนส่วนที่เหลือของเส้นทาง
แม่แบบจะไม่แสดงรายการด้วยตัวเอง
ทรัพยากรธรรมดาจะปรากฏในรายการทรัพยากร ส่วน ทรัพยากรแบบใช้แม่แบบมักไม่ปรากฏ เพราะมี URI ที่เป็นไปได้ไม่สิ้นสุด ไคลเอนต์จะอ่านทรัพยากรโดยเติมค่าลงในรูปแบบ
ทำให้ URI มีความหมาย
ออกแบบ URI ให้ดูเหมือนที่อยู่ที่เข้าใจง่าย เช่น weather://{city}/today โมเดลจะเลือกทรัพยากรที่ถูกต้องได้แม่นยำกว่ามากเมื่อเส้นทางอธิบายตัวเอง
weather://{city}/todayเหตุผลที่เรื่องนี้สำคัญ
URI ที่มีพารามิเตอร์ทำให้ฟังก์ชันที่เป็นระเบียบเพียงหนึ่งฟังก์ชันให้บริการทรัพยากรนับพันรายการได้ คุณเขียน รูปแบบเพียงครั้งเดียว แล้วให้ส่วนที่เปลี่ยนแปลงทำงานที่เหลือ 🎯
ตรวจสอบความเข้าใจอย่างรวดเร็ว
ตัวแทน URI ที่จับค่าได้ส่งไปถึงฟังก์ชันของคุณอย่างไร
ทบทวน
คุณได้เรียนรู้ว่า URI ที่มีพารามิเตอร์ ใช้ตัวแทนในวงเล็บปีกกาเพื่อให้บริการทรัพยากรทั้งกลุ่ม โดยแต่ละตัวจับคู่กับพารามิเตอร์ของฟังก์ชันที่มีชื่อเดียวกัน ต่อไป: การสร้างเนื้อหาของทรัพยากรเหล่านี้ 🚀
คำถามที่พบบ่อย
บทเรียน “URI ทรัพยากรที่กำหนดพารามิเตอร์” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “URI ทรัพยากรที่กำหนดพารามิเตอร์” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “URI ทรัพยากรที่กำหนดพารามิเตอร์”
ดึงค่าตัวแปรโดยตรงจากเส้นทาง URI คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน MCP Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 1 จากทั้งหมด 4 บทเรียน
บทเรียน “URI ทรัพยากรที่กำหนดพารามิเตอร์” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม
ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- URI ทรัพยากรที่กำหนดพารามิเตอร์
- สร้างเนื้อหาเมื่อมีการอ่าน
- ทรัพยากรแบบรายการกับแบบแม่แบบ
- แจ้งไคลเอ็นต์เมื่อมีการอัปเดต