DocumentaçãoAdobe Brand Visibility

Akamai (BYOCDN)

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

Criado para:

  • Admin

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, certifique-se de que você tenha:

  • Acesso ao Akamai Property Manager para o seu domínio.
  • Uma chave de API da otimização na borda foi recuperada da interface do Adobe Brand Visibility. Para obter as etapas, consulte Recuperar suas chaves de API.
  • (Opcional) Para testar o roteamento de preparo, consulte Chave de API de preparo.

Opções de configuração

Há duas maneiras de configurar o Akamai para Otimizar na borda:

Opção 1: configuração guiada no Adobe Brand Visibility

https://video.tv.adobe.com/v/3497591/?captions=por_br&quality=12&learn=on
https://video.tv.adobe.com/vc/3497591/por_br.json

A configuração guiada requer um cliente da API do Akamai EdgeGrid em sua própria conta do Akamai, com Property Manager (PAPI) — acesso de LEITURA-GRAVAÇÃO ao grupo e ao contrato da propriedade de destino, além de permissão para ativar versões da propriedade nos ambientes de teste e produção do Akamai. O Adobe Brand Visibility usa essas credenciais somente para a configuração e não as armazena.

Preparar o cliente de API Akamai EdgeGrid

Se você ainda não tiver um cliente de API adequado, crie um no Centro de controle do Akamai:

  1. Abra Administração > Identidade e acesso.
  2. Em Usuários e clientes de API, selecione Criar cliente de API.
  3. Selecione Eu, depois Avançado. Limite o cliente ao Property Manager (PAPI) — LEITURA-GRAVAÇÃO, retenha somente o grupo alvo e o contrato, e confirme a permissão para ativação nos Ambientes de teste e produção.
  4. Crie o cliente e, em seguida, baixe ou copie imediatamente o arquivo de credenciais. Você precisa do segredo do cliente, host da API, token de acesso e token do cliente. O segredo do cliente é exibido apenas uma vez.

Criar um cliente de API no gerenciamento de identidade e acesso do Akamai

Restringir o cliente de API a LEITURA-GRAVAÇÃO no Gerenciador de propriedade (PAPI)

NOTE
Armazene o arquivo de credenciais no gerenciador de segredos aprovado pela sua organização. A Adobe Brand Visibility não armazena essas credenciais; elas permanecem na sessão do navegador e são apagadas quando você fecha o painel de implantação.

Implantar a configuração de roteamento

  1. Abra a Configuração da CDN para o URL que deseja configurar.
  2. Em Implantar otimizações em agentes de IA, selecione Habilitar se necessário.
  3. Selecione Implantar roteamento no Akamai (Beta).
  4. Cole o arquivo das credenciais do EdgeGrid ou insira o segredo do cliente, o host da API, o token de acesso e o token do cliente individualmente e estabeleça a conexão.
  5. Selecione a propriedade do Akamai, revise as alterações propostas e siga as etapas guiadas para implantar. Obtenha aprovação antes de ativar a nova versão da propriedade.

Implantar roteamento no Akamai a partir do Adobe Brand Visibility

NOTE
A configuração guiada está disponível como um recurso de acesso antecipado para contas elegíveis. Para obter assistência de integração, contate a equipe de contas da Adobe ou envie um email para abv-at-edge@adobe.com.

Opção 2: configuração manual

Use as etapas a seguir para configurar as regras do Akamai Property Manager manualmente.

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 HTML e Usuário-Agente)

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 de entrada

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

Modificar cabeçalhos de solicitação de entrada

Permitir Otimização na borda por meio de regras de firewall (opcional)

Se a CDN usar um WAF ou gerenciador de bot:

  • Adicione o agente de usuário *AdobeEdgeOptimize/1.0* à lista de permissões no seu WAF ou gerenciador de bots para que o serviço Otimização na borda possa buscar o conteúdo da sua 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, juntamente 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.

  • A Otimização na borda 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 Propriedade

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 de entrada

Modificar cabeçalhos de resposta de entrada

​7. Modificação da ID do cache

Modificação da ID do cache

​8. Modificar cabeçalhos de solicitação de saída

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: o comportamento de failover (configurado dentro da regra principal de roteamento da optimize-at-edge) e uma regra separada de cabeçalho de teste de failover.

9a. Comportamento de failover do site (dentro da regra principal de roteamento da otimização-na-borda)

Dentro da regra de roteamento principal de Otimização na borda, crie uma regra secundária chamada Comportamento de failover do site. Defina-a como Corresponder a todos e adicione estes critérios:

  • O Código de status da resposta está no intervalo de 400 a 599.
  • O Tempo limite da origem é Yes.

Adicione o comportamento de Failover do site e o trecho de XML avançado a essa regra filha.

IMPORTANT
O trecho XML nesta etapa requer comportamento Avançado. Em alguns ambientes do Akamai, esse comportamento não está disponível para edição no autoatendimento. Se você não vir a opção Avançado, entre em contato com a equipe de conta do Akamai ou com o suporte do Akamai para habilitar a configuração necessária.

Failover de site

Adicione o cabeçalho da solicitação x-edgeoptimize-request com o valor fo por meio de XML avançado:

<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>

Comportamentos de failover

9b. Regra de cabeçalho para teste de failover (regra irmã)

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
      ▼ Optimize at Edge Routing                ← routing rule
              Site Failover Behavior                ← child of the routing rule
      EdgeOptimize Failover - Test Header       ← sibling of the routing rule
Isso garante que a regra de cabeçalho de teste de failover seja avaliada para todas as regras de roteamento, e não apenas para uma.
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.

Se o valor x-edgeoptimize-request do cabeçalho da solicitação for fo, defina o cabeçalho de resposta de saída x-edgeoptimize-fo como true.

Regras de failover

O failover do site garante que, se o Edge Optimize retornar um erro 4XX ou 5XX, a solicitação será automaticamente direcionada de volta para sua origem padrão para que o usuário final ainda receba uma resposta.

Cenário
Comportamento
O Edge Otimize retorna 2XX
A resposta otimizada é fornecida ao cliente.
O Edge Otimize retorna 4XX ou 5XX
A solicitação é roteada de volta para a origem padrão.

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 Adobe Brand Visibility. Acesse Configuração do cliente e selecione a guia Configuração da CDN.

Implantar otimizações em agentes de IA: concluído

Para saber mais sobre a Otimização na borda, incluindo oportunidades disponíveis, fluxos de trabalho de otimização automática e perguntas frequentes, volte para a Visão geral da Otimização na borda.

recommendation-more-help
brand-visibility-help-main-toc