MCP Academy · บทเรียน

ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล

ใช้คำใบ้ชนิดข้อมูลของ Python เพื่อกำหนดโครงสร้างเครื่องมือ

บทเรียน 2 จาก 413 ขั้นตอน

ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน

พารามิเตอร์กลายเป็นสคีมา

อาร์กิวเมนต์ทุกตัวของฟังก์ชันเครื่องมือจะกลายเป็นส่วนหนึ่งของสคีมาข้อมูลนำเข้าที่โมเดลต้องปฏิบัติตามเมื่อเรียกใช้เครื่องมือ 🧩

คำใบ้ชนิดข้อมูลทำหน้าที่ให้

FastMCP อ่านคำใบ้ชนิดข้อมูลใน Python แล้วสร้างสคีมา JSON ให้คุณ จึงแทบไม่ต้องเขียนสคีมาด้วยตนเอง

@mcp.tool()
def add(a: int, b: int) -> int:
    return a + b

str, int, float, bool

ชนิดข้อมูลพื้นฐานจะถูกจับคู่ได้ตรงไปตรงมา: str กลายเป็นสตริง ส่วน int และ float กลายเป็นตัวเลข และ bool กลายเป็นค่าบูลีนในสคีมา

ไม่มีชนิดข้อมูลก็ไม่ชัดเจน

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

def add(a, b):
    return a + b

จำเป็นโดยค่าเริ่มต้น

พารามิเตอร์ที่ไม่มีค่าเริ่มต้นจะถือว่าจำเป็น ดังนั้นโมเดลต้องส่งค่าให้ทุกครั้งที่เรียกใช้เครื่องมือ

ค่าเริ่มต้นทำให้ไม่จำเป็น

กำหนดค่าเริ่มต้นให้พารามิเตอร์ แล้วพารามิเตอร์นั้นจะกลายเป็นตัวเลือก โมเดลอาจไม่ส่งค่า และฟังก์ชันของคุณจะใช้ค่าทางเลือกแทน

@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
    ...

รายการและพจนานุกรม

คุณสามารถระบุชนิดของชุดข้อมูลได้เช่นกัน อาร์กิวเมนต์รายการจะถูกจับคู่เป็นอาร์เรย์ JSON ส่วนพจนานุกรมจะถูกจับคู่เป็นออบเจ็กต์ที่โมเดลเติมข้อมูลได้

def tag(items: list[str]) -> int:
    return len(items)

ค่าที่ไม่บังคับ

ใช้ Optional เมื่ออาร์กิวเมนต์อาจเป็นค่าหนึ่งค่าหรือ None เพื่อบอกโมเดลว่าสามารถเว้นว่างไว้โดยตั้งใจได้

from typing import Optional
def find(q: str, limit: Optional[int] = None):
    ...

ตั้งชื่อพารามิเตอร์ให้ชัดเจน

โมเดลจะเห็นชื่อพารามิเตอร์แต่ละตัวในสคีมา ดังนั้น city จึงดีกว่า c และ start_date ดีกว่า arg2 ชื่อที่ชัดเจนช่วยชี้นำการเรียกใช้ให้ดีขึ้น

คำใบ้ช่วยตรวจสอบความถูกต้อง

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

รักษาลายเซ็นให้เล็ก

พารามิเตอร์ที่มีจำนวนน้อยและระบุชนิดชัดเจน ช่วยให้โมเดลกรอกข้อมูลได้ถูกต้องง่ายกว่าอาร์กิวเมนต์จำนวนมากที่ไม่เกี่ยวข้องกันอย่างชัดเจน

ตรวจสอบอย่างรวดเร็ว

อะไรทำให้พารามิเตอร์ของเครื่องมือเป็นตัวเลือกใน FastMCP

ตอบคำถามในบทเรียนแบบโต้ตอบ

ทบทวน

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

เริ่มต้นได้ฟรี

เรียนรู้ Python ด้วย AI tutor — ฟรี

เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป

คอร์ส: 30
บทเรียน: 120

เริ่มเรียนฟรี ดูหลักสูตรเต็ม

คำถามที่พบบ่อย

บทเรียน “ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล”

ใช้คำใบ้ชนิดข้อมูลของ Python เพื่อกำหนดโครงสร้างเครื่องมือ คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน

คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่

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

บทเรียน “ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล” ใช้เวลานานแค่ไหน

บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย

ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม

ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ

บทเรียนทั้งหมดในหลักสูตรนี้

← กลับไปที่ MCP Academy