Cloudflare (BYOCDN)

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 de enrutamiento de Cloud Flare Worker, asegúrese de lo siguiente:

Funcionamiento del enrutamiento

Cuando se configura correctamente, Cloudflare Worker intercepta una solicitud a su dominio (por ejemplo, www.example.com/page.html) desde un agente de usuario agéntico y la enruta al back-end de Edge Optimize. La solicitud de back-end incluye los encabezados necesarios.

Prueba de la solicitud de servidor

Puede verificar el enrutamiento realizando una solicitud directa al back-end de Edge Optimize.

curl -svo /dev/null https://live.edgeoptimize.net/page.html \
  -H 'x-forwarded-host: www.example.com' \
  -H 'x-edgeoptimize-url: /page.html' \
  -H 'x-edgeoptimize-api-key: $EDGE_OPTIMIZE_API_KEY' \
  -H 'x-edgeoptimize-config: LLMCLIENT=TRUE;'

Encabezados obligatorios

Se deben configurar los siguientes encabezados en las solicitudes dirigidas al back-end de Edge Optimize:

Opciones de configuración

Existen dos formas de configurar Cloudflare para Optimizar en Edge:

Para realizar la configuración manual, debe vincular manualmente el Worker al dominio. Consulte Agregar una ruta a su dominio.

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

Opción 2: configuración manual

Siga estos pasos para crear y configurar el trabajador manualmente.

Paso 1: Creación del trabajador de Cloudflare

Paso 2: Añadir el código de Worker

Después de crear el trabajador, haga clic en Editar código y reemplace el código predeterminado por el código de worker.js. Si ya tiene un Cloudflare Worker, combine el código con el código de trabajador existente en lugar de reemplazarlo por completo.

Haga clic en Guardar e implementar para publicar el trabajador.

Paso 3: Configurar las variables y los secretos de entorno

Las variables del entorno almacenan la configuración confidencial como su clave de API de forma segura.

Añadir una ruta a su dominio add-a-route-to-your-domain

Si ha utilizado la configuración manual, vincule manualmente el Worker a su dominio. Este paso activa el trabajador en su tráfico.

También puede configurar rutas en el nivel de zona:

Verificación del comportamiento de failover

Si Edge Optimize no está disponible o devuelve un error, el trabajador conmuta automáticamente por error a su origen. Las respuestas de la conmutación por error incluyen el encabezado x-edgeoptimize-fo:

< HTTP/2 200
< x-edgeoptimize-fo: 1

Puede supervisar los eventos de conmutación por error en los registros de Cloudflare Workers para solucionar problemas.

Explicación de la lógica de trabajo

Cloudflare Worker implementa la siguiente lógica:

Personalizar la configuración

Puede personalizar el comportamiento del trabajador modificando las constantes de configuración en la parte superior del código:

Lista de bots agénticos

Modifique la matriz AGENTIC_BOTS para añadir o quitar agentes de usuario:

const AGENTIC_BOTS = [
  'AdobeEdgeOptimize-AI',
  'ChatGPT-User',
  'GPTBot',
  'OAI-SearchBot',
  'PerplexityBot',
  'Perplexity-User',
  'ClaudeBot',
  'Claude-User',
  'Claude-SearchBot',
  // Add additional user agents as needed
];

Rutas de destino

De forma predeterminada, todas las páginas HTML se enrutan a Edge Optimize. Para limitar el enrutamiento a rutas de acceso específicas, modifique la matriz TARGETED_PATHS:

// Route all HTML pages (default)
const TARGETED_PATHS = null;

// Or specify exact paths to route
const TARGETED_PATHS = ['/', '/page.html', '/products', '/about-us'];

Configuración de conmutación por error

De forma predeterminada, el trabajador conmuta por error cualquier error 4XX o 5XX de Edge Optimize. Personalice este comportamiento:

// Default: failover on any 4XX or 5XX error
const FAILOVER_ON_4XX = true;
const FAILOVER_ON_5XX = true;

// Failover only on 5XX server errors (not 4XX client errors)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = true;

// Disable automatic failover (not recommended)
const FAILOVER_ON_4XX = false;
const FAILOVER_ON_5XX = false;

Consideraciones importantes

Resolución de problemas

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

Si su CDN utiliza un WAF o un Bot Manager:

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

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

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.