文档LLM Optimizer

Akamai (BYOCDN)

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

此配置将代理流量（来自AI机器人和LLM用户代理的请求）路由到Edge优化后端服务(live.edgeoptimize.net)。 与往常一样，我们仍将从您的源头为人类访客和SEO机器人提供服务。 要测试配置，请在设置完成后查找响应中的标头x-edgeoptimize-request-id。

先决条件

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

  • 访问域的Akamai资产管理器。
  • 已完成LLM Optimizer载入流程。
  • 已完成到LLM Optimizer的CDN日志转发。
  • 从Edge UI检索到LLM Optimizer优化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匹配

设置源站和 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。 站点故障转移行为（在主要边缘优化路由规则内）

在主路由规则内，按如下方式配置“站点故障转移”行为和“高级XML”代码片段：

网站故障转移

通过高级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
这可确保故障转移测试标头规则评估​ 所有 ​路由规则，而不仅仅评估一个。

如果请求标头x-edgeoptimize-request值为fo，则将传出响应标头x-edgeoptimize-fo设置为true。

故障转移规则

站点故障转移可确保，如果Edge Optimize返回4XX或5XX错误，请求将自动路由回默认来源，以便最终用户仍会收到响应。

场景
行为
Edge优化返回2XX
优化的响应会提供给客户端。
Edge优化返回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优化路由的：

< 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标头。 在Edge中启用优化之前，页面内容和响应时间应保持相同。

3. 如何区分这两种方案

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

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

启用了路由的AI流量路由状态

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

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