โครงสร้างเอาต์พุตสำหรับไคลเอ็นต์
เผยแพร่รูปแบบข้อมูลเพื่อให้ผู้ใช้ข้อมูลอ้างอิงได้อย่างมั่นใจ
โครงสร้างเอาต์พุตสำหรับไคลเอ็นต์ เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน
เผยแพร่รูปแบบ
เครื่องมือแบบมีโครงสร้างยังสามารถประกาศ โครงร่างผลลัพธ์ ได้ ซึ่งเป็น JSON Schema ที่บอกไคลเอนต์อย่างชัดเจนว่าควรคาดหวังฟิลด์และชนิดข้อมูลใด
โครงร่างผลลัพธ์คืออะไร
โครงร่างผลลัพธ์คือคำอธิบายผลลัพธ์ที่เครื่องอ่านได้ โดยระบุชื่อและชนิดข้อมูลของแต่ละฟิลด์ ไคลเอนต์จะอ่านข้อมูลนี้ ก่อน เรียกใช้เครื่องมือ
สร้างจากโมเดลของคุณ
เมื่อคุณส่งคืนโมเดล Pydantic SDK จะสร้างโครงร่างผลลัพธ์ให้คุณโดยอัตโนมัติ คำใบ้ชนิดข้อมูล ของคุณจะกลายเป็นข้อตกลงที่เผยแพร่โดยอัตโนมัติ
ไคลเอนต์เห็นโครงร่างที่ใด
โครงร่างจะติดไปกับรายการเครื่องมือภายใต้ outputSchema ไคลเอนต์ที่ตรวจสอบเครื่องมือจะเรียนรู้ รูปแบบ ได้โดยไม่ต้องลองผิดลองถูก
{"type": "object", "properties": {"temp_c": {"type": "number"}}}เหตุผลที่ไคลเอนต์ต้องการโครงร่าง
เมื่อทราบโครงร่างแล้ว ไคลเอนต์สามารถตรวจสอบผลลัพธ์และสร้างส่วนติดต่อผู้ใช้ไว้ล่วงหน้าได้ จึงไม่ต้อง คาดเดา ว่าจะมีฟิลด์ใดปรากฏบ้าง
ชนิดข้อมูลสื่อความหมาย
โครงร่างระบุว่า temp_c เป็นตัวเลข และ condition เป็นสตริง ผู้ใช้ข้อมูลจึง เชื่อถือ ชนิดข้อมูลเหล่านี้ แทนการอนุมานจากตัวอย่างเพียงรายการเดียว
จำเป็นเทียบกับไม่บังคับ
ฟิลด์ที่มีค่าเริ่มต้นจะกลายเป็นฟิลด์ไม่บังคับในโครงร่าง ส่วนฟิลด์อื่น ๆ เป็นฟิลด์จำเป็น ไคลเอนต์จึงทราบว่าคีย์ใด รับรองได้ ว่าจะมีอยู่
class Weather(BaseModel):
temp_c: float
note: str = ""ข้อตกลงที่มั่นคง
ให้ถือว่าโครงร่างผลลัพธ์เป็นคำสัญญา เมื่อไคลเอนต์พึ่งพาโครงร่างนั้นแล้ว การเปลี่ยนชื่อหรือชนิดข้อมูลของฟิลด์อาจ ทำให้ ไคลเอนต์ที่อยู่ถัดไปทำงานไม่ได้
โครงร่างช่วยตรวจสอบข้อมูล
ไคลเอนต์ที่ตรวจสอบอย่างเคร่งครัดจะตรวจสอบผลลัพธ์ทุกรายการเทียบกับโครงร่าง และปฏิเสธผลลัพธ์ที่ไม่ตรงกัน วิธีนี้ตรวจจับข้อผิดพลาดของเซิร์ฟเวอร์ได้ อย่างรวดเร็ว ที่ขอบเขตการเชื่อมต่อ
เครื่องมือที่อธิบายตัวเอง
โครงร่างผลลัพธ์ทำหน้าที่เป็นเอกสารประกอบไปด้วย นักพัฒนาคนใหม่อ่าน โครงร่าง เพื่อทำความเข้าใจเครื่องมือได้โดยไม่ต้องค้นดูโค้ดของคุณ
รักษาความถูกต้องของโครงร่าง
ตรวจสอบให้แน่ใจว่าเครื่องมือของคุณส่งคืนสิ่งที่โครงร่างระบุไว้เสมอ ผลลัพธ์ที่เบี่ยงเบนจาก โครงร่าง จะบั่นทอนความไว้วางใจที่ไคลเอนต์มีต่อเครื่องมือ
ตรวจสอบความเข้าใจอย่างรวดเร็ว
เครื่องมือเผยแพร่รูปแบบของผลลัพธ์ไว้ที่ใด
ทบทวน: โครงร่างผลลัพธ์
คุณได้เห็นวิธีที่เครื่องมือเผยแพร่ โครงร่างผลลัพธ์ จากโมเดลของคุณ โครงร่างนี้บันทึกฟิลด์ เปิดให้ตรวจสอบข้อมูล และสร้างข้อตกลงที่มั่นคง ✅
เรียนรู้ Python ด้วย AI tutor — ฟรี
เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป
- คอร์ส
- 30
- บทเรียน
- 120
คำถามที่พบบ่อย
บทเรียน “โครงสร้างเอาต์พุตสำหรับไคลเอ็นต์” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “โครงสร้างเอาต์พุตสำหรับไคลเอ็นต์” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ 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 ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- เนื้อหาข้อความกับเนื้อหาแบบมีโครงสร้าง
- ส่งคืนออบเจ็กต์ผลลัพธ์ที่มีชนิดข้อมูล
- โครงสร้างเอาต์พุตสำหรับไคลเอ็นต์
- ส่งคืนรูปภาพและข้อมูลไบนารี