文档LLM Optimizer

Akamai (BYOCDN)

最近更新： 2026年4月8日

创建对象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

此配置将代理式流量（来自 AI 机器人和 LLM 用户代理的请求）路由到 Edge Optimize 后端服务（live.edgeoptimize.net）。 人类访客和 SEO 机器人仍将照常从您的源站获得响应。 完成设置后，可在响应中查找头部 x-edgeoptimize-request-id 以测试配置是否成功。

先决条件

在设置Akamai属性管理器规则之前，请确保您具有：

  • 可以为您的域访问 Akamai 属性管理器。
  • 具有从 LLM Optimizer UI 检索到的 Edge Optimize API 密钥。 有关步骤，请参阅检索您的 API 密钥。
  • （可选）要测试暂存路由，请参阅暂存 API 密钥。

配置

以下 Akamai 属性管理器规则可将代理式 HTML 页面流量路由至 Edge Optimize。 该配置包括以下步骤：

1. 设置路由条件（用户-代理和 HTML 流量匹配）

为以下用户代理设置路由：

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
仅将 Optimize at Edge 路由规则应用于代理式 HTML 页面流量。 常见的设置是使用请求端条件（如​文件扩展名）来匹配无扩展名页面 URL 的 html 和 EMPTY_STRING。 如果您的网站通过其他 URL 模式提供 HTML，或包含无扩展名的非页面路由（如 API 端点），请通过添加基于路径的条件来优化该规则。

设置路由条件

2. 设置源站和 SSL 行为

将源站设置为 live.edgeoptimize.net，将 SAN 与 *.edgeoptimize.net 匹配

NOTE
如果添加 Optimize at Edge 规则后属性激活失败，请检查该规则是否使用了与默认规则不同的源服务器 SSL 验证模式。 如果是这样，请更新 Optimize at Edge 规则，以匹配默认规则。 例如，如果默认规则使用​平台设置，那么这个规则中也应使用​平台设置。 如果您无法使用所需的设置，请联系 Akamai 支持部门。

设置源站和 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}}

修改传入请求标头

允许 Optimize at 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. 网站故障转移

“站点故障转移”配置包含两个部分：主“在Edge中优化”路由规则内的故障转移行为以及在发生回退时添加响应标头的同级规则。

9a。 配置站点故障转移行为

在主Optimize at Edge路由规则内，创建一个名为​ 站点故障转移行为 ​的子规则。 将其设置为​ 匹配任意 ​并添加这些条件：

  • 响应状态代码​在400到599的范围内。
  • 源超时​为Yes。

网站故障转移

配置站点故障转移行为

9b。 配置故障转移响应标头规则

IMPORTANT
将 EdgeOptimize 故障转移测试头​规则作为路由规则的​同级（在同一级别）创建——而不是​嵌套在路由规则中。 在 Akamai 属性管理器规则树中，层级结构应如下所示：
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。
此外，应确保 Optimize at Edge 路由​规则不会被任何后来匹配的，会更改源站、缓存行为或相同请求的缓存 ID 的规则所覆盖。 如果其他匹配规则重置了这些行为，Optimize at Edge 路由或缓存可能就无法按预期工作。

配置故障转移响应标头规则

站点故障转移可确保当Edge Optimize返回错误或超时时，Akamai会为原始主机名重新创建请求，以便访客仍可收到站点的正常响应。

场景
行为
Edge Optimize 返回 2XX 或 3XX
提供优化的响应。 x-edgeoptimize-request-id存在。
Edge Optimize返回4XX-5XX，或源超时
将为原始主机名重新创建请求。 响应包括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 头部。 页面内容和响应时间应保持与启用 Optimize at Edge 之前时完全相同。

3. 如何区分这两种场景

页眉
机器人流量（已优化）
人类流量（不受影响）
x-edgeoptimize-request-id
存在——包含唯一的请求 ID
不存在
x-edgeoptimize-fo
仅在发生故障转移的情况下存在（值：true）
不存在

也可以在 LLM Optimizer UI 中查看流量路由的状态。 导航到​ 客户配置 ​并选择​ CDN配置 ​选项卡。

将优化部署到 AI 代理——已完成

要进一步了解Edge优化，包括可用的机会、自动优化工作流和常见问题，请返回Edge优化概述。

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