エージェント時代のWeb運用設計, ドキュメント契約・クローラールーティング・観測指標の実務

CloudflareのAgents Weekが示した変化は明確です。これからのWebは、人間ユーザーだけでなくAIエージェントが主要利用者になる前提で設計しなければなりません。従来の「Bot対策」だけでは、古い手順の誤参照やAPI誤利用を防げません。

ページではなく契約を整える

エージェント向け運用で重要なのは、読みやすさだけでなく参照の安定性です。

• 重要手順ページの正規URL固定
• バージョン境界を示すメタデータ
• 廃止手順と移行先の明示
• 期待結果がわかる再現可能な例

この契約がないと、エージェントは古いコピーや断片情報を正解として扱います。

ドキュメントは2面構成にする

同一情報を次の2面で配信します。

1. Human Plane: 背景、設計意図、導入文脈
2. Agent Plane: 入力制約、手順、エラー表、禁止条件

両者を混在させると、人間には冗長、機械には曖昧な構成になりがちです。

意図ベースでクローラー制御する

robots.txtだけでは制御が粗すぎます。検証済みクローラーと未知クローラーを分けて扱う必要があります。

• 検証済み: 正規ドキュメントに誘導
• 廃止ページ: 移行先に自動リダイレクト
• 未知かつ高頻度: レート制御
• 機密Runbook: 収集禁止

この分離で、誤学習とサポート負債を減らせます。

観測はPV中心から成功率中心へ

追跡すべき指標:

• canonical hit ratio
• deprecated page参照率
• agent起因API失敗率
• ドキュメント起因問い合わせ率

アクセス量が多いだけでは価値になりません。正しく実行できたかを測る必要があります。

セキュリティレビュー範囲を拡張する

機械可読化で漏れやすい情報があります。

• 内部エンドポイント規則
• 環境依存の秘密値
• 緩すぎるCORS設定

エージェント向け情報公開は、公開APIと同じ厳密さでレビューすべきです。

まとめ

Agent Readyは宣伝用ラベルではなく運用能力です。ドキュメント契約、ルーティング制御、観測指標を一体で管理できる組織ほど、エージェント時代に強くなります。