Akamai (BYOCDN)

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

先決條件

在設定 Akamai Property Manager 規則之前,請確定您已準備好以下項目:

  • 您網域的 Akamai Property Manager 存取權。
  • 從Edge UI擷取的Adobe Brand Visibility最佳化API金鑰。 相關步驟請參閱檢索 API 金鑰
  • (選用) 若要測試中繼路由,請參閱中繼 API 金鑰

設定選項

有兩種方法可設定Akamai以在Edge最佳化:

選項1:Adobe Brand Visibility中的引導式設定

引導式設定需要在您自己的Akamai帳戶中使用Akamai EdgeGrid API使用者端,並具有​ 屬性管理員(PAPI) — 讀取 — 寫入 ​目標屬性的群組和合約的存取權,以及在Akamai Staging和Production上啟用屬性版本的許可權。 Adobe Brand Visibility僅將這些憑證用於設定,不會儲存它們。

準備Akamai EdgeGrid API使用者端

如果您還沒有合適的API使用者端,請在Akamai控制中心建立一個使用者端:

  1. 開啟​管理>識別與存取
  2. 在​ 使用者和API使用者端 ​上,選取​建立API使用者端
  3. 選取​我自己,然後選取​進階。 將使用者端限製為​屬性管理員(PAPI) — READ-WRITE,僅保留目標群組和合約,並確認在中繼和生產環境上啟用的許可權。
  4. 建立使用者端,然後立即下載或複製認證檔案。 您需要使用者端密碼、API主機、存取權杖和使用者端權杖。 使用者端密碼只會顯示一次。

在Akamai Identity and Access Management中建立API使用者端

將API使用者端限製為屬性管理員(PAPI)讀寫

NOTE
將認證檔案儲存在組織核准的密碼管理員中。 Adobe Brand Visibility不會儲存這些認證;這些認證會保留在您的瀏覽器工作階段中,並在您關閉部署儀表板時清除。

部署路由設定

  1. 針對您要設定的URL開啟​CDN設定
  2. 在​ 將最佳化部署到AI代理程式 ​中,視需要選取​啟用
  3. 選取​ 在Akamai (Beta) ​中部署路由。
  4. 貼上EdgeGrid認證檔案,或分別輸入使用者端密碼、API主機、存取權杖和使用者端權杖,然後連線。
  5. 選取Akamai屬性,檢閱提議的變更,然後依照引導式步驟進行部署。 啟用新屬性版本前請先取得核准。

從Adobe Brand Visibility 🔗 在Akamai中部署路由

NOTE
引導式設定可作為合格帳戶的搶先存取功能使用。 如需入門協助,請連絡您的Adobe客戶團隊或傳送電子郵件至llmo-at-edge@adobe.com

選項 2:手動設定

使用下列步驟手動設定Akamai屬性管理員規則。

設定

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

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

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

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
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}}

修改傳入要求標頭

透過防火牆規則允許邊緣最佳化 (選用)

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

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

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

    • 將帶有密碼的x-edgeoptimize-fetcher-key新增到路由規則中與其他x-edgeoptimize-*標頭一起。
    • 新增WAF或機器人管理員規則以允許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. 網站容錯移轉

網站容錯移轉設定包含兩個部分:主要邊緣最佳化路由規則內的容錯移轉行為,以及當發生遞補時新增回應標頭的同級規則。

9a. 設定網站容錯移轉行為

在主要邊緣最佳化路由規則中,建立一個名為「網站容錯移轉行為」的子規則。 將其設定為「符合任何」並新增這些條件:

  • 回應狀態代碼​在 400599 的範圍內。
  • 來源逾時​為 Yes

網站容錯移轉

設定網站容錯移轉行為

9b. 設定容錯移轉回應標頭規則

IMPORTANT
建立 EdgeOptimize 容錯移轉,測試標頭​規則作為路由規則的​同級 (位於相同層級) 規則,而​ 不是 ​以巢狀方式置於路由規則內。 在 Akamai Property Manager 規則樹狀結構中,階層應該如下所示:
code language-none
▼ Optimize at Edge                         ← parent rule group
      ▼ Optimize at Edge Routing               ← routing child
          Site Failover Behavior                 ← nested child
      EdgeOptimize Failover - Test Header      ← sibling of routing child
當 Akamai 針對原始主機名稱重新建議該失敗的請求時,會評估同級規則。 路由規則的 API 金鑰條件可防止將該請求再次傳送至 Edge Optimize。
同時請確保​ 邊緣最佳化路由 ​規則不會被任何後續的相符規則覆寫,以免後續規則變更相同請求的來源、快取行為或快取 ID。 如果另一個相符的規則重設這些行為,邊緣最佳化路由或快取可能無法如預期運作。

設定容錯移轉回應標頭規則

網站容錯移轉可確保若 Edge Optimize 傳回錯誤或已逾時,Akamai 會針對您的原始主機名稱重新建立請求,以便訪客仍可收到網站的正常回應。

情境
行為
邊緣最佳化傳回 2XX3XX
提供最佳化的回應。 x-edgeoptimize-request-id 存在。
Edge Optimize 傳回 4XX5XX,或來源逾時
系統針對原始主機名稱重新建立該請求。 回應包含 x-edgeoptimize-fo: true

驗證設定

完成設定後,請確認機器人流量會路由至 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
唯有發生容錯移轉時存在 (值:true)
不存在

流量路由的狀態也可以在Adobe Brand Visibility UI中檢視。 瀏覽至​ 客戶組態 ​並選取​ CDN組態 ​標籤。

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

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

recommendation-more-help
brand-visibility-help-main-toc