DocumentaciónLLM Optimizer

Akamai (BYOCDN)

Última actualización: 15 de abril de 2026

Esta configuración enruta el tráfico auténtico (solicitudes de bots de IA y agentes de usuario LLM) al servicio back-end de Edge Optimize (live.edgeoptimize.net). Los visitantes humanos y los bots de SEO se siguen sirviendo desde su origen como de costumbre. Para probar la configuración, una vez completada la instalación, busque el encabezado x-edgeoptimize-request-id en la respuesta.

Requisitos previos

Antes de configurar las reglas del Administrador de propiedades de Akamai, asegúrese de lo siguiente:

  • Acceso al Administrador de propiedades de Akamai para su dominio.
  • Una clave de API de Edge Optimize recuperada de la interfaz de usuario de LLM Optimizer. Para ver los pasos, consulte Recuperar las claves de API.
  • (Opcional) Para probar el enrutamiento de ensayo, consulte Clave de API de ensayo.

Configuración

La siguiente regla del Administrador de propiedades de Akamai enruta el tráfico auténtico de la página de HTML a Edge Optimize. La configuración incluye los pasos siguientes:

1. Establecer criterios de enrutamiento (coincidencia de tráfico de agente de usuario y HTML)

Establezca el enrutamiento para los siguientes agentes de usuario:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
NOTE
Aplique la regla de enrutamiento Optimizar en Edge solo al tráfico auténtico de la página de HTML. Una configuración común es usar criterios del lado de la solicitud como Extensión de archivo para que coincida con html y EMPTY_STRING para direcciones URL de páginas sin extensión. Si su sitio proporciona HTML desde otros patrones de URL o incluye rutas sin extensión que no sean de página, como puntos finales de API, perfeccione la regla con criterios adicionales basados en rutas.

Establecer criterios de enrutamiento

2. Establecer origen y comportamiento de SSL

Establecer origen como live.edgeoptimize.net y hacer coincidir SAN con *.edgeoptimize.net

NOTE
Si la activación de la propiedad falla después de agregar la regla Optimizar en Edge, compruebe si la regla utiliza un modo de verificación SSL del servidor de origen diferente al de la regla predeterminada. Si es así, actualice la regla Optimize at Edge para que coincida con la regla predeterminada. Por ejemplo, si la regla predeterminada usa Configuración de plataforma, use Configuración de plataforma aquí también. Si no puede utilizar la configuración requerida, póngase en contacto con el soporte de Akamai.

Establecer origen y comportamiento de SSL

3. Establecer variable de clave de caché

Establecer la variable de clave de caché PMUSER_EDGE_OPTIMIZE_CACHE_KEY en LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

Establecer variable de clave de caché

4. Reglas de almacenamiento en caché

Reglas de almacenamiento en caché

5. Modificar encabezados de solicitud entrantes

Establezca los siguientes encabezados de solicitud entrantes:
x-edgeoptimize-api-key a la clave de API recuperada de LMO
x-edgeoptimize-config a LLMCLIENT=TRUE;
x-edgeoptimize-url a {{builtin.AK_URL}}

Modificar encabezados de solicitud entrantes

Permitir la optimización en Edge mediante reglas de firewall (opcional)

Si su CDN utiliza un WAF o un Bot Manager:

  • Lista de permitidos el agente de usuario *AdobeEdgeOptimize/1.0* en su WAF o Administrador de bots para que el servicio Optimizar en Edge pueda recuperar el contenido de origen.

  • Si el firewall requiere una verificación adicional más allá del agente de usuario, genere un secreto (por ejemplo, openssl rand -hex 32) y:

    • Agregue x-edgeoptimize-fetcher-key con el secreto en sus reglas de enrutamiento junto con los otros x-edgeoptimize-* encabezados.
    • Agregue una regla de WAF o Bot Manager para permitir solicitudes en las que x-edgeoptimize-fetcher-key coincida con el mismo secreto.

  • Optimizar en Edge reenvía este encabezado tal cual: usted es el propietario del ciclo de vida completo de la clave.

Establecer el encabezado x-edgeoptimize-fetcher-key en el Administrador de propiedades

NOTE
También realice la lista de permitidos del agente de usuario *AdobeEdgeOptimize/1.0* y el encabezado x-edgeoptimize-fetcher-key en el administrador de bots de Akamai.

6. Modificar encabezados de respuesta entrantes

Modificar encabezados de respuesta entrantes

7. Modificación de ID de caché

Modificación de ID de caché

8. Modificar encabezados de solicitud salientes

Establecer el encabezado x-forwarded-host en {{builtin.AK_HOST}}

Modificar encabezados de solicitud de salida

9. Conmutación por error del sitio

La configuración de la conmutación por error del sitio consta de dos partes: el comportamiento de la conmutación por error (configurado dentro de la regla de enrutamiento principal de optimización en el perímetro) y una regla de encabezado de prueba de conmutación por error independiente.

9a. Comportamiento de conmutación por error del sitio (dentro de la regla de enrutamiento principal de optimización en el perímetro)

Dentro de la regla de enrutamiento principal, configure el comportamiento de conmutación por error del sitio y el fragmento XML avanzado de la siguiente manera:

IMPORTANT
El fragmento XML de este paso requiere el comportamiento Advanced. En algunos entornos de Akamai, este comportamiento no está disponible para la edición de autoservicio. Si no ve la opción Avanzada, póngase en contacto con el equipo de su cuenta de Akamai o con el servicio de atención al cliente de Akamai para habilitar la configuración requerida.

Conmutación por error del sitio

Agregue el encabezado de solicitud x-edgeoptimize-request con el valor fo mediante XML avanzado:

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

Comportamientos de conmutación por error

9b. Regla de encabezado de prueba de conmutación por error (regla del mismo nivel)

IMPORTANT
Cree la regla EdgeOptimize Failover - Test Header como hermano (en el mismo nivel) de las reglas de enrutamiento: no anidadas en ellas. En el árbol de reglas del Administrador de propiedades de Akamai, la jerarquía debe tener un aspecto similar al siguiente:
code language-none 
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
Esto garantiza que la regla de encabezado de prueba de conmutación por error se evalúe para todas las reglas de enrutamiento, no solo una.
Asegúrese también de que la regla Optimizar en enrutamiento de Edge no se anule con ninguna regla que coincida posteriormente y que cambie el origen, el comportamiento del almacenamiento en caché o el ID de caché para las mismas solicitudes. Si otra regla coincidente restablece estos comportamientos, es posible que el enrutamiento o el almacenamiento en caché de Optimize at Edge no funcione según lo esperado.

Si el valor del encabezado de solicitud x-edgeoptimize-request es fo, establezca el encabezado de respuesta saliente x-edgeoptimize-fo en true.

Reglas de conmutación por error

La conmutación por error del sitio garantiza que si Edge Optimize devuelve un error 4XX o 5XX, la solicitud se redirigirá automáticamente a su origen predeterminado para que el usuario final siga recibiendo una respuesta.

Escenario
Comportamiento
Edge Optimize devuelve 2XX
La respuesta optimizada se sirve al cliente.
Edge Optimize devuelve 4XX o 5XX
La solicitud se redirige de nuevo al origen predeterminado.

Verificar la configuración

Una vez completada la configuración, compruebe que el tráfico de bots se enrute a Edge Optimize y que el tráfico humano no se vea afectado.

1. Probar el tráfico de bots (debe optimizarse)

Simule una solicitud de bot de IA con un user-agent auténtico:

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

Una respuesta correcta incluye el encabezado x-edgeoptimize-request-id, que confirma que la solicitud se enrutó a través de Edge Optimize:

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

2. Probar el tráfico humano (NO debería verse afectado)

Simule una solicitud normal de explorador 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"

La respuesta no debe contener el encabezado x-edgeoptimize-request-id. El contenido de la página y el tiempo de respuesta deben ser idénticos al de antes de habilitar Optimizar en Edge.

3. Cómo diferenciar los dos escenarios

Encabezado
Tráfico de bots (optimizado)
Tráfico humano (no afectado)
x-edgeoptimize-request-id
Presente: contiene un ID de solicitud único.
Ausente
x-edgeoptimize-fo
Solo está presente si se produjo la conmutación por error (valor: 1)
Ausente

El estado del enrutamiento de tráfico también se puede comprobar en la interfaz de usuario de LLM Optimizer. Vaya a Configuración del cliente y seleccione la pestaña Configuración de CDN.

Implementar optimizaciones en agentes de IA — completado

Para obtener más información sobre Optimizar en Edge, incluidas las oportunidades disponibles, los flujos de trabajo de optimización automática y las preguntas frecuentes, vuelve a Optimizar en la descripción general de Edge.

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