ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น
ส่งคืนข้อผิดพลาดที่ปัญญาประดิษฐ์อ่านและกู้คืนการทำงานได้
ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 1 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
ข้อผิดพลาดเป็นบริบทเพิ่มเติม
เมื่อเครื่องมือทำงานล้มเหลว AI จะไม่หยุดทำงาน แต่จะอ่าน ข้อผิดพลาด ของคุณเป็นบริบท แล้วตัดสินใจว่าจะทำอะไรต่อ เช่นเดียวกับผลลัพธ์ทั่วไป
ข้อผิดพลาดที่ดีต้องนำไปใช้แก้ไขได้
เขียน ข้อผิดพลาด สำหรับผู้อ่านที่สามารถดำเนินการแก้ไขได้ ข้อความว่าไม่พบเมืองมีประโยชน์กว่าคำว่า Exception เพราะโมเดลสามารถขอให้ผู้ใช้แก้ชื่อเมืองได้
ส่งคืนสตริงข้อผิดพลาด
รูปแบบที่ง่ายที่สุดคือส่งคืนสตริง ข้อความ ที่ชัดเจนเมื่อเกิดปัญหา เพื่อให้โมเดลอ่านได้อย่างแน่ชัดว่าอะไรล้มเหลว
@mcp.tool()
def get_user(uid: int) -> str:
if uid < 1:
return "Error: uid must be positive."ยกข้อผิดพลาดของเครื่องมือ
คุณสามารถ ยก ข้อยกเว้นปกติของ Python ได้เช่นกัน FastMCP จะดักจับข้อยกเว้นนั้นและรายงานข้อผิดพลาดของเครื่องมือกลับไปยังโมเดล ไม่ใช่ทำให้เซิร์ฟเวอร์หยุดทำงาน
@mcp.tool()
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("b cannot be zero")
return a / bisError ใช้ระบุผลลัพธ์
เบื้องหลังแล้ว การเรียกใช้เครื่องมือที่ล้มเหลวจะส่งคืนเนื้อหาที่ตั้งค่า isError เป็น true แฟล็กนี้บอกไคลเอ็นต์ว่าผลลัพธ์ดังกล่าวอธิบายความล้มเหลว
โมเดลกู้คืนได้
ข้อผิดพลาด ที่อ่านเข้าใจได้ช่วยให้ AI ลองใหม่ด้วยข้อมูลนำเข้าที่ดีขึ้น หรืออธิบายปัญหาแก่ผู้ใช้ เปลี่ยนความล้มเหลวให้เป็นขั้นตอนถัดไปที่มีประโยชน์ 🔁
ระบุว่าอะไรและเพราะเหตุใด
ข้อผิดพลาดที่ดีควรระบุว่าอะไรล้มเหลวและเพราะเหตุใด ข้อความว่าไม่พบไฟล์: report.csv มีประโยชน์ต่อ โมเดล มากกว่าข้อความสั้น ๆ ว่าไม่พบ
แนะนำวิธีแก้ไข
เมื่อทำได้ ให้บอกแนวทางแก้ไขไว้ใน ข้อผิดพลาด ด้วย ข้อความว่าวันที่ต้องอยู่ในรูปแบบ YYYY-MM-DD ช่วยให้โมเดลแก้ไขตัวเองได้ในการเรียกครั้งถัดไป
if not iso_date:
raise ValueError("Date must be in YYYY-MM-DD format")อย่าเปิดเผยรายละเอียดภายใน
ข้อผิดพลาดจะไปถึงโมเดลและบ่อยครั้งก็ไปถึงผู้ใช้ด้วย ดังนั้นอย่าใส่ ข้อมูลลับ ข้อความติดตามการทำงานดิบ หรือสตริงการเชื่อมต่อไว้ในข้อความที่คุณส่งคืน
ตรวจสอบก่อน แล้วจึงรายงานข้อผิดพลาด
ตรวจสอบอาร์กิวเมนต์ก่อน และส่งคืน ข้อผิดพลาด ก่อนเริ่มทำงานจริง การหยุดทำงานอย่างรวดเร็วทำให้เครื่องมือคาดเดาพฤติกรรมได้และเข้าใจเหตุผลได้ง่าย
ข้อผิดพลาดเป็นส่วนหนึ่งของสัญญา
มองความล้มเหลวเป็นผลลัพธ์ที่ออกแบบไว้ เครื่องมือที่ระบุ ข้อผิดพลาด ที่อาจเกิดขึ้นได้มีประโยชน์ต่อโมเดลไม่แพ้เครื่องมือที่อธิบายความสำเร็จ
ตรวจสอบความเข้าใจอย่างรวดเร็ว
เหตุใดจึงควรเขียนข้อผิดพลาดของเครื่องมือให้เป็นข้อความที่ชัดเจนและอ่านเข้าใจง่าย
สรุปทบทวน
ข้อผิดพลาด ของเครื่องมือคือบริบทที่โมเดลอ่าน ดังนั้นควรเขียนให้ชัดเจน ระบุว่าอะไรและเพราะเหตุใด แนะนำวิธีแก้ไข และอย่าเปิดเผยรายละเอียดภายใน ✅
คำถามที่พบบ่อย
บทเรียน “ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น”
ส่งคืนข้อผิดพลาดที่ปัญญาประดิษฐ์อ่านและกู้คืนการทำงานได้ คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน MCP Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 1 จากทั้งหมด 4 บทเรียน
บทเรียน “ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม
ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- ข้อผิดพลาดของเครื่องมือที่โมเดลมองเห็น
- ข้อผิดพลาดของโพรโทคอลกับความล้มเหลวของเครื่องมือ
- ตรวจสอบอินพุตก่อนดำเนินการ
- ล้มเหลวอย่างปลอดภัย ไม่ค้าง