ส่งคืนผลลัพธ์ที่มีประโยชน์
ส่งข้อความกลับไปให้โมเดลและผู้ใช้ใช้งานได้
ส่งคืนผลลัพธ์ที่มีประโยชน์ เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
ผลลัพธ์ส่งกลับไปยังโมเดล
สิ่งใดก็ตามที่เครื่องมือส่งคืนจะถูกส่งกลับไปยัง AI ในฐานะบริบท จึงมีผลต่อคำตอบถัดไปของโมเดลที่มอบให้ผู้ใช้ 🔁
ส่งคืนสตริง
ผลลัพธ์ที่มีประโยชน์และเรียบง่ายที่สุดคือสตริงธรรมดา FastMCP จะห่อหุ้มสตริงนั้นเป็นเนื้อหาข้อความที่โมเดลอ่านได้โดยตรง
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameทำให้ข้อความอธิบายตัวเอง
โมเดลไม่มีบริบทอื่น ดังนั้นข้อความของคุณควรอธิบายตัวเองได้ ให้ส่งคืน The total is 42 แทนที่จะส่งคืนเพียง 42
ตัวเลขจะถูกแปลงเป็นสตริง
หากคุณส่งคืนค่า int หรือ float FastMCP จะแปลงค่าเป็นข้อความให้ แต่การเพิ่มป้ายกำกับจะช่วยให้โมเดลเข้าใจค่าดังกล่าวได้ชัดเจนขึ้น
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bส่งคืนข้อมูลแบบมีโครงสร้าง
ส่งคืนพจนานุกรมหรือรายการ แล้ว FastMCP จะทำให้ข้อมูลเป็นJSON ทำให้โมเดลได้รับเขตข้อมูลที่สะอาดและแยกวิเคราะห์ได้ แทนร้อยแก้วที่ไม่มีโครงสร้าง
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}รักษาผลลัพธ์ให้กระชับ
โทเค็นทุกตัวที่ส่งคืนจะใช้พื้นที่บริบทของโมเดล ดังนั้นควรตัดผลลัพธ์ให้เหลือเฉพาะสิ่งที่ตอบคำขอจริง ๆ ลดสิ่งรบกวน เพื่อให้คำตอบคมชัดขึ้น
จัดรูปแบบให้อ่านง่าย
เมื่อผลลัพธ์มีหลายส่วน การมีโครงสร้างเล็กน้อยจะช่วยได้ บรรทัดสั้น ๆ ที่มีป้ายกำกับย่อมดีกว่าประโยคยาวที่โมเดลต้องแกะความหมาย
ส่งคืนข้อผิดพลาดเป็นข้อความ
เมื่อเกิดข้อผิดพลาด การส่งคืนข้อความที่ชัดเจนช่วยให้โมเดลอธิบายปัญหาและลองแก้ไขได้ แทนที่จะคาดเดา
if not city:
return "Error: city is required."อย่าส่งคืนข้อมูลลับ
ผลลัพธ์จะไปถึงโมเดลและมักไปถึงผู้ใช้ด้วย ดังนั้นอย่าใส่ข้อมูลลับ เช่น คีย์ API หรือรหัสผ่านดิบลงในสิ่งที่ส่งคืน
รูปแบบที่สม่ำเสมอช่วยได้
ส่งคืนรูปแบบเดิมทุกครั้ง เพื่อให้โมเดลเรียนรู้ว่าจะต้องคาดหวังอะไร ความประหลาดใจในโครงสร้างทำให้เกิดคำตอบที่อ่านความหมายผิด
ให้ตรงกับสิ่งที่เครื่องมือรับปาก
ผลลัพธ์ของคุณควรส่งมอบสิ่งที่คำอธิบายระบุไว้อย่างตรงไปตรงมา หากบอกว่าจะส่งคืนราคา ก็ให้ส่งคืนราคา ไม่ใช่รายงานทั้งฉบับ
ตรวจสอบอย่างรวดเร็ว
จะเกิดอะไรขึ้นเมื่อเครื่องมือของคุณส่งคืนพจนานุกรม Python
ทบทวน
ผลลัพธ์ของคุณจะกลายเป็นบริบทของโมเดล: ส่งคืนข้อความหรือ JSON ที่ชัดเจน กระชับ และอธิบายตัวเองได้ รักษารูปแบบให้สม่ำเสมอ และอย่าทำข้อมูลลับรั่วไหล ✅
คำถามที่พบบ่อย
บทเรียน “ส่งคืนผลลัพธ์ที่มีประโยชน์” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “ส่งคืนผลลัพธ์ที่มีประโยชน์” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ 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 ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- ตั้งชื่อและอธิบายเครื่องมือให้ดี
- ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล
- ส่งคืนผลลัพธ์ที่มีประโยชน์
- เครื่องมือเครื่องคิดเลขตั้งแต่ต้นจนจบ