文档LLM Optimizer

Akamai (BYOCDN)

Last update: Mon Mar 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

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

先决条件

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

  • 可以为您的域访问 Akamai 属性管理器。
  • 完成了 LLM Optimizer 的加入过程。
  • 已将内容传递网络日志转发到 LLM Optimizer。
  • 具有从 LLM Optimizer UI 检索到的 Edge Optimize API 密钥。

检索API密钥的步骤：

  1. 导航到​ 客户配置 ​并选择​ CDN配置 ​选项卡。

    导航到客户配置

  2. 在​ AI流量路由到部署优化 ​下，勾选​ 将优化部署到AI代理 ​复选框。

    将部署优化勾选到AI代理

  3. 复制API密钥，并继续执行下面的路由配置步骤。

    复制API密钥

    note note
    NOTE
    在此阶段，状态可能显示红叉，指示设置尚未完成。 这是正常情况 — 一旦您完成下面的路由配置并且AI机器人流量开始流动，状态将更新为绿色复选标记，确认路由已成功启用。

此外，如果您需要上述步骤的任何帮助，请联系您的Adobe客户团队或llmo-at-edge@adobe.com。

配置

以下 Akamai 属性管理器规则可将 LLM 用户代理路由至 Edge Optimize。 该配置包括以下步骤：

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

为以下用户代理:image.png 设置路由

 *AdobeEdgeOptimize-AI*,
 *ChatGPT-User*,
 *GPTBot*,
 *OAI-SearchBot*,
 *PerplexityBot*,
 *Perplexity-User*

设置路由条件

2. 设置源站和 SSL 行为

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

NOTE
如果添加“在Edge中优化”规则后属性激活失败，请检查该规则是否使用与默认规则不同的源服务器SSL验证模式。 如果是这样，请更新在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}}

修改传入请求标头

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
这可确保故障转移测试头规则会评估​ 所有 ​路由规则，而不仅仅评估一个。
此外，请确保不会将任何后来匹配的规则覆盖​ 在Edge路由中优化 ​规则，这些规则会更改相同请求的来源、缓存行为或缓存ID。 如果其他匹配规则重置这些行为，则“在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 中查看流量路由的状态。 导航至​客户配置，然后选择​ 内容传递网络配置 ​选项卡。

启用了路由情况下的 AI 流量路由状态

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

recommendation-more-help
0dec6bd3-6ccf-44b6-a91b-960cfd8f3798