Δεν υπάρχει έκδοση Markdown για πράκτορες AI
Σε αίτημα για τη σελίδα με Accept: text/markdown ο server έστειλε HTML, και η σελίδα δεν παραπέμπει σε αντίγραφο Markdown. Οι πράκτορες AI διαβάζουν τότε όλο το HTML, μαζί με μενού, υποσέλιδα και scripts. Μια έκδοση Markdown είναι προαιρετική: πρόκειται για νέα σύμβαση, γι' αυτό είναι P3.
Τι σημαίνει
Σε αίτημα με Accept: text/markdown η σελίδα απάντησε με HTML και δεν παραπέμπει σε αντίγραφο Markdown (<link rel="alternate" type="text/markdown">). Οι πράκτορες διαβάζουν τότε όλο το HTML, μαζί με μενού και scripts. Προαιρετικό: το Markdown για πράκτορες είναι νέα σύμβαση, όχι πρότυπο.
Γιατί έχει σημασία για την αναζήτηση AI
Οι πράκτορες που περιηγούνται για λογαριασμό ενός χρήστη (και τα εργαλεία που φορτώνουν σελίδες στο context ενός μοντέλου) δουλεύουν με κείμενο, όχι με διάταξη. Μια καθαρή έκδοση Markdown είναι αρκετές φορές μικρότερη από το HTML και κρατά τους τίτλους, τις λίστες και τους συνδέσμους που μετράνε. Ορισμένα CDN και frameworks απαντούν ήδη στο Accept: text/markdown με τέτοια έκδοση, και το llmstxt.org προτείνει ένα αντίγραφο .md δίπλα σε κάθε σελίδα.
Χωρίς αυτήν δεν χαλάει τίποτα: οι crawlers εξακολουθούν να διαβάζουν το HTML. Είναι μια φθηνή βελτίωση αφού διορθωθούν τα ευρήματα πρόσβασης, robots.txt και περιεχομένου.
Πώς να το διορθώσετε
- Διαλέξτε έναν τρόπο να σερβίρετε Markdown: απαντήστε στο
Accept: text/markdownστο ίδιο URL της σελίδας ή δημοσιεύστε ένα αντίγραφο όπως/guide/index.md. - Σε CDN, ενεργοποιήστε τη μετατροπή σε Markdown για πράκτορες, αν υπάρχει. Σε framework, προσθέστε middleware που επιστρέφει την έκδοση Markdown όταν η κεφαλίδα
Acceptζητάtext/markdown. - Στείλτε
Content-Type: text/markdown; charset=utf-8και, όταν το URL είναι ίδιο με της σελίδας HTML,Vary: Accept. - Συνδέστε το αντίγραφο από το head του HTML με
<link rel="alternate" type="text/markdown">, ώστε να το βρίσκουν και οι πράκτορες που δεν κάνουν διαπραγμάτευση περιεχομένου. - Πατήστε «Έλεγχος ξανά» στην αναφορά της σελίδας για να επιβεβαιώσετε το αποτέλεσμα.
Παράδειγμα
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept Πώς επιβεβαιώνετε τη διόρθωση
Μετά την αλλαγή, πατήστε «Έλεγχος ξανά» στην αναφορά: θα δείτε τι διορθώθηκε και πώς άλλαξε η βαθμολογία.