DocumentaciónAdobe Brand Visibility

Akamai (BYOCDN)

Última actualización: 10 de septiembre de 2026

Creado para:

  • Administrador

Esta configuración enruta el tráfico agéntico (solicitudes de bots de IA y agentes de usuario LLM) al servicio de 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 completados los ajustes, 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 tener lo siguiente:

  • Acceso al Administrador de propiedades de Akamai para su dominio.
  • Haber recuperado una clave de API de Edge Optimize de la IU de Adobe Brand Visibility. Para ver los pasos, consulte Recuperar las claves de API.
  • (Opcional) Para probar el enrutamiento de ensayo, consulte Clave de API de ensayo.

Opciones de configuración

Existen dos formas de configurar Akamai para Optimizar en Edge:

Opción 1: configuración guiada en Adobe Brand Visibility

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

La configuración guiada requiere un cliente de API de Akamai EdgeGrid en su cuenta de Akamai, con acceso del Administrador de propiedades (PAPI): LECTURA Y ESCRITURA al grupo de la propiedad de destino y contrato y permiso para activar versiones de propiedad en los entornos de Ensayo y Producción de Akamai. Adobe Brand Visibility utiliza estas credenciales solo para la configuración y no las almacena.

Preparación del cliente de API de Akamai EdgeGrid

Si todavía no tiene un cliente de API adecuado, cree uno en el Centro de control de Akamai:

  1. Abra Administración > Identidad y acceso.
  2. En Usuarios y clientes de API, seleccione Crear cliente API.
  3. Seleccione Yo mismo y luego Avanzado. Limite el cliente a Administrador de propiedades (PAPI): LECTURA Y ESCRITURA, conserve solamente el grupo destinatario y el contrato, y confirme el permiso para activar en los entornos de Ensayo y Producción.
  4. Cree el cliente y, a continuación, descargue o copie inmediatamente el archivo de credenciales. Necesita el secreto de cliente, el host de API, el token de acceso y el token de cliente. El secreto de cliente se muestra solo una vez.

Creación de un cliente de API en Administración de acceso e identidad de Akamai

Restringir el cliente de API al Administrador de propiedades (PAPI), LECTURA Y ESCRITURA

NOTE
Almacene el archivo de credenciales en el administrador de secretos aprobado de su organización. Adobe Brand Visibility no almacena estas credenciales; permanecen en la sesión del explorador y se borran al cerrar el panel de control de implementación.

Implementación de la configuración de enrutamiento

  1. Abra Configuración de CDN para la dirección URL que desee configurar.
  2. En Implementar optimizaciones en agentes de IA, seleccione Habilitar, si fuera necesario.
  3. Seleccione Implementación del enrutamiento en Akamai (Beta).
  4. Pegue el archivo de credenciales de EdgeGrid o escriba el secreto de cliente, el host de API, el token de acceso y el token de cliente individualmente y, a continuación, conecte.
  5. Seleccione la propiedad de Akamai, revise los cambios propuestos y siga los pasos guiados para implementar. Obtenga la aprobación antes de activar la nueva versión de la propiedad.

Implementación del enrutamiento en Akamai desde Adobe Brand Visibility

NOTE
La configuración guiada está disponible como función de acceso anticipado para las cuentas elegibles. Para obtener ayuda sobre la incorporación, contacte con el equipo de cuentas de Adobe o envíe un correo electrónico a abv-at-edge@adobe.com.

Opción 2: configuración manual

Siga los pasos siguientes para configurar las reglas del Administrador de propiedades de Akamai manualmente.

Configuración

La siguiente regla del Administrador de propiedades de Akamai dirige el tráfico de páginas HTML agénticas a Edge Optimize. La configuración incluye los pasos siguientes:

​1. Establecimiento de criterios de enrutamiento (coincidencia de usuario-agente y tráfico de HTML)

Establezca el enrutamiento de los siguientes agentes de usuario:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Aplique la regla de enrutamiento Optimizar en Edge solo al tráfico de páginas HTML agénticas. Una configuración común es usar criterios del lado de la solicitud como, por ejemplo, Extensión de archivo para que coincida con html y EMPTY_STRING para direcciones URL de páginas sin extensión. Si su sitio sirve HTML desde otros patrones de URL o incluye rutas sin extensión que no sean de página, como los 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 añadir 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 Optimizar en Edge para que coincida con la regla predeterminada. Por ejemplo, si la regla predeterminada utiliza Configuración de la plataforma, utilice Configuración de la plataforma aquí también. Si no puede utilizar la configuración requerida, póngase en contacto con el servicio de asistencia de Akamai.

Establecer origen y comportamiento de SSL

​3. Establecer variable de clave de caché

Establecer la variable de la 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 solicitudes entrantes

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

Modificar encabezados de solicitud entrantes

Permitir Optimizar en Edge mediante reglas de cortafuegos (opcional)

Si su CDN utiliza un WAF o un administrador de bots:

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

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

    • Añada x-edgeoptimize-fetcher-key con el secreto en sus reglas de enrutamiento junto con los otros encabezados de x-edgeoptimize-*.
    • Añada una regla de WAF o administrador de bots 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
Añada también a la lista de permitidos el agente de usuario *AdobeEdgeOptimize/1.0* y el encabezado x-edgeoptimize-fetcher-key en el administrador de bots de Akamai.

​6. Modificar encabezados de respuestas entrantes

Modificar encabezados de respuesta entrantes

​7. Modificación de ID de caché

Modificación del ID de caché

​8. Modificar encabezados de solicitudes salientes

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

Modificar encabezados de solicitudes salientes

​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 Optimizar en Edge) 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 Optimizar en Edge)

Dentro de la regla de enrutamiento principal de Optimize en Edge, cree una regla secundaria llamada Comportamiento de conmutación por error del sitio. Configúrela en Coincidir con cualquiera y agregue estos criterios:

  • El código de estado de respuesta está en el intervalo de 400 a 599.
  • El tiempo de espera de origen es Yes.

Añada el comportamiento de conmutación por error del sitio y el fragmento XML avanzado a esa regla secundaria.

IMPORTANT
El fragmento XML de este paso requiere el comportamiento Avanzado. En algunos entornos de Akamai, este comportamiento no está disponible para la edición de autoservicio. Si no visualiza la opción Avanzado, póngase en contacto con el equipo de cuentas de Akamai o con el servicio de asistencia de Akamai para habilitar la configuración necesaria.

Conmutación por error del sitio

Añada el encabezado de la 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 del encabezado de la prueba de conmutación por error (regla del mismo nivel)

IMPORTANT
Cree la regla Conmutación por error de Edge Optimize: encabezado de la prueba como similar (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 
▼ 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
Esto garantiza que la regla del encabezado de la 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 Enrutamiento de Optimizar en Edge no se anule con ninguna regla posterior que coincida 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 Optimizar en Edge no funcione según lo previsto.

Si el valor del encabezado de la solicitud x-edgeoptimize-request es fo, establezca el encabezado de la 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á de nuevo automáticamente a su origen predeterminado para que el usuario final siga recibiendo una respuesta.

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

Verificación de 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 agente de usuario agé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ó mediante 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 un explorador:

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 entre 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: true)
Ausente

El estado del enrutamiento de tráfico también se puede comprobar en la IU de Adobe Brand Visibility. Vaya a Configuración del cliente y seleccione la pestaña Configuración de la 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, vuelva a Información general sobre Optimizar en Edge.

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