เวอร์ชัน Markdown สำหรับเอเจนต์ใช้งานไม่ได้

คำตอบสั้น

หน้านี้เสนอเวอร์ชัน Markdown ให้เอเจนต์ ผ่านคำตอบของ Accept: text/markdown หรือ <link rel="alternate" type="text/markdown"> แต่เวอร์ชันนั้นส่งข้อผิดพลาด เนื้อหาว่าง หรือหน้า HTML กลับมา เอเจนต์ที่ขอจึงไม่ได้อะไรที่ใช้ได้เลย

agent.markdown_broken · ลำดับความสำคัญ: P2

หมายความว่าอย่างไร

หน้านี้เสนอ Markdown ให้เอเจนต์ (เป็นคำตอบของ Accept: text/markdown หรือเป็นสำเนาที่ลิงก์ไว้) แต่สิ่งที่ได้กลับมาคือข้อผิดพลาด เนื้อหาว่าง หรือหน้า HTML

ทำไมจึงสำคัญต่อการค้นหาด้วย AI

เอเจนต์ที่เห็นลิงก์ Markdown หรือได้คำตอบเป็น text/markdown จะเชื่อถือสิ่งนั้น และอาจไม่ย้อนกลับไปใช้ HTML สำเนาที่เสียจึงแย่กว่าไม่มีเลย เพราะเอเจนต์จะล้มเหลว หรืออ่านหน้าข้อผิดพลาดเป็นเนื้อหาของคุณ

ปัญหานี้มักเกิดหลังย้ายหรือสร้างไซต์ใหม่ เช่น ไม่ได้ deploy ไฟล์ .md กฎ rewrite ชี้ไปยังพาธเก่า หรือ middleware ติดป้าย text/markdown ให้กับ HTML

วิธีแก้ไข

  1. เปิด URL จากหลักฐาน แล้วดูสถานะ Content-Type และเนื้อหา
  2. หากสำเนาหายไป ให้ deploy ใหม่ หรือลบแท็ก <link rel="alternate" type="text/markdown"> และเฮดเดอร์ Link ที่ชี้ไปยังสำเนานั้น
  3. หากคำตอบเป็น HTML หรือว่างเปล่า ให้แก้การแปลงให้ส่งข้อความของหน้ากลับเป็น Markdown พร้อม Content-Type: text/markdown
  4. กด "ตรวจสอบอีกครั้ง" ในรายงานของหน้าเพื่อยืนยันผล

ตัวอย่าง

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept

วิธียืนยันว่าแก้ได้ผล

หลังจากแก้ไขแล้ว กด "ตรวจสอบอีกครั้ง" ในรายงาน รายงานจะแสดงสิ่งที่แก้แล้วและคะแนนที่เปลี่ยนไป

ตรวจสอบหน้าของฉัน →

คู่มือที่เกี่ยวข้อง

ข้อค้นพบทั้งหมดและวิธีคิดคะแนน