文档LLM Optimizer

Akamai (BYOCDN)

最近更新： 2026年4月8日

此配置将代理式流量（来自 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*
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}}

修改传入请求标头

允许通过防火墙规则在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. 网站故障转移

网站故障转移配置包含两个部分：故障转移行为（在 optimize-at-edge 主路由规则中配置）和一个单独的故障转移测试头规则。

9a。 网站故障转移行为（在 optimize-at-edge 主路由规则中）

在主路由规则中，按如下方式配置网站故障转移行为和高级 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 属性管理器规则树中，层级结构应如下所示：
code language-none 
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
这可确保故障转移测试头规则会评估​ 所有 ​路由规则，而不仅仅评估一个。
此外，应确保 Optimize at Edge 路由​规则不会被任何后来匹配的，会更改源站、缓存行为或相同请求的缓存 ID 的规则所覆盖。 如果其他匹配规则重置了这些行为，Optimize at Edge 路由或缓存可能就无法按预期工作。

如果请求头的 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 头部。 页面内容和响应时间应保持与启用 Optimize at Edge 之前时完全相同。

3. 如何区分这两种场景

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

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

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

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

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