BLOG / introducing-sku-md-webmcp-readiness.mdx
จากความรู้สินค้าไปสู่การทำงานบนหน้าเว็บอย่างเชื่อถือได้: รู้จัก SKU.md WebMCP Readiness
คู่มือสำหรับผู้ค้าในการใช้ SKU.md WebMCP Readiness เพื่อแยกการค้นพบแบบคงที่ หลักฐานขณะทำงาน การกระทำที่มองเห็นได้ และอำนาจของข้อมูลการค้าแบบเรียลไทม์
เผยแพร่เมื่อ
เวอร์ชันข้อกำหนดเดิม: v0.10
ลองนึกว่าผู้ซื้อขอให้เอเจนต์หากระเป๋าถือขึ้นเครื่องที่ตรงข้อจำกัดของสายการบิน เปรียบเทียบวัสดุเปลือกสองแบบ และแสดงสีที่ถูกต้องบนหน้าสินค้าของผู้ค้า นี่เป็นงานซื้อครั้งเดียวแต่มีสองช่วง ก่อนเข้าเว็บไซต์ เอเจนต์ต้องมีความรู้สินค้าที่เชื่อถือได้ ได้แก่ ตัวระบุ ขนาด คำกล่าวอ้างเรื่องวัสดุ ตัวเลือกที่เข้ากัน และหลักฐานรองรับ หลังเปิดหน้าแล้ว เอเจนต์ต้องทำงานอย่างเชื่อถือได้ในอินเทอร์เฟซที่ผู้ใช้มองเห็น เช่น เลือกสี แสดงชุดตัวเลือกที่ตรงกัน หรือเลื่อนไปยังส่วนที่เกี่ยวข้อง
ไม่ควรรวมสองช่วงนี้เป็นคำสัญญาเดียว SKU.md ช่วยให้เอเจนต์เข้าใจสินค้าอย่างถูกต้องก่อนเข้าเว็บไซต์ WebMCP ช่วยให้เอเจนต์ทำงานอย่างเชื่อถือได้หลังมาถึงหน้าของผู้ค้า ภายในอินเทอร์เฟซที่ผู้ใช้มองเห็น ส่วนระบบเรียลไทม์มีอำนาจตัดสินข้อเท็จจริงทางการค้าขั้นสุดท้าย เช่น ราคาปัจจุบัน สต็อก การจัดส่ง ภาษี การชำระเงิน และสถานะคำสั่งซื้อ SKU.md WebMCP Readiness คือพื้นที่ทำงานที่ช่วยตรวจสอบการส่งต่อโดยไม่ยกระดับเบาะแสคงที่ให้เป็นหลักฐานขณะทำงาน
สามชั้นและอำนาจสามประเภท
พื้นที่ทำงานเริ่มจากกติกาผลิตภัณฑ์ที่เรียบง่าย แต่ละชั้นควรตอบเฉพาะคำถามที่พิสูจน์ได้จริง ความรู้สินค้าที่คงทนจึงยังมีประโยชน์ โดยไม่แทนที่หน้าที่กำลังทำงานหรือระบบที่สรุปธุรกรรม
| ชั้น | ข้อมูลที่ชั้นนี้มีอำนาจ | สิ่งที่ห้ามอ้าง |
|---|---|---|
| ความรู้สินค้า SKU.md | ข้อเท็จจริง ตัวระบุ คำกล่าวอ้าง การเปิดเผย ความเข้ากันได้ แหล่งที่มา ขอบเขต และเวลาตรวจทานก่อนเข้าชมที่ผู้ค้ารับรอง | เครื่องมือหน้าเว็บลงทะเบียนอยู่ในขณะนี้ หรือค่าทางการค้าที่เปลี่ยนแปลงยังเป็นปัจจุบัน |
| WebMCP และหน้าจอที่มองเห็น | เครื่องมือที่หน้าลงทะเบียนในบริบทเบราว์เซอร์ปัจจุบัน และการตอบสนองที่ผู้ใช้เห็นจากการกระทำแบบจำกัด | ราคา สต็อก สิทธิ์ หรือสถานะธุรกรรมที่หน้ายังไม่ได้ตรวจสอบ |
| Catalog แบบเรียลไทม์ ระบบหลังบ้าน และ Checkout | ราคาปัจจุบัน สต็อก คุณสมบัติการจัดส่ง ข้อมูลภาษี การอนุมัติชำระเงิน สถานะคำสั่งซื้อ และการยืนยันสุดท้าย | เอกสารคงที่หรือสิ่งที่เคยสังเกตจากหน้ายังเป็นปัจจุบัน |
นี่คือเรื่องเล่าของผลิตภัณฑ์ในรูปแบบที่นำไปใช้ได้ SKU.md ให้หลักฐานก่อนเข้าชม WebMCP เชื่อมเจตนากับการกระทำบนหน้าที่มองเห็นหลังมาถึง และระบบการค้าแบบเรียลไทม์ตัดสินข้อเท็จจริงขั้นสุดท้าย ทั้งสามชั้นเสริมกัน ไม่แทนกัน
เบาะแสของสะพานไม่เท่ากับเครื่องมือที่ทำงานได้
ซอร์สของหน้าอาจมีเครื่องหมายแบบประกาศ การเรียก WebMCP API หรือเส้นทางของสะพาน สิ่งเหล่านี้เป็นเบาะแสการค้นพบที่มีประโยชน์ แต่พิสูจน์ได้เพียงว่ามีร่องรอย ไม่ได้พิสูจน์ว่าเบราว์เซอร์รู้จักอินเทอร์เฟซ เครื่องมือลงทะเบียนในสถานะหน้าปัจจุบัน Schema ข้อมูลเข้าถูกต้อง หรือการเรียกจะสำเร็จ
สถานะขณะทำงานเปลี่ยนได้ เครื่องมืออาจปรากฏหลังส่วนประกอบพร้อม ถอนทะเบียนเมื่อการเลือกไม่ถูกต้อง หรือพึ่งการทดลองในเบราว์เซอร์ที่สภาพแวดล้อมอื่นไม่มี สคริปต์สะพานอาจจบโดยไม่ทำอะไรในเบราว์เซอร์ที่ไม่รองรับ คำอธิบายเครื่องมืออาจทำให้เข้าใจผิด และข้อความภายนอกหรือข้อความของผู้ค้าอาจมีคำสั่งคล้ายการแทรกพรอมต์ Readiness จึงบันทึกการค้นพบ การแยกความหมาย การลงทะเบียน การเรียก การตอบสนองที่มองเห็น การทบทวนความปลอดภัย และการยืนยันสภาพแวดล้อมแยกกัน แทนที่จะรวมเป็นตราสีเขียวเดียว
การตรวจก่อนแบบคงที่ไม่เรียกใช้ JavaScript ของหน้าเป้าหมายและไม่เรียกปลายทาง MCP ข้อสรุปที่ตรงไปตรงมาที่สุดคือพบเบาะแส หลักฐานขณะทำงานต้องมาจากหน้าเป้าหมายภายในบริบทเบราว์เซอร์จริง
ขั้นตอนห้าข้อสำหรับผู้ค้า
พื้นที่ทำงานจำกัดการทดสอบให้อยู่ในขอบเขตที่ผู้ค้าเข้าใจ ตรวจทาน และทำซ้ำได้
- ระบุหน้าที่แน่นอนหนึ่งหน้า เลือก URL HTTPS สาธารณะของสินค้า ตะกร้า การชำระเงิน หรือคำสั่งซื้อ จะให้ตรวจเทียบเอกสารสินค้ารากที่มาจากแหล่งเดียวกันก็ได้ แต่หน้าและเอกสารยังเป็นทรัพยากรคนละชนิด
- เรียกการตรวจก่อนแบบคงที่ SKU.md ตรวจสัญญาการตอบกลับ ค้นหาเบาะแส WebMCP ในซอร์ส บันทึกตัวขวางด้านความปลอดภัย และเปรียบเทียบขอบเขตหน้าของเอกสารสินค้าที่เลือก โดยไม่เรียกใช้หน้า
- ค้นพบเครื่องมือในเครื่อง เปิดหน้าเป้าหมายเดียวกัน ตรวจสคริปต์ค้นพบที่สร้างขึ้น แล้วเรียกในบริบทเบราว์เซอร์ของหน้านั้น ใบรับรองจะบันทึกอินเทอร์เฟซที่มีชื่อ บริบทเบราว์เซอร์ URL เวลา และรายการเครื่องมือที่ล้างข้อมูลแล้ว การค้นพบอย่างเดียวยังไม่พิสูจน์ว่าเรียกได้
- เรียกเครื่องมืออ่านอย่างเดียวหนึ่งรายการ เลือกได้เฉพาะเครื่องมือที่ระบุ
readOnlyHint: trueอย่างชัดเจน ใช้ข้อมูลเข้าน้อยที่สุดหลังยืนยันว่าหน้าเป็นpublic,unauthenticatedและไม่มีตัวขวางที่ระบุ พารามิเตอร์และผลลัพธ์ดิบจะอยู่ในหน้านั้นเพียงชั่วคราว - ยืนยันและส่งออก หากคาดว่าหน้าจะเปลี่ยน ให้บันทึกว่าสถานะที่มองเห็นซิงค์หรือไม่ แล้วนำเข้าใบรับรองที่ล้างข้อมูล ดาวน์โหลดรายงาน JSON หรือ Markdown ในเครื่อง และสร้างผู้สมัครความสามารถ WebMCP สำหรับคนตรวจเฉพาะเมื่อผ่านทุกเงื่อนไข
การเรียกเพียงครั้งเดียวเป็นข้อจำกัดโดยตั้งใจ ไม่ใช่ระบบอัตโนมัติทั่วไป เป้าหมายคือสร้างสายหลักฐานที่อธิบายได้สำหรับหน้าและสภาพแวดล้อมหนึ่ง ไม่ใช่บริหารร้านหรือทำธุรกรรมแทน
อ่านหลักฐานหกระดับแยกกัน
รายงานเก็บหกระดับไว้ เพราะแต่ละระดับตอบคำถามต่างกัน
- พบเบาะแสหน้า: HTML แบบคงที่มีร่องรอย WebMCP หรือสะพานหรือไม่
- เครื่องมือลงทะเบียนแล้ว: อินเทอร์เฟซเบราว์เซอร์ที่รู้จักส่งคืนเครื่องมือที่มี Schema ถูกต้องอย่างน้อยหนึ่งรายการหรือไม่
- เรียกอ่านอย่างเดียวสำเร็จ: เครื่องมือที่เลือกมีเครื่องหมายอ่านอย่างเดียวและเรียกด้วยข้อมูลน้อยที่สุดสำเร็จหรือไม่
- หน้าจอที่มองเห็นซิงค์แล้ว: เมื่อคาดว่าจะเปลี่ยน ผู้ค้ายืนยันการเปลี่ยน URL ตัวกรอง ตัวเลือก หรือสถานะที่มองเห็นหรือไม่
- ตรวจความปลอดภัยแล้ว: ผู้ค้ายืนยันบริบทสาธารณะที่ออกจากระบบ และทบทวนต้นทาง เนื้อหาที่ไม่น่าเชื่อถือ และความเสี่ยงจากการแทรกพรอมต์หรือไม่
- ยืนยันสภาพแวดล้อมที่ระบุ: ใบรับรองระบุอินเทอร์เฟซ เบราว์เซอร์ หน้าที่แน่นอน บริบทความปลอดภัย และเวลาตรวจหรือไม่
แต่ละระดับใช้สถานะหลักฐานหนึ่งในสี่แบบ
passedหมายถึงเก็บหลักฐานที่ต้องใช้แล้วและตรงกติกาfailedหมายถึงการตรวจพบหลักฐานของการละเมิดหรือผลล้มเหลวที่ชัดเจนincompleteหมายถึงหลักฐานหายไป เก่าเกินไป ไม่รองรับ หรือไม่เพียงพอ ไม่ได้แปลว่าผลิตภัณฑ์เสียเสมอไปnot_applicableใช้เฉพาะเมื่อระดับนั้นไม่เกี่ยวข้องจริง เช่น การซิงค์หน้าในเครื่องมือค้นข้อมูลล้วนที่ไม่ควรเปลี่ยนหน้า
ผลรวมใช้เพียง passed, failed หรือ incomplete หน้าที่มีแค่เบาะแสสะพานแบบคงที่ควรอยู่ในสถานะไม่สมบูรณ์จนกว่าจะมีหลักฐานขณะทำงาน ความเข้มงวดนี้ทำให้รายงานบอกสิ่งที่พิสูจน์แล้ว ไม่ให้รางวัลกับการตีความในแง่ดี
สิ่งที่ผู้ค้าเรียนรู้จากรายงาน
หน้าแรกของรายงานตอบคำถามที่นำไปแก้ไขได้ แทนคะแนนกว้าง ๆ
- สภาพแวดล้อมที่ระบุพบเครื่องมือกี่รายการบนหน้าที่แน่นอนนี้
- เครื่องมือใดมี Schema ข้อมูลเข้าที่ถูกต้องและเครื่องหมายอ่านอย่างเดียวชัดเจน
- ปัญหาใดขวางการใช้เอเจนต์อย่างปลอดภัย และผู้ค้าแก้อะไรได้
- หน้าตอบสนองต่อการเรียกที่เลือกจริงหรือไม่ และสถานะที่มองเห็นซิงค์ตามคาดหรือไม่
- คำประกาศ SKU.md ที่เลือกครอบคลุมหน้าที่แน่นอนนี้โดยไม่อ้างอำนาจแบบเรียลไทม์หรือไม่
- หลักฐานผ่านทุกเงื่อนไขสำหรับสร้างผู้สมัครความสามารถ beta หรือไม่
รายงานบันทึกเวลาตรวจ เป้าหมาย ขอบเขต อินเทอร์เฟซตัวปรับ และบริบทเบราว์เซอร์ ใบรับรองที่เกิน 24 ชั่วโมง หรือมี URL หรือขอบเขตไม่ตรง จะสร้างผู้สมัครไม่ได้ จึงผูกผลสำเร็จไว้กับสภาพแวดล้อมที่สร้างผลนั้น ไม่เปลี่ยนเป็นคำสัญญาถาวร
รูปแบบที่เครื่องอ่านได้อยู่ใน SKU.md WebMCP Readiness v1 Schema ที่เป็นกลาง นี่คือสัญญารายงานเครื่องมือของ SKU.md ไม่ใช่ส่วนหนึ่งของ Schema เอกสารสินค้า SKU.md v0.10 และไม่ใช่มาตรฐาน WebMCP
ความเป็นส่วนตัวในเครื่องและขอบเขตความปลอดภัยที่แคบ
URL หน้าที่แน่นอนและ URL เอกสารสินค้าต้นทางเดียวกันที่เลือกจะส่งไปยังปลายทางตรวจก่อนของ SKU.md ที่มาจากแหล่งเดียวกัน เพื่ออ่านข้อมูลสาธารณะแบบจำกัด คำขอนี้ไม่ใช่การเข้าสู่ระบบเบราว์เซอร์และไม่ส่งคุกกี้ของหน้าผู้ค้า การตรวจคงที่ไม่เรียก JavaScript หรือเครื่องมือเป้าหมาย
การค้นพบขณะทำงานและการเรียกเครื่องมือที่เลือกเกิดบนหน้าเป้าหมายในเบราว์เซอร์ของผู้ค้า พารามิเตอร์ดิบ ผลลัพธ์ดิบ คุกกี้ โทเค็น และบทสนทนาทั้งหมดไม่ส่งไปยัง SKU.md และไม่อยู่ในไฟล์ส่งออก รายงานเก็บเฉพาะข้อมูลที่ล้างแล้ว เช่น ชื่อเครื่องมือ สถานะผลลัพธ์ แฮช จำนวนไบต์ ระยะเวลา และสถานะหน้าก่อนกับหลังเรียก
รุ่นแรกจำกัดที่หน้าสาธารณะที่ออกจากระบบและเครื่องมืออ่านอย่างเดียวที่ชัดเจนหนึ่งรายการ ไม่ทดสอบราคาสมาชิก ข้อมูลส่วนบุคคล คำสั่งซื้อที่ยืนยันตัวตน การชำระเงิน การคืนสินค้า การจบ Checkout หรือการกระทำที่เปลี่ยนสถานะการค้า คำอธิบายเครื่องมือ Schema ข้อมูลเข้า สรุปผล ข้อความผู้ค้า และเนื้อหาบุคคลที่สามถือเป็นข้อความไม่น่าเชื่อถือ การประกาศความสามารถไม่ใช่สิทธิ์เรียกใช้
ผู้สมัคร beta เป็นข้อมูลให้ทบทวน ไม่ใช่อำนาจ
เมื่อการตรวจก่อน สภาพแวดล้อมที่รู้จัก การลงทะเบียน Schema ที่ถูกต้อง การยืนยันเซสชันสาธารณะ การเรียกอ่านอย่างเดียวหนึ่งครั้ง และการตรวจความปลอดภัยทั้งหมดผ่านภายในเวลา พื้นที่ทำงานจะสร้างผู้สมัครความสามารถ beta ได้ ผู้สมัครใช้รูปแบบหน้าที่แน่นอนหนึ่งรายการและระบุว่าต้องมีหน้าเบราว์เซอร์กับผู้ใช้อยู่ด้วย
ไฟล์นี้ตั้งใจให้จำกัด ไม่คัดลอกรายการเครื่องมือแบบพลวัต ไม่สร้างไวลด์การ์ด ไม่ให้สิทธิ์ ไม่เผยแพร่อัตโนมัติ ไม่ยกเอกสารพื้นฐานเป็นเอกสารการค้า และไม่อนุมัติธุรกรรม เป็นวัสดุที่ผู้ค้าตรวจและรวมด้วยตนเอง หากชนกับคำประกาศการค้าที่มีอยู่ รายงานจะแสดงส่วนต่าง หากเริ่มจากเอกสารพื้นฐาน รายงานจะระบุข้อกำหนดการค้าอื่นที่ยังขาด
ดังนั้น Readiness ไม่ใช่สะพานสำหรับงานจริงที่เบาะแสคงที่สัญญาไว้ แต่เป็นกระบวนการสร้างหลักฐานก่อนตัดสินใจเรื่องสะพาน ชุดความสามารถจริง การเขียน Checkout, Order และการเชื่อม MCP ฝั่งระบบต้องออกแบบและทบทวนความปลอดภัยแยกต่างหาก
เริ่มจากหน้าสินค้าจริงหนึ่งหน้า
เลือกหน้าสินค้าที่เสถียร สาธารณะ และส่ง HTML โดยตรง จากนั้นเริ่มด้วยการตรวจแบบคงที่ หากผลมีเพียงเบาะแส อย่าเรียกว่าผ่าน ให้ค้นพบขณะทำงานเฉพาะในหน้าที่แน่นอนเดียวกันซึ่งคุณควบคุม แล้วทดสอบเครื่องมืออ่านอย่างเดียวที่มีความหมายชัดเจนหนึ่งรายการ รายงาน incomplete ที่ซื่อตรงมีประโยชน์กว่าตรา passed ที่สร้างจากข้อสมมติ
เปิดพื้นที่ทำงาน WebMCP Readiness ที่แปลเป็นภาษาของคุณเพื่อตรวจหน้าเว็บ หากต้องการเข้าใจการแบ่งบทบาทระหว่างความรู้สินค้าและการกระทำในหน้าเบราว์เซอร์ อ่าน SKU.md v0.10 × WebMCP: ความรู้สินค้าก่อนเข้าชมและการกระทำอย่างมีโครงสร้างบนหน้า
อ่านเพิ่มเติม
ดูขอบเขตระหว่างความรู้ การทำงานบนหน้าเว็บ และคำสั่งซื้อใน แผนผังการส่งต่ออำนาจ