
2026/08/27 4:45
AI エージェントに Accept Header を設定して Markdown を提供する
RSS: https://news.ycombinator.com/rss
要約▶
日本語訳:
この文章は、Markdown が広告や DOM ラッパーのような不要なウェブレイアウト要素をバイパスすることを可能にする特殊なコンテンツフォーマットであるとして論じています。これらの非必須部分を取り除くことで、トークン使用量が大幅に削減され、検索パフォーマンスが向上します。重要なのは、モデルが処理を開始する前にサーバーが送信する生データが少なくなるため、レイテンシが減少し、最初のトークンの出力が早まることです。このシステムは、クライアントが
Accept: text/markdown ヘッダーを使用して Markdown を要求するコンテンツネゴシエーションという特定の技術メカニズムに依存しています。正しい処理を確保するためには、サーバーは非対応のフォーマットに対して 406 ステータスを返し、q-values を尊重し、Vary: Accept ヘッダーを含める必要があります。開発者のセットアップを簡素化するために Cloudflare が提供する設定ゼロオプションにより、実装は簡略化されています。さらに、このセッティングをサポートする既存のテクノロジーがあり、Nginx、Caddy、WordPress、Discourse、Laravel、Rails、Next.js、Astro などの多様なフレームワークと言語を含む広範な環境へのコピー&ペーストレシピを提供しています。基本的な 3 ステッププロセスをカバーするクイックスタートガイドが利用でき、キャッシュ戦略のような詳細については実装ガイドで対応しています。また、ブラウジングやフェッチ中に Accept: text/markdown ヘッダーを送信する AI エージェントを特定する AI エージェントサポートマトリックスも用意されています。本文
Markdown サービングによる AI エージェント対応のメリットと導入ガイド
既存のウェブサイトに対し、AI クライアントが直接コンテンツを読み込める「Markdown バリアント」を提供することで、以下のような劇的な改善が期待できます。
1.主なメリット
トークンの削減
- 不要なコードを排除: ナビゲーション、スタイル、スクリプト、レイアウトなどの markup は削除されます。
- コンテキストの最適化: エージェントのコンテキストはドキュメントの内容そのものに費やされ、DOM 構造に使用される量が減ります。
検索精度向上(シグナル対ノイズ比)
- ノイズ除去: RAG(リトリバル_augmented_generation)パイプラインでの埋め込み対象となる以下の要素をテキストから排除します。
- 広告
- 関連コンテンツのカラム
- モーダルオーバーレイ
レスポンスタイムの改善(遅延の低減)
- 生成速度向上: 最初のトークンまでの応答時間が短縮されます。
- データ量削減: 取得すべきデータ量が少なくなり、パース処理も軽くなります。
- 思考開始までの高速化: コンテキストウィンドウに格納する必要があるデータ量が減少し、モデルが思考を開始するまでの待ち時間が減ります。
2.AI エージェント対応の要件
ウェブサイトが「AI 準備型」と判定されるためには、以下の実装が必要です。
- コンテンツタイプ指定
をサポートするレスポンスを提供します。Accept: text/markdown
- ヘッダー設定
ヘッダーを適切に設定します。Vary: Accept
- エラーハンドリング
- マークダウン対応のないリクエストに対して、HTTP 406 ステータスコードを返します。
- Q-values の扱い
- Q-values を正しく解釈・処理します。
確認方法
当社のエッジから
Accept: text/markdown を指定して URL にアクセスし、オリジンが適切なレスポンス(Markdown コンテンツまたは 406 エラー)を返すか検証できます。
3.導入の次のステップ
より詳細な実装には以下のリソースをご利用ください。
| カテゴリ | 概要 |
|---|---|
| クイックスタート | 最小限の手順で動作させるセットアップ (3 つのステップ、1 つのサーバー、2 つのレスポンス) |
| ガイド | 正確な実装方法の解説 ・ ヘッダーと q-values の扱い・406 ステータスコードの返却 ・キャッシュ戦略 ・Cloudflare を使わないショートカット手法 |
| レシピ | コピペ可能な設定例(フレームワーク別) Nginx, Caddy, WordPress, Discourse, Laravel, Rails, Cloudflare Workers, Next.js, Astro, Apache, SvelteKit, Nuxt/Nitro, Express, Go, Django など対応 |
| ステータス | 対応状況の確認 AI エージェント対応マトリックス(browse/fetch ツール別) |
| リファレンス | 規格と出典情報 RFC 9110, RFC 7763, メディアタイプ仕様 |