อินพุตของโมเดลด้วย Pydantic
กำหนดรูปแบบอาร์กิวเมนต์ของเครื่องมือที่มีชนิดข้อมูลชัดเจน
อินพุตของโมเดลด้วย Pydantic เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
หนึ่งโมเดลต่อข้อมูลนำเข้า
เพื่อกำหนดรูปแบบอาร์กิวเมนต์ของเครื่องมือ คุณจะเขียน โมเดล Pydantic ซึ่งเป็นคลาสขนาดเล็กที่แอตทริบิวต์แต่ละรายการคือฟิลด์ของข้อมูลนำเข้าที่มีการระบุชนิด
from pydantic import BaseModel
class SearchInput(BaseModel):
query: str
limit: intสืบทอดจาก BaseModel
โมเดลข้อมูลนำเข้าทุกตัวสืบทอดจาก BaseModel ซึ่งมอบความสามารถในการแยกวิเคราะห์ ตรวจสอบ และสร้างสคีมา JSON ให้โดยอัตโนมัติ
ฟิลด์คือแอตทริบิวต์ที่มีชนิด
แต่ละบรรทัดระบุ ฟิลด์และชนิดข้อมูลของฟิลด์นั้น Pydantic อ่านคำอธิบายชนิดเหล่านี้เพื่อทราบว่าข้อมูลนำเข้าที่ถูกต้องควรเป็นอย่างไร
ส่งโมเดลเป็นอาร์กิวเมนต์เดียว
ในเครื่องมือ FastMCP ให้รับโมเดลเป็น พารามิเตอร์เดียวที่มีการระบุชนิด แล้วกรอบการทำงานจะสร้างสคีมาจากโมเดลนั้น
@mcp.tool()
def search(args: SearchInput) -> str:
return run(args.query, args.limit)เข้าถึงฟิลด์ด้วยชื่อ
ภายในเครื่องมือ ให้อ่านค่าผ่าน แอตทริบิวต์: args.query และ args.limit ไม่ต้องค้นหาค่าในพจนานุกรม และโปรแกรมแก้ไขของคุณจะแนะนำการเติมข้อความให้
แปลงชนิดเมื่อเหมาะสม
Pydantic จะ แปลงชนิดของค่าที่เข้ากันได้ให้อย่างเหมาะสม เช่น เปลี่ยนสตริง 5 เป็นจำนวนเต็ม 5 ทำให้ความไม่ตรงกันเล็กน้อยทำงานได้ทันที
ปฏิเสธชนิดข้อมูลที่ไม่ถูกต้อง
หากค่าไม่สามารถเปลี่ยนเป็นชนิดที่ประกาศไว้ได้ Pydantic จะสร้าง ข้อผิดพลาดในการตรวจสอบที่ชัดเจน แทนที่จะปล่อยให้ค่าดังกล่าวผ่านไป
โมเดลซ้อนกัน
ฟิลด์หนึ่งอาจเป็นโมเดลอื่นได้ ทำให้คุณอธิบายออบเจ็กต์ที่ ซ้อนกันอย่างเป็นระเบียบ แทนการใช้พจนานุกรมดิบที่ซ้อนกันลึก ๆ
class Address(BaseModel):
city: str
class User(BaseModel):
name: str
home: Addressระบบสร้างสคีมาให้
Pydantic เปลี่ยนโมเดลของคุณเป็น สคีมา JSON โดยอัตโนมัติ จากนั้น MCP จะส่งต่อให้ไคลเอนต์ เพื่อให้โมเดลทราบรูปแบบข้อมูลนำเข้า
นำโมเดลกลับมาใช้กับหลายเครื่องมือ
กำหนดโมเดลเพียงครั้งเดียวแล้วใช้ร่วมกันในเครื่องมือหลายรายการ วิธีนี้ทำให้ รูปแบบข้อมูลนำเข้าสอดคล้องกัน และช่วยลดโค้ดซ้ำ
ความปลอดภัยของชนิดข้อมูลตั้งแต่ต้นจนจบ
ตั้งแต่โมเดลถูกเรียกใช้จนถึงส่วนเนื้อหาของฟังก์ชัน ข้อมูลจะคง ชนิดข้อมูลที่ผ่านการตรวจสอบไว้แบบเดียวกัน คุณจึงไม่ต้องจัดการกับพจนานุกรมที่ไม่มีชนิดข้อมูลอีก
ตรวจสอบอย่างรวดเร็ว
คุณจะกำหนดรูปแบบข้อมูลนำเข้าที่มีชนิดสำหรับเครื่องมือด้วย Pydantic ได้อย่างไร
สรุปทบทวน
สืบทอดจาก BaseModel ระบุฟิลด์ที่มีชนิดข้อมูล และส่งโมเดลเป็นอาร์กิวเมนต์เดียว Pydantic จะตรวจสอบข้อมูลนำเข้าและสร้างสคีมาให้ ✅
เรียนรู้ Python ด้วย AI tutor — ฟรี
เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป
- คอร์ส
- 30
- บทเรียน
- 120
คำถามที่พบบ่อย
บทเรียน “อินพุตของโมเดลด้วย Pydantic” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “อินพุตของโมเดลด้วย Pydantic” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “อินพุตของโมเดลด้วย Pydantic”
กำหนดรูปแบบอาร์กิวเมนต์ของเครื่องมือที่มีชนิดข้อมูลชัดเจน คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน MCP Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน
บทเรียน “อินพุตของโมเดลด้วย Pydantic” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม
ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- เหตุใดโครงสร้างข้อมูลจึงดีกว่าอาร์กิวเมนต์หลวม ๆ
- อินพุตของโมเดลด้วย Pydantic
- ข้อจำกัด ค่าเริ่มต้น และ Enum
- คำอธิบายฟิลด์ที่ช่วยชี้นำโมเดล