BLOG / sku-md-v0-10-webmcp-product-knowledge-and-page-actions.mdx
SKU.md v0.10 × WebMCP: ความรู้สินค้าก่อนเข้าชมและการทำงานแบบมีโครงสร้างบนหน้าเว็บ
อธิบายว่า SKU.md v0.10 ให้ความรู้สินค้าที่คงทนและตรวจสอบย้อนหลังได้ก่อนเข้าชม ส่วน WebMCP เปิดเผยการทำงานปัจจุบันที่ผู้ใช้มองเห็นหลังเปิดหน้าเว็บ
เผยแพร่เมื่อ
เวอร์ชันข้อกำหนดเดิม: v0.10
ผู้ซื้อขอให้เอเจนต์หาเครื่องฟอกอากาศเงียบที่เหมาะกับห้องเด็ก มีไส้กรองเปลี่ยนได้ และรองรับขนาดห้องที่กำหนด ก่อนเปิดร้าน เอเจนต์ต้องแยกข้อเท็จจริงสินค้าออกจากคำโฆษณาให้ได้ว่าโมเดลและ Variant ใดตรง ความหมายของค่าความดังคืออะไร หลักฐานใดรองรับคำกล่าวอ้าง และควรระบุข้อจำกัดใด เมื่อเปิดหน้าสินค้า งานจะเปลี่ยนไป ผู้ซื้ออาจเลือกขนาดไส้กรอง เปรียบเทียบข้อกำหนดที่มองเห็น หรือขอให้หน้าเพิ่ม Variant ที่ระบุไว้ลง Cart ปัญหาแรกคือความเข้าใจสินค้าที่คงทน ส่วนปัญหาที่สองคือการโต้ตอบกับหน้าปัจจุบันอย่างปลอดภัย
SKU.md v0.10 กับ WebMCP เชื่อมกันตรงจุดส่งต่อนี้ แต่ไม่ใช่สิ่งเดียวกัน SKU.md เป็นชั้น Knowledge และหลักฐานที่ผู้ขายเผยแพร่ ส่วน WebMCP เป็น API ของหน้าเว็บในเบราว์เซอร์ที่ให้การทำงานจากหน้าซึ่งเปิดอยู่ต่อหน้าผู้ใช้แล้ว เอเจนต์ที่ดีใช้ชั้นแรกสร้างเจตนาที่มีหลักฐาน ใช้ชั้นที่สองทำงานบนหน้าแบบจำกัดขอบเขตและมองเห็นได้ แล้วกลับไปยังระบบการค้าแบบเรียลไทม์สำหรับการตัดสินใจที่ค่าอาจเปลี่ยน
การซื้อเริ่มก่อนเปิดแท็บ
คำถามแรกมักไม่ใช่ “ต้องกดปุ่มไหน” ผู้ซื้ออาจถามว่าสินค้าเข้ากับอุปกรณ์ที่มีอยู่หรือไม่ คำกล่าวอ้างเรื่องวัสดุมีการทดสอบที่ระบุชื่อรองรับหรือไม่ หรือคำเตือนด้านความปลอดภัยเด็กใช้กับการตั้งค่านี้หรือไม่ ควรตอบได้ก่อนเปิดแท็บ และคำตอบต้องเก็บแหล่งที่มา ขอบเขต กับวันที่ทบทวน ราคาหรือข้อความความพร้อมจำหน่ายเก่าไม่ควรได้รับอำนาจเป็นราคาปัจจุบันเพียงเพราะอยู่ข้างคำอธิบายสินค้าที่ยังมีประโยชน์
นี่คืองานของ SKU.md v0.10 ซึ่งเชื่อมตัวระบุที่เสถียรของ Product, Variant, SKU และ GTIN เข้ากับข้อเท็จจริง คำกล่าวอ้าง ข้อมูลเปิดเผย คำแนะนำด้านความเข้ากันได้ เอกสารต้นทาง และเวลาตรวจสอบที่ผู้ขายตรวจแล้ว ไฟล์มีประโยชน์เมื่อเอเจนต์วางแผนเข้าชม เปรียบเทียบสินค้ากับความต้องการผู้ซื้อ เตรียมคำอธิบายพร้อมการอ้างอิง หรือตรวจว่ากำลังหมายถึงโมเดลที่ตรง แต่ไม่ใช่เซสชันที่เรียกใช้งานได้ คำตอบสินค้าคงคลังแบบเรียลไทม์ หรือคำสั่งซื้อ
WebMCP เริ่มภายหลัง ภาพรวม WebMCP ของ Chrome ระบุข้อจำกัดชัดเจนว่าต้องมีบริบทหน้าเบราว์เซอร์และต้องเปิดหน้าเว็บไว้แล้ว เซสชันเบราว์เซอร์ในเครื่องหรือเซสชันเบราว์เซอร์ระยะไกลให้บริบทนี้ได้ แต่ WebMCP ไม่ใช่ API ฝั่งเซิร์ฟเวอร์ การเรียกแบบออฟไลน์ หรือกลไกการค้นพบก่อนเข้าชม WebMCP ยังไม่ใช่การรับส่ง MCP ฝั่งระบบหลังบ้าน รายการเครื่องมือแบบคงที่ หรือการค้นพบข้ามเว็บไซต์ แต่เป็นวิธีให้หน้าที่กำลังทำงานเปิดเผยการกระทำที่มีความหมายในสถานะ UI ปัจจุบัน
ความแตกต่างนี้ป้องกันทางลัดที่ดูสะดวกแต่ไม่ปลอดภัย เอเจนต์อ่านคำประกาศความสามารถจาก SKU.md แล้วสร้างการเรียกเครื่องมือเองเพื่อควบคุมเว็บไซต์ที่ผู้ใช้ยังไม่เปิดไม่ได้ ผู้ขายก็ไม่ควรบันทึกชื่อปุ่มและ Schema ผลลัพธ์ของวันนี้ในเอกสารสินค้าระยะยาว ระหว่างอ่านเอกสารกับเข้าหน้า ผู้ใช้อาจเปลี่ยนภาษา เข้าสู่ระบบ เลือก Variant ล้าง Cart หรือเสียสิทธิ์ หน้าที่กำลังทำงาน ไม่ใช่เอกสาร เป็นผู้รู้ว่าตอนนี้มีการกระทำใด
สิ่งที่ WebMCP เปิดเผยและไม่เปิดเผย
ร่างของ WebMCP Community Group กำหนดเครื่องมือ JavaScript ที่เว็บแอปพลิเคชันให้แก่เอเจนต์ Imperative API ลงทะเบียนเครื่องมือด้วย document.modelContext.registerTool() โดยหน้าให้ชื่อ คำอธิบาย Schema ข้อมูลเข้า ฟังก์ชันเรียกกลับสำหรับการทำงาน และคำกำกับแบบเลือกใช้ เหมาะกับการกระทำที่ต้องใช้ตรรกะของแอปพลิเคชัน การตรวจสถานะ การนำทาง หรือผลลัพธ์ที่จัดโครงสร้างอย่างรอบคอบ
Declarative API เพิ่มความหมายให้ฟอร์ม HTML ทั่วไป แอตทริบิวต์ toolname ตั้งชื่อการกระทำ ส่วน tooldescription อธิบายจุดประสงค์ เมื่อเอเจนต์เรียก เบราว์เซอร์จะย้ายจุดสนใจไปยังฟอร์มที่มองเห็นและกรอกฟิลด์ ผู้ใช้จึงเห็นสิ่งที่จะเกิด การลบแอตทริบิวต์ใดแอตทริบิวต์หนึ่งจะยกเลิกการลงทะเบียนเครื่องมือ เหมาะกับคำขอที่มีขอบเขตชัด เช่น ขอความช่วยเหลือเกี่ยวกับสินค้าหรือจองร้านอาหาร ไม่ใช่การแสร้งว่าเบราว์เซอร์อัตโนมัติทำข้อผูกพันทางการค้าได้ทุกแบบโดยไม่ตรวจทาน
Chrome DevTools for agents เกี่ยวข้องเพียงในฐานะเครื่องมือแก้จุดบกพร่อง เอกสารการตั้งค่า อธิบายเซิร์ฟเวอร์ MCP ที่เชื่อมเอเจนต์กับ Chrome เพื่อตรวจสอบและทดสอบ นี่เป็นสะพาน MCP สำหรับแก้จุดบกพร่องที่แยกต่างหาก ไม่ใช่จุดปลายทางเครื่องมือ WebMCP ของผู้ขายและไม่ใช่โปรโตคอลค้นพบสินค้าทดแทน ช่วยทีมตรวจการลงทะเบียน เรียกเครื่องมือระหว่างพัฒนา และทบทวนผลลัพธ์แบบมีโครงสร้าง แต่ไม่เปลี่ยนเครื่องมือหน้าเว็บเป็น API การค้าฝั่งเซิร์ฟเวอร์หรือแบบออฟไลน์
เดโมทางการทำให้ขอบเขตชัด เดโม Smart Home ลงทะเบียน rearrangeDOMComponents ที่เปลี่ยนองค์ประกอบซึ่งมองเห็นในแผงควบคุมจำลอง แต่ไม่ได้ควบคุมอุปกรณ์จริง เดโม French Bistro แสดงฟอร์มขอจองแบบประกาศและมองเห็นได้ มีวันที่ เวลา จำนวนคน ที่นั่ง และคำขอพิเศษ โดยหน้าเดโมใช้ตัวช่วยจำลองเมื่อไม่มีการรองรับในตัว ทั้งสองแสดงว่าการโต้ตอบที่ซับซ้อนจับคู่กับเจตนาแบบมีโครงสร้างได้ แต่ไม่พิสูจน์การค้นพบแบบครอบคลุม การทำงานข้ามเว็บไซต์ การดำเนินการที่เชื่อถือได้ การอนุมัติชำระเงิน หรือธุรกรรมการค้าที่เสร็จสมบูรณ์ เดโมไม่ใช่ธุรกรรมจริง
ตารางความรับผิดชอบที่ชัดเจน
การแยกต่อไปนี้ตั้งใจทำ เพื่อไม่ให้ชั้นที่สะดวกตอบคำถามซึ่งอีกชั้นมีอำนาจ
| พื้นผิว | ความรับผิดชอบที่มีอำนาจ | สิ่งที่เอเจนต์ควรทำ |
|---|---|---|
| SKU.md | หลักฐานใน Knowledge: ข้อเท็จจริง คำกล่าวอ้าง ข้อมูลเปิดเผย ความเข้ากันได้ ที่มา และตัวระบุที่ตรวจแล้ว | อธิบายและอ้างอิง ระบุ Product, Variant, SKU และ GTIN ที่ตรง |
| WebMCP และ UI ที่มองเห็น | เครื่องมือของหน้าปัจจุบันและสถานะการโต้ตอบที่ผู้ใช้มองเห็น | หลังเปิดหน้า ค้นหาเครื่องมือที่ลงทะเบียนแล้วและทำงานบนหน้าที่มีขอบเขตชัด |
| Catalog แบบเรียลไทม์และระบบหลังบ้านของผู้ขาย | ราคา สินค้าคงคลัง คุณสมบัติของผู้ซื้อ ตัวเลือกจัดส่ง ข้อมูลภาษี และกฎเฉพาะบัญชีปัจจุบัน | เรียกดูซ้ำแทนการเชื่อภาพบันทึกคงที่ |
| Checkout | ราคาสุดท้าย การจัดส่ง ภาษี การอนุมัติชำระเงิน ความยินยอม และการยืนยันการซื้อ | แสดงสถานะสุดท้ายและรักษาขอบเขตการยืนยัน |
ข้อความที่มีแหล่งที่มาใน SKU.md อธิบายราคาปลีกแนะนำของผู้ผลิตเป็นข้อเท็จจริงในอดีตหรือที่ตรวจแล้วได้ แต่ไม่ได้กลายเป็นราคาปัจจุบัน เช่นเดียวกับความพร้อมจำหน่าย ช่วงเวลาจัดส่ง โปรโมชัน และภาษี ข้อมูลเหล่านี้เป็นบริบทได้ แต่จะเป็นข้อเท็จจริงทางการค้าปัจจุบันก็ต่อเมื่อ Catalog ระบบหลังบ้าน หรือ Checkout ปัจจุบันส่งกลับ
สิ่งที่ v0.10 ประกาศจริง
SKU.md v0.10 มีวิธีแบบจำกัดในการแจ้งว่าการเข้าชมอาจเปิดความสามารถของหน้า รายการ capabilities[] ใช้ protocol: webmcp ระบุ page_runtime จำกัดคุณลักษณะด้วยขอบเขตกับ page_url_patterns และกำหนด requires_user_presence: true ได้ นี่คือคำใบ้การเข้าถึงที่บอกผู้บริโภคว่าหลังผู้ใช้เปิด URL ที่ตรง ผู้ขายอาจเปิดความสามารถขณะหน้าเว็บทำงาน
ตั้งใจไม่ให้เป็นสำเนาส่วนติดต่อที่เปลี่ยนแปลง ชื่อเครื่องมือ Schema ข้อมูลเข้าและผลลัพธ์ คำอธิบายเครื่องมือ และสถานะการลงทะเบียนเป็นของหน้าที่กำลังทำงานและไม่คัดลอกเข้า SKU.md JSON Schema ของ v0.10 กำหนดขอบเขตเอกสารที่เครื่องอ่านได้ ส่วนข้อกำหนด v0.10 ภาษาอังกฤษเป็นข้อความเชิงบรรทัดฐานเพียงฉบับเดียว รายละเอียดขณะทำงานอยู่นอก SKU.md เพื่อไม่ให้เอกสารเก่าแสร้งเป็นสัญญาเครื่องมือปัจจุบัน ผู้บริโภคควรถือ page_url_patterns เป็นคำใบ้สำหรับนำทาง ไม่ใช่สิทธิ์เรียกการทำงานที่ไม่เผยแพร่หรือคำสัญญาว่าทุกหน้าที่ระบุมีเครื่องมือลงทะเบียนอยู่ตอนนี้
การแบ่งนี้มีเหตุผลเชิงปฏิบัติ หน้าสินค้าอาจลงทะเบียนเครื่องมือเปรียบเทียบแบบอ่านอย่างเดียวก่อนเลือก Variant เปลี่ยนเป็นเครื่องมือตั้งค่าเมื่อเลือกข้อมูลได้ถูกต้อง และยกเลิกการลงทะเบียนหลังสถานะ Cart เปลี่ยน ชุดเครื่องมือปัจจุบันสะท้อนการเข้าสู่ระบบ ภาษา สินค้าคงคลัง การช่วยการเข้าถึง และความยินยอมได้ เอกสารคงที่ทำเช่นนั้นอย่างปลอดภัยไม่ได้
เส้นทางทั้งหมดของเอเจนต์
เอเจนต์เดินตามลำดับนี้ได้โดยไม่สร้างอำนาจขึ้นเอง
- อ่าน SKU.md พร้อมหลักฐาน ข้อมูลเปิดเผย และขอบเขต
- ระบุ Product, Variant, SKU และ GTIN ที่ตรง หากการระบุตัวตนกำกวมให้ถามแทนการเดา
- เปิดหน้าผู้ขายที่ตรงกับรูปแบบ URL ของหน้าที่ปลอดภัย โดยผู้ใช้อยู่ด้วย
- ค้นหาเครื่องมือที่หน้าปัจจุบันลงทะเบียนจริง
- เลือกเครื่องมือหนึ่งที่คำอธิบายตรงกับการทำงานบนหน้าที่ขอ แล้วเรียกใช้ใน UI ที่มองเห็น
- กลับไปยัง Catalog แบบเรียลไทม์หรือระบบหลังบ้านของผู้ขายเพื่อรับสถานะการค้าปัจจุบัน
- ใช้ Checkout สำหรับยอดรวมสุดท้าย ภาษี การจัดส่ง การอนุมัติชำระเงิน และการยืนยันขั้นสุดท้ายจากผู้ใช้
ขั้นเหล่านี้ตั้งใจไม่รวมเป็นเครื่องมือ “ซื้อ” ตัวเดียว เครื่องมือเลือก Variant ที่ระบุแล้ว อธิบายการเปรียบเทียบที่มองเห็น เริ่มคำขอจอง หรือเปิดมุมมอง Cart ได้ การซื้อสุดท้ายต้องมีราคาเสนอใหม่และการยืนยันที่มีความหมายในจังหวะตกลงซื้อ เราไม่แนะนำให้ใช้ toolautosubmit สำหรับการซื้อขั้นสุดท้าย ฟอร์มใน Declarative API อาจส่งอัตโนมัติได้ แต่นั่นเป็นพฤติกรรมของเบราว์เซอร์ ไม่ใช่หลักฐานว่าผู้ขายข้ามการตรวจฝั่งเซิร์ฟเวอร์หรือการตัดสินใจสุดท้ายของผู้ซื้อได้
แนวปฏิบัติผู้ขายที่รักษาขอบเขต
ข้อแรก เผยแพร่ข้อเท็จจริงและหลักฐานที่มนุษย์ตรวจแล้ว ตัวระบุที่เสถียรสำคัญ เพราะคำอธิบายที่ดีก็ใช้กับโมเดลใกล้เคียงหรือ Variant สีและขนาดใด ๆ อย่างปลอดภัยไม่ได้ ระบุแหล่งที่มาและข้อจำกัดของคำกล่าวอ้างสำคัญ เก็บข้อมูลเปิดเผยแทนการให้เอเจนต์อนุมานจากข้อความขาย ตรวจและอัปเดตเอกสารเมื่อข้อเท็จจริงเปลี่ยน ส่วนสถานะแบบเรียลไทม์ให้อยู่กับระบบเจ้าของ
ข้อสอง ออกแบบเครื่องมือหน้าเว็บให้มีความรับผิดชอบเดียว “เลือก Variant ที่ระบุ” และ “แสดงคำอธิบายความเข้ากันได้” เข้าใจง่าย ส่วน “ค้นหา ตั้งค่า ลดราคา จ่าย และสั่ง” ซ่อนข้อผูกพันมากเกินไปในการเรียกครั้งเดียว ลงทะเบียนเครื่องมือเฉพาะเมื่อใช้ได้ในสถานะที่ผู้ใช้มองเห็น และยกเลิกการลงทะเบียนเมื่อสถานะเปลี่ยน ข้อมูลกำกับของเครื่องมือก็เป็นข้อมูลเข้าที่ไม่น่าเชื่อถือ คำอธิบายกับ Schema ที่สั้นและตรงช่วยลดความกำกวม แต่ไม่ขจัดการแทรกคำสั่งหรือความเสี่ยงในการนำไปใช้
สุดท้าย ถือ readOnlyHint กับ untrustedContentHint เป็นเพียงคำใบ้ ไม่ใช่การรับประกันความปลอดภัย ป้ายอ่านอย่างเดียวไม่พิสูจน์ว่าการนำไปใช้จะไม่เปลี่ยนสถานะ และเครื่องหมายเนื้อหาที่ไม่น่าเชื่อถือก็ไม่ได้ทำให้ผลลัพธ์ปลอดภัยโดยอัตโนมัติ ต้องคงการตรวจสอบฝั่งเซิร์ฟเวอร์ การให้อำนาจ การจัดการแบบทำซ้ำได้โดยไม่เกิดผลเพิ่ม การควบคุมการฉ้อโกง บันทึกการตรวจสอบ และการยืนยันอย่างชัดเจนสำหรับความเสี่ยงสูง หน้าเว็บควรอธิบายผลที่เกิดขึ้นอย่างซื่อสัตย์ ส่วนระบบหลังบ้านต้องบังคับใช้กฎธุรกิจด้วยตนเอง
ประเมินการเสริมกัน ไม่ใช่คำกล่าวอ้างเรื่องอันดับ
การเปรียบเทียบที่มีค่าคือการใช้ WebMCP เพียงอย่างเดียวกับ WebMCP+SKU.md ในสถานการณ์ซื้อสินค้าเดียวกันที่มีขอบเขต วัดว่าเอเจนต์จับคู่ Product และ Variant ที่ขอ อ้างแหล่งที่มาถูก เปิดเผยข้อจำกัดกับหลักฐาน เลือกเครื่องมือหน้าปัจจุบันที่เหมาะ ปฏิเสธราคาเสนอที่หมดอายุ และรักษาขอบเขตการยืนยันหรือไม่ ผลเหล่านี้สังเกตและตรวจด้วยชุดข้อมูลทดสอบ หน้าทดลองแบบควบคุม และผลการทบทวนของมนุษย์ที่บันทึกไว้ได้
ห้ามเปลี่ยนการประเมินเป็นคำกล่าวอ้างเรื่องอันดับ อัตราการเปลี่ยนเป็นยอดซื้อ หรือการนำไปใช้ WebMCP ทำให้ส่วนติดต่อที่เปิดแล้วใช้ง่ายขึ้นได้ SKU.md ทำให้ความเข้าใจสินค้าก่อนเข้าชมคงทนและตรวจสอบย้อนหลังได้มากขึ้น ทั้งสองอย่างเดี่ยว ๆ ไม่รับประกันการซื้อ และเมื่อรวมกันก็ไม่แทน Catalog แบบเรียลไทม์ ระบบหลังบ้านของผู้ขาย หรือ Checkout คำมั่นที่ใช้งานได้จริงแคบกว่าและแข็งแรงกว่า คือรู้ว่าผู้ซื้อหมายถึงสินค้าใดก่อนเข้าชม แล้วค่อยทำงานกับสิ่งที่ผู้ซื้อเห็นหลังเปิดหน้า
สำหรับความพร้อมใช้งานและรายละเอียดการเข้าร่วม ให้ตรวจ WebMCP Origin Trial ของ Chrome ตอนนำขึ้นใช้งาน เพราะช่วงการทดลองและพฤติกรรมของเบราว์เซอร์อาจเปลี่ยนได้
อ่านเพิ่มเติม
ลำดับการตรวจสอบก่อนลงมือทำอธิบายไว้ใน แผนผังอำนาจการค้า