BLOG / publish-your-first-sku-md.mdx
เผยแพร่ SKU.md ฉบับแรก: คู่มือที่แม่นยำและไม่ผูกแพลตฟอร์ม
เตรียม สร้าง เผยแพร่ และตรวจ /sku.md ที่รากด้วย HTTP 200 โดยตรง, text/markdown, URL หลักที่ตรงกัน และการทดสอบออนไลน์
การเผยแพร่เสร็จเมื่อไบต์ที่ยอมรับถูกส่งโดยตรงจาก HTTPS URL ที่ประกาศและผ่านการตรวจออนไลน์ ไฟล์ที่ถูกต้องในเครื่องยังเป็นเพียงไฟล์ในเครื่อง
SKU.md คือชั้นข้อมูลสำหรับการค้นพบสินค้าและความรู้เกี่ยวกับสินค้าที่มีเสถียรภาพซึ่งผู้ค้าจัดโฮสต์เอง โดยช่วยให้เอเจนต์ค้นพบสินค้า เข้าใจข้อเท็จจริงที่มีแหล่งอ้างอิง และรู้ว่าควรตรวจสอบข้อมูลการค้าแบบปัจจุบันซ้ำที่ใด ทั้งนี้ SKU.md ไม่ใช่โปรโตคอล Checkout ใหม่
เตรียมแหล่งข้อมูลขั้นต่ำที่ซื่อตรง
| ข้อมูลเข้า | ยอมรับ | ปฏิเสธหรือรอ |
|---|---|---|
| ตัวตนผู้ค้า | ชื่อสาธารณะและต้นทางที่เสถียร | นิติบุคคลที่คาดเดา |
| จุดเข้า Catalog | URL บนต้นทางเดียวกันที่มีจริง | หน้าผู้ดูแลแบบส่วนตัว |
| ความรู้ | ข้อความที่ทบทวนแล้วพร้อมแหล่ง | ข้อความโฆษณาที่ยกระดับอัตโนมัติ |
| ข้อเสนอ | ข้อสังเกตมีเวลาหรือจุดตรวจปัจจุบัน | คำสัญญาราคาไม่จำกัดเวลา |
Variant ทุกตัวใน v0.10 ต้องมี sku ของผู้ค้าที่ไม่ว่าง ห้ามประดิษฐ์ค่าและห้ามใช้รหัสต้นทางอื่นแทน
สร้างและตรวจในเครื่อง
เริ่มด้วยมานิเฟสต์ Catalog ที่รากและ manifest-basic ตรวจสคีมา URL หลัก ลิงก์เอกสารแม่ ตัวตนระหว่างข้อมูลส่วนหัวกับเนื้อหา และข้อเท็จจริงที่มีหลักฐาน การผ่าน offline_document ยืนยันโครงสร้างในเครื่องเท่านั้น ไม่ได้ยืนยันการส่งมอบต่อสาธารณะ
ส่งทรัพยากรรากอย่างตรงไปตรงมา
GET https://example.com/sku.md ต้องตอบ HTTP 200 โดยตรง ไม่เปลี่ยนเส้นทาง ใช้ MIME text/markdown และส่งไบต์ที่คาดไว้ หน้า HTML เพื่อความเข้ากันได้ การตอบกลับด้วยหน้าอื่นแทนหรือ 301 ไม่ผ่านสัญญาการเผยแพร่แบบเคร่งครัด ต้องตรวจ CDN และแคชที่ URL จริงด้วย
ตรวจทรัพยากรและกราฟ
| ขอบเขต | สิ่งที่พิสูจน์ | สิ่งที่ไม่พิสูจน์ |
|---|---|---|
offline_document |
โครงสร้างและความหมายในเครื่อง | การส่งสาธารณะ |
published_resource |
ทรัพยากรออนไลน์หนึ่งรายการ | กราฟทั้งหมด |
document_graph |
ความสัมพันธ์ระหว่างเอกสารแม่กับเอกสารลูกที่เข้าถึงได้ | การยอมรับหรืออันดับภายนอก |
เพิ่มวิธีค้นพบผ่าน llms.txt, agents.md, Product JSON-LD หรือ MCP เมื่อช่องทางนั้นมีอยู่จริง เฝ้าดูความผิดพลาด และตรวจซ้ำหลังเปลี่ยนแพลตฟอร์ม เส้นทาง CDN หรือเอกสาร โดยคง /sku.md เป็น URL หลักที่ตรวจได้ ดูลำดับโดยละเอียดใน คู่มือผู้เผยแพร่
อ่านเพิ่มเติม
ทำความเข้าใจ ข้อมูลคงทนกับข้อมูลปัจจุบัน และ ข้อจำกัดแต่ละแพลตฟอร์ม