DocumentaçãoLLM Optimizer

Akamai (BYOCDN)

Última atualização: 15 de abril de 2026

Criado para:

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

Essa configuração roteia o tráfego agêntico (solicitações de bots de IA e agentes de usuário LLM) para o serviço de back-end do Edge Optimize (live.edgeoptimize.net). Visitantes humanos e bots de SEO continuam sendo atendidos a partir da sua origem normalmente. Para testar a configuração, após sua conclusão, procure o cabeçalho x-edgeoptimize-request-id na resposta.

Pré-requisitos

Antes de configurar as regras do Akamai Property Manager, verifique se você tem:

  • Acesso ao Akamai Property Manager para o seu domínio.
  • Uma chave da API do Edge Optimize obtida na interface do usuário do LLM Optimizer. Para obter as etapas, consulte Recuperar suas chaves de API.
  • (Opcional) Para testar o roteamento de preparo, consulte Chave de API de preparo.

Configuração

A seguinte regra do Akamai Property Manager roteia o tráfego agêntico da página HTML para o Edge Optimize. A configuração inclui as seguintes etapas:

​1. Definir critérios de roteamento (correspondência de tráfego do usuário-agente e do HTML)

Definir roteamento para os seguintes agentes de usuário:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Aplique a regra de roteamento Otimizar no Edge somente ao tráfego agêntico de página HTML. Uma configuração comum é usar os critérios do lado da solicitação, como Extensão de arquivo, para corresponder a html e EMPTY_STRING em URLs de página sem extensão. Se seu site fornece HTML de outros padrões de URL ou inclui rotas não relacionadas à página sem extensão, como pontos de acesso de API, refine a regra com critérios adicionais baseados em caminho.

Definir critérios de roteamento

​2. Definir origem e comportamento do SSL

Definir origem como live.edgeoptimize.net e Corresponder SAN a *.edgeoptimize.net

NOTE
Se a ativação de propriedade falhar depois que você adicionar a regra Otimizar na borda, verifique se a regra usa um modo de verificação SSL do servidor de origem diferente da regra padrão. Se isso acontecer, atualize a regra Otimizar na borda de forma que corresponda à regra padrão. Por exemplo, se a regra padrão usa Configurações de plataforma, use Configurações de plataforma aqui também. Se não conseguir usar a configuração necessária, entre em contato com o suporte da Akamai.

Definir origem e comportamento do SSL

​3. Definir variável de chave de cache

Defina a variável de chave de cache PMUSER_EDGE_OPTIMIZE_CACHE_KEY como LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

Definir variável de chave de cache

​4. Regras de armazenamento em cache

Regras de armazenamento em cache

​5. Modificar Cabeçalhos de Solicitação Recebidos

Defina os seguintes cabeçalhos de solicitação recebida:
x-edgeoptimize-api-key para a chave de API recuperada de LLMO
x-edgeoptimize-config para LLMCLIENT=TRUE;
x-edgeoptimize-url para {{builtin.AK_URL}}

Modificar cabeçalhos de solicitação de entrada

Permitir otimização no Edge por meio de regras de firewall (opcional)

Se o CDN usar um WAF ou Gerenciador de bot:

  • Inclua na lista de permissões o agente de usuário *AdobeEdgeOptimize/1.0* no WAF ou no Gerenciador de bot para que o serviço Otimizar na Edge possa buscar o conteúdo de origem.

  • Se o firewall exigir verificação adicional além do agente do usuário, gere um segredo (por exemplo, openssl rand -hex 32) e:

    • Adicione x-edgeoptimize-fetcher-key com o segredo em suas regras de roteamento junto com os outros cabeçalhos x-edgeoptimize-*.
    • Adicione uma regra do WAF ou do Gerenciador de bot para permitir solicitações em que x-edgeoptimize-fetcher-key corresponde ao mesmo segredo.

  • Otimizar no Edge encaminha esse cabeçalho como está — você é o proprietário do ciclo de vida completo da chave.

Definir cabeçalho x-edgeotimize-fetcher-key no Gerenciador de Propriedades

NOTE
Adicione também o agente de usuário *AdobeEdgeOptimize/1.0* e o cabeçalho x-edgeoptimize-fetcher-key à lista de permissões no Akamai Bot Manager.

​6. Modificar Cabeçalhos de Resposta Recebida

Modificar cabeçalhos de resposta de entrada

​7. Modificação da ID de cache

Modificação da ID do cache

​8. Modificar Cabeçalhos de Solicitações Enviadas

Definir cabeçalho x-forwarded-host como {{builtin.AK_HOST}}

Modificar cabeçalhos de solicitações de saída

​9. Failover do site

A configuração de failover do site tem duas partes: um comportamento de failover dentro da regra de roteamento principal Otimizar no Edge e uma regra irmã que adiciona um cabeçalho de resposta quando ocorre fallback.

9-A. Configurar o comportamento de failover do site

Dentro da regra de roteamento principal Otimizar no Edge, crie uma regra filho chamada Comportamento de Failover do Site. Defina-o como Corresponder a qualquer e adicione estes critérios:

  • Código de Status da Resposta está no intervalo de 400 a 599.
  • Tempo limite de origem é Yes.

Failover de site

Configurar o comportamento de failover do site

9-B. Configurar a regra de cabeçalho de resposta de failover

IMPORTANT
Crie a regra EdgeOtimize Failover – Cabeçalho de Teste como uma irmã (no mesmo nível) das regras de roteamento — não aninhadas dentro delas. Na árvore de regras do Akamai Property Manager, a hierarquia deve ser semelhante a:
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
A regra irmã é avaliada quando o Akamai recria a solicitação com falha para o nome de host original. O critério da chave de API na regra de roteamento impede que essa solicitação seja enviada novamente para o Edge Otimize.
Além disso, certifique-se de que a regra Roteamento de otimização na borda não seja substituída por nenhuma regra correspondente posterior que altere a origem, o comportamento de armazenamento em cache ou a ID de cache para as mesmas solicitações. Se outra regra correspondente redefinir esses comportamentos, o roteamento ou o armazenamento em cache da Otimização na borda poderá não funcionar como esperado.

Configurar a regra de cabeçalho de resposta de failover

O failover do site garante que, se o Edge Otimize retornar um erro ou atingir o tempo limite, o Akamai recriará a solicitação para o nome de host original, de modo que o visitante ainda receba a resposta normal do site.

Cenário
Comportamento
O Edge Otimize retorna 2XX ou 3XX
A resposta otimizada é fornecida. x-edgeoptimize-request-id está presente.
O Edge Otimize retorna 4XX-5XX ou a origem expira
A solicitação é recriada para o nome de host original. A resposta inclui x-edgeoptimize-fo: true.

Verificar a configuração

Após concluir a configuração, verifique se o tráfego de bots está sendo roteado para o Edge Optimize e se o tráfego humano permanece inalterado.

1. Tráfego de bots de teste (deve ser otimizado)

Simular uma solicitação de bot de IA usando um agente de usuário agêntico:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

Uma resposta bem-sucedida inclui o cabeçalho x-edgeoptimize-request-id, confirmando que a solicitação foi roteada pelo Edge Otimize:

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. Teste o tráfego humano (NÃO deve ser afetado)

Simule uma solicitação regular de navegador humano:

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"

A resposta não deve conter o cabeçalho x-edgeoptimize-request-id. O conteúdo da página e o tempo de resposta devem permanecer idênticos aos de antes da habilitação da otimização na borda.

3. Como diferenciar entre os dois cenários

Cabeçalho
Tráfego de bots (otimizado)
Tráfego humano (não afetado)
x-edgeoptimize-request-id
Presente — contém uma ID de solicitação exclusiva
Ausente
x-edgeoptimize-fo
Presente somente se houver um failover (valor: true)
Ausente

O status do roteamento de tráfego também pode ser verificado na interface do usuário do LLM Optimizer. Navegue até Configuração do cliente e selecione a guia Configuração de CDN.

Implantação de otimizações em agentes de IA — concluída

Para saber mais sobre como Otimizar na Edge, incluindo oportunidades disponíveis, fluxos de trabalho de otimização automática e perguntas frequentes, volte para a visão geral de Otimizar na Edge.

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