Kernproblem erkannt
- KI-Agenten benötigen im Gegensatz zu Menschen CSS, clientseitiges JS und Bilder überhaupt nicht
- Diese Elemente verschwenden nur Tokens und liefern kaum tatsächlich nützliche Informationen
- Was Agenten brauchen, ist lediglich sauberer, strukturierter Text
Vercels Lösung
- Nutzung des HTTP-Mechanismus zur Inhaltsaushandlung (Content Negotiation)
- Unter derselben URL wird je nach Client-Anfrage ein anderes Format zurückgegeben
- Menschen (Browser) → vollständiges HTML- + CSS- + JS-Erlebnis
- KI-Agenten → Markdown
- Implementierung ohne separate Website oder duplizierte Inhalte
So funktioniert es (auf Basis des Accept-Headers)
- Beispielhafter Header, den ein Agent sendet
Accept: text/markdown, text/html, */*- → gibt an, dass Markdown am stärksten bevorzugt wird
- Vercel-Middleware prüft den Accept-Header
- Bei Präferenz für Markdown → Weiterleitung an einen Next.js-Route-Handler
- Contentful-Rich-Text-Inhalte werden in Markdown umgewandelt und als Antwort zurückgegeben
- Code-Blöcke: Marker für Syntax-Highlighting bleiben erhalten
- Überschriften: Hierarchie bleibt bestehen
- Links: bleiben unverändert
Wirkung und Kennzahlen
- Typischer Blogbeitrag
- HTML-Version: etwa 500 KB
- Markdown-Version: etwa 2 KB
- Reduktionsrate: 99,6 %
- Vorteile
- Maximale Effizienz beim Token-Budget → Fokus auf echte Informationen statt auf Markup
- Mehr Inhalte pro Anfrage verarbeitbar
- Schnellere Ausführung + geringere Wahrscheinlichkeit, Token-Limits zu erreichen
Technische Wartbarkeit
- Nutzung von remote cache in Next.js 16 + gemeinsamem Slug
- Bei Content-Updates in Contentful werden HTML- und Markdown-Version gleichzeitig aktualisiert → Synchronisierung bleibt erhalten
Unterstützung für Agenten-Navigation
- Bereitstellung einer dedizierten Sitemap im Markdown-Format
- Enthaltene Informationen: Veröffentlichungsdatum, Inhaltstyp, direkte Links zu HTML- und Markdown-Version usw.
- Agenten können die komplette Inhaltskarte der verfügbaren Inhalte erfassen → optimale Formatwahl wird einfacher
Bedeutung im Fazit
- Anerkennt, dass Menschen und KI das Web grundlegend unterschiedlich konsumieren
- Ein praktisches Beispiel dafür, jedem Client ein optimiertes Erlebnis bereitzustellen
- Ein wichtiger Ausgangspunkt für ein Web für Menschen und KI gleichermaßen
Noch keine Kommentare.