Akamai (BYOCDN)

この設定により、エージェント型トラフィック(AI ボットおよびLLM ユーザーエージェントからのリクエスト)がEdge Optimize バックエンドサービス(live.edgeoptimize.net)にルーティングされます。 通常どおり、人間の訪問者とSEO ボットは、元のページから引き続き提供されます。 設定をテストするには、設定が完了した後、応答でヘッダーx-edgeoptimize-request-idを探します。

前提条件

Akamai プロパティマネージャールールを設定する前に、次のことを確認してください。

  • ドメインのAkamai Property Managerへのアクセス。
  • LLM Optimizer UIから取得したEdge Optimize API キー。 手順については、API キーの取得を参照してください。
  • (オプション)ステージング ルーティングをテストするには、​ ステージング API キーを参照してください。

設定

次のAkamai Property Manager ルールは、エージェント型HTML ページトラフィックをEdge Optimizeにルーティングします。 設定には、次の手順が含まれます。

1. ルーティング条件の設定(User-AgentとHTMLのトラフィックの一致)

次のユーザーエージェントのルーティングを設定します。

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
NOTE
Edgeで最適化のルーティングルールをエージェント型HTML ページトラフィックにのみ適用します。 一般的な設定では、File Extension​などのリクエストサイドの条件を使用して、拡張機能のないページ URLにhtmlEMPTY_STRINGを一致させることができます。 サイトが他のURL パターンからHTMLを提供している場合、またはAPI エンドポイントなどの拡張なし非ページルートを含んでいる場合は、パスベースの条件を追加してルールを絞り込みます。

ルーティング条件を設定

2. オリジンと SSL の動作を設定

オリジンをlive.edgeoptimize.netに設定し、SANを*.edgeoptimize.netに一致

NOTE
Edgeで最適化ルールを追加した後にプロパティのアクティベーションが失敗した場合は、ルールでデフォルトのルールとは異なるOrigin Server SSL検証モードが使用されているかどうかを確認します。 その場合は、デフォルトのルールに一致するように、「Edgeで最適化」ルールを更新します。 例えば、デフォルトのルールで​ プラットフォーム設定 ​を使用している場合は、ここでも​ プラットフォーム設定 ​を使用します。 必要な設定を使用できない場合は、Akamai サポートにお問い合わせください。

オリジンと SSL の動作を設定

3. キャッシュキー変数を設定

キャッシュキー変数PMUSER_EDGE_OPTIMIZE_CACHE_KEYLLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}に設定します

キャッシュキー変数を設定

4. キャッシュルール

キャッシュルール

5. 受信リクエストヘッダーを変更

次の受信リクエストヘッダーを設定します。
LLMOから取得したAPI キーへのx-edgeoptimize-api-key
x-edgeoptimize-config コピー先: LLMCLIENT=TRUE;
x-edgeoptimize-url{{builtin.AK_URL}}

受信リクエストヘッダーを変更

ファイアウォール ルールを使用してEdgeで最適化を許可する(オプション)

CDNでWAFまたはBot Managerを使用している場合:

  • WAFまたはBot Managerで*AdobeEdgeOptimize/1.0* ユーザーエージェントを許可リストに加えるして、Optimize at Edge サービスがオリジンコンテンツを取得できるようにします。

  • ファイアウォールでユーザーエージェント以外の追加の検証が必要な場合は、秘密鍵(例:openssl rand -hex 32)を生成し、次の操作を行います。

    • ルーティングルールのシークレットを他のx-edgeoptimize-* ヘッダーと共にx-edgeoptimize-fetcher-keyを追加します。
    • WAFまたはBot Manager ルールを追加して、x-edgeoptimize-fetcher-keyが同じシークレットと一致するリクエストを許可します。
  • Edgeで最適化すれば、このヘッダーをそのまま転送できます。ユーザーは鍵のライフサイクル全体を所有しています。

Property Managerでx-edgeoptimize-fetcher-key ヘッダーを設定

NOTE
Akamai Bot Managerで*AdobeEdgeOptimize/1.0* ユーザーエージェントとx-edgeoptimize-fetcher-key ヘッダーも許可リストに加えるします。

6. 受信応答ヘッダーを変更

受信応答ヘッダーを変更

7. キャッシュ ID の変更

キャッシュ ID の変更

8. 送信リクエストヘッダーを変更

x-forwarded-host ヘッダーを{{builtin.AK_HOST}}に設定

送信リクエストヘッダーを変更

9. サイトフェイルオーバー

サイト フェールオーバー設定には、フェールオーバー動作(メインのエッジ最適化ルーティング ルール内で設定)と個別のフェールオーバーテストヘッダールールの2つの部分があります。

9a。 サイト フェールオーバー動作(メインのエッジで最適化ルーティング ルール内)

メインのルーティングルール内で、サイトフェールオーバー動作と高度なXML スニペットを次のように設定します。

IMPORTANT
この手順のXML スニペットには、詳細​動作が必要です。 一部のAkamai環境では、この動作はセルフサービス編集では使用できません。 Advanced オプションが表示されない場合は、Akamai アカウントチームまたはAkamai サポートに連絡して、必要な設定を有効にしてください。

サイトフェイルオーバー

高度なXMLを使用して、値foのリクエストヘッダーx-edgeoptimize-requestを追加します。

<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>

フェイルオーバー動作

9b. フェールオーバーテスト ヘッダー規則(兄弟ルール)

IMPORTANT
EdgeOptimize Failover - Test Header ルールを、ルーティングルールの​兄弟 (同じレベル)として作成します(not)。 Akamai プロパティマネージャールールツリーでは、階層は次のようになります。
code language-none
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
これにより、フェールオーバーテストヘッダールールは、1つだけでなく​all ルーティングルールに対しても評価されます。
また、Edge ルーティングで最適化 ルールが、同じリクエストのオリジン、キャッシュ動作、またはキャッシュ IDを変更する後で一致するルールによって上書きされないようにします。 別の一致するルールがこれらの動作をリセットする場合、Edgeで最適化のルーティングまたはキャッシュが期待どおりに動作しない可能性があります。

リクエストヘッダーx-edgeoptimize-requestの値がfoの場合、送信レスポンスヘッダーx-edgeoptimize-fotrueに設定します。

フェイルオーバールール

サイトフェールオーバーは、Edge Optimizeが4XXまたは5XX エラーを返した場合、リクエストがデフォルトのオリジンに自動的にルーティングされ、エンドユーザーが応答を受け取るようにします。

シナリオ
動作
Edge Optimizeは2XXを返します
最適化された応答がクライアントに提供されます。
Edge Optimizeは4XXまたは5XXを返します
リクエストはデフォルトのオリジンに戻されます。

設定を確認

設定が完了したら、ボットトラフィックがEdge Optimizeにルーティングされ、人間のトラフィックが影響を受けないことを確認します。

1. ボットトラフィックのテスト (最適化する必要があります)

エージェント型ユーザーエージェントを使用してAI ボットリクエストをシミュレートします。

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

応答が成功すると、x-edgeoptimize-request-id ヘッダーが含まれ、リクエストがEdge Optimizeを通じてルーティングされたことが確認されます。

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. 人間のトラフィックをテストします(影響を受けません)

通常のヒューマンブラウザーリクエストをシミュレートします。

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

応答には、not​にx-edgeoptimize-request-id ヘッダーを含める必要があります。 Edgeで最適化を有効にする前に、ページの内容と応答時間を同じにしておく必要があります。

3. 2つのシナリオを区別する方法

ヘッダー
ボットトラフィック(最適化)
人的トラフィック(影響なし)
x-edgeoptimize-request-id
現在 – 一意のリクエスト IDを含む
不在
x-edgeoptimize-fo
フェールオーバーが発生した場合にのみ存在します(値:1
不在

トラフィックルーティングのステータスは、LLM Optimizer UIでも確認できます。 顧客設定​に移動し、CDN設定 タブを選択します。

AI エージェントへの最適化のデプロイ – 完了

利用可能なオポチュニティ、自動最適化ワークフロー、FAQなど、Edgeでの最適化について詳しくは、Edgeでの最適化の概要に戻ります。

recommendation-more-help
llm-optimizer-help-main-toc