文件LLM Optimizer

Akamai (BYOCDN)

最後更新： 2026年4月8日

此設定會將代理式流量 (來自 AI 機器人和 LLM 使用者代理的要求) 路由至 Edge Optimize 後端服務 (live.edgeoptimize.net)。 真人訪客和 SEO 機器人仍照常由您的來源伺服器提供服務。 若要測試設定，在完成設定之後，請於回應中尋找 x-edgeoptimize-request-id 標頭。

先決條件

設定 Akamai Property Manager 規則之前，請確定您具備以下條件：

  • 您網域的 Akamai Property Manager 存取權。
  • 已完成 LLM Optimizer 上線流程。
  • 已經將內容傳遞網路記錄轉送至 LLM Optimizer。
  • 從 LLM Optimizer 使用者介面擷取的 Edge Optimize API 金鑰。
  • （選擇性）若要測試暫存路由，請參閱此頁面結尾的​選擇性：測試暫存主機名稱上的路由。

擷取生產Edge最佳化API金鑰的步驟：

  1. 在 LLM Optimizer 中，開啟「客戶設定」並選取「內容傳遞網路設定」標籤。

    導覽至客戶設定

  2. 找出「將最佳化部署到 AI 代理」區段。 勾選「啟用最佳化引擎」核取方塊。

    將最佳化部署到 AI 代理：待處理

  3. 在確認對話框中，選取「啟用」。

    啟用最佳化引擎確認對話框

  4. 選取​檢視詳細資料。 在​ 部署最佳化詳細資料 ​對話方塊中，複製​生產API金鑰 （使用欄位旁的​複製）。

    部署最佳化詳細資料中的 生產API金鑰

    note
    NOTE
    對話方塊可能會顯示設定未完成。 在驗證路由之前，這是預期中的情形 — 您仍可複製API金鑰，讓您的IT或CDN團隊完成設定。

此外，如果您對於上述步驟需要任何協助，請聯絡您的 Adobe 帳戶團隊或 llmo-at-edge@adobe.com。

設定

下列 Akamai Property Manager 規則將代理式 HTML 頁面流量路由至 Edge Optimize。 設定包含以下步驟：

1. 設定路由準則 (使用者 AI 代理與 HTML 流量比對)

設定下列使用者 AI 代理的路由：

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
NOTE
僅對代理式 HTML 頁面流量套用邊緣架構最佳化路由規則。 常見的設定是使用​ 副檔名 ​等要求端準則來比對 html，以及針對無副檔名頁面 URL 比對 EMPTY_STRING。 如果您的網站透過其他 URL 模式提供 HTML，或包含如 API 端點等無副檔名的非頁面路由，請使用其他路徑準則來精確調整此規則。

設定路由準則

2. 設定來源和 SSL 行為

將來源設為 live.edgeoptimize.net，而「對照 SAN 至」設為 *.edgeoptimize.net

NOTE
如果新增邊緣最佳化規則後屬性啟用失敗，請檢查該規則是否使用與預設規則不同的原始伺服器 SSL 驗證模式。 若確實不同，請更新邊緣最佳化規則使其符合預設規則。 例如，若預設規則使用​平台設定，此處也應使用​平台設定。 如果您無法使用必要的設定，請聯絡 Akamai 支援。

Set 來源和 SSL 行為

3. 設定快取金鑰變數

將快取鍵變數 PMUSER_EDGE_OPTIMIZE_CACHE_KEY 設為 LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

設定快取金鑰變數

4. 快取規則

快取規則

5. 修改傳入要求標頭

設定以下傳入要求標頭：
x-edgeoptimize-api-key 設定為從 LLMO 擷取的 API 金鑰
x-edgeoptimize-config 設定為 LLMCLIENT=TRUE;
x-edgeoptimize-url 設定為 {{builtin.AK_URL}}

修改傳入要求標頭

允許透過防火牆規則在Edge最佳化（選用）

如果您的CDN使用WAF或機器人管理員：

  • 允許列出WAF或機器人管理員中的*AdobeEdgeOptimize/1.0*使用者代理程式，讓Edge最佳化服務可以擷取您的來源內容。

  • 如果您的防火牆需要使用者代理程式以外的其他驗證，請產生密碼（例如，openssl rand -hex 32）並：

    • 將帶有密碼的x-edgeoptimize-fetcher-key新增到路由規則中與其他x-edgeoptimize-*標頭一起。
    • 新增WAF或機器人管理員規則以允許x-edgeoptimize-fetcher-key符合相同密碼的請求。

  • 在Edge最佳化會依原樣轉送此標題 — 您擁有完整的金鑰生命週期。

在屬性管理員中設定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. 網站容錯移轉

網站容錯移轉設定包含兩個部分：容錯移轉行為 (於主要的邊緣最佳化路由規則內設定)，和個別的容錯移轉測試標頭規則。

9a. 網站容錯移轉行為 (在主要的邊緣最佳化路由規則內)

在主要路由規則內，設定網站容錯移轉行為和進階 XML 程式碼片段，如下所示：

IMPORTANT
此步驟中的 XML 程式碼片段需要​ 進階 ​行為。 在某些 Akamai 環境中，此行為不適用自助式編輯。 如果沒有看到​ 進階 ​選項，請聯絡您的 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 容錯移轉，測試標頭​規則作為路由規則的​同級 (位於相同層級) 規則，而​ 不是 ​以巢狀方式置於路由規則內。 在 Akamai Property Manager 規則樹狀結構中，階層應該如下所示：
code language-none 
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
這樣能確保容錯移轉測試標頭規則針對​ 所有 ​路由規則，而非單一規則進行評估。
同時請確保​ 邊緣最佳化路由 ​規則不會被任何後續的相符規則覆寫，以免後續規則變更相同請求的來源、快取行為或快取 ID。 如果另一個相符的規則重設這些行為，邊緣最佳化路由或快取可能無法如預期運作。

如果要求標頭 x-edgeoptimize-request 值為 fo，請將傳出回應標頭 x-edgeoptimize-fo 設定為 true。

容錯移轉規則

透過網站容錯移轉，您可以確保如果 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"

回應​ 不應 ​包含 x-edgeoptimize-request-id 標頭。 頁面內容和回應時間應與啟用邊緣最佳化之前維持相同。

3. 如何區分這兩種情境

頁首
機器人流量 (最佳化)
真人流量 (不受影響)
x-edgeoptimize-request-id
存在：包含唯一的要求 ID
不存在
x-edgeoptimize-fo
唯有發生容錯移轉時存在 (值：1)
不存在

您也可以在 LLM Optimizer 使用者介面中確認流量路由的狀態。 瀏覽至​ 客戶組態 ​並選取​ CDN組態 ​標籤。

將最佳化部署到 AI 代理：已完成

選用：測試暫存主機名稱上的路由

若您想在啟用生產製程之前，先在較低的環境中驗證製程，則可設定暫存主機名稱。

需求

  • 暫存主機名稱必須位於與生產環境相同的​ 可登入網域 ​上（例如，當生產環境為https://www.example.com時，https://staging.example.com）。
  • 每個網站只有​ 一個 ​暫存網域。 儲存後，必須聯絡Adobe才能變更。

取得您的暫存API金鑰

  1. 開啟​ 客戶組態 ​並選取​CDN組態。
  2. 在​ 將最佳化部署到AI代理程式 ​下，選取​新增中繼網域 （或如果已設定中繼網域，則選取​中繼網域）。
  3. 輸入包含https://的完整暫存URL並選取​設定網域。
  4. 從確認對話方塊複製​staging API金鑰。

中繼網域API金鑰

使用中繼API金鑰在中繼環境中部署相同的路由規則。

測試暫存機器人流量

請使用您實際的中繼 URL 和路徑取代 https://staging.example.com/page.html。 成功：​回應包含x-edgeoptimize-request-id標頭。

如果您需要協助，請連絡llmo-at-edge@adobe.com。

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

若要進一步瞭解Edge最佳化，包括可用的機會、自動最佳化工作流程和常見問答，請返回Edge最佳化概覽。

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