Cloudflare (BYOCDN)

Questa configurazione indirizza il traffico da IA agentica (richieste da bot IA e da agenti utente LLM) al servizio back-end Edge Optimize (live.edgeoptimize.net). Le persone e i bot SEO continuano a ricevere come al solito i contenuti trasmessi dalla tua origine. Per testare la configurazione, al termine cerca nella risposta l’intestazione x-edgeoptimize-request-id.

Prerequisiti

Prima di impostare le regole di instradamento di Cloud Worker, verificare di disporre dei seguenti elementi:

Come funziona l’indirizzamento

Una volta configurata correttamente, una richiesta al tuo dominio (ad esempio, www.example.com/page.html) proveniente da un agente utente agentico viene intercettata dal processo di lavoro Cloudflare e indirizzata al back-end del servizio Edge Optimize. La richiesta al back-end include le intestazioni necessarie.

Test della richiesta al back-end

Puoi verificare l’indirizzamento effettuando una richiesta diretta al back-end del servizio 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;'

Intestazioni necessarie

Le seguenti intestazioni devono essere impostate sulle richieste al back-end del servizio Edge Optimize:

Opzioni di configurazione

Sono disponibili due modi per configurare Cloudflare Worker per l’Ottimizzazione sulla rete Edge:

Indipendentemente dall’opzione scelta, è necessario collegare manualmente il processo di lavoro al dominio. Consulta Passaggio: aggiungere un indirizzamento al dominio.

Opzione 1: implementazione in Cloudflare

Questa opzione utilizza il pulsante Implementazione in Cloudflare per creare automaticamente il processo di lavoro e configurare le variabili di ambiente e i segreti richiesti nell’account Cloudflare. Questo è il modo più rapido per iniziare se si sta configurando un nuovo processo di lavoro.

Passaggio 1: implementare il processo di lavoro

Fai clic sul pulsante seguente per implementare il processo di lavoro dell’Ottimizzazione sulla rete Edge nell’account Cloudflare:

Passaggio 2: compilare il modulo di implementazione

Facendo clic sul pulsante, si apre la pagina di configurazione dei processi di lavoro. Compila il modulo come segue:

Dopo aver implementato il processo di lavoro, procedi con Aggiungere un indirizzamento al dominio per collegare il processo di lavoro al dominio. L’indirizzamento non viene configurato automaticamente e deve essere completato manualmente.

Opzione 2: configurazione manuale

Segui questi passaggi per creare e configurare manualmente il processo di lavoro.

Passaggio 1: creare il processo di lavoro Cloudflare

Passaggio 2: aggiungere il codice del processo di lavoro

Dopo aver creato il processo di lavoro, fare clic su Modifica codice e sostituire il codice predefinito con il codice di worker.js. Se disponi già di Cloud Worker, unisci il codice con il codice del processo di lavoro esistente invece di sostituirlo completamente.

Fai clic su Save and deploy (Salva e implementa) per pubblicare il processo di lavoro.

Passaggio 3: configurare i segreti e le variabili di ambiente

Le variabili di ambiente memorizzano in modo sicuro le configurazioni sensibili, come la chiave API.

Aggiungere un indirizzamento al dominio add-a-route-to-your-domain

Indipendentemente dall’opzione di configurazione utilizzata, devi collegare manualmente il processo di lavoro al tuo dominio. Questo passaggio attiva il processo di lavoro sul tuo traffico.

In alternativa, puoi configurare gli indirizzamenti a livello di zona:

Verifica del comportamento di failover

Se il servizio Edge Optimize non è disponibile o restituisce un errore, il processo di lavoro esegue automaticamente il failover sulla tua origine. Le risposte di failover includono l’intestazione x-edgeoptimize-fo:

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

Per la risoluzione di eventuali problemi, puoi monitorare gli eventi di failover nei registri dei processi di lavoro di Cloudflare.

Logica del processo di lavoro

Il processo di lavoro Cloudflare implementa la logica seguente:

Personalizzazione della configurazione

Puoi personalizzare il comportamento del processo di lavoro modificando le costanti di configurazione all’inizio del codice:

Elenco dei bot agentici

Modifica l’array AGENTIC_BOTS per aggiungere o rimuovere agenti utente:

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

Percorsi di destinazione

Per impostazione predefinita, tutte le pagine HTML vengono indirizzate al servizio Edge Optimize. Per limitare l’indirizzamento a percorsi specifici, modifica l’array 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'];

Cofigurazione del failover

Per impostazione predefinita, il processo di lavoro esegue il failover in caso di errori 4XX o 5XX dal servizio Edge Optimize. Personalizza questo comportamento:

// 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;

Considerazioni importanti

Risoluzione dei problemi

Consenti Ottimizza su rete Edge tramite le regole del firewall (facoltativo)

Se la rete CDN utilizza un WAF o un Bot Manager:

Verificare la configurazione

Dopo aver completato la configurazione, verifica che il traffico proveniente da bot venga indirizzato al servizio Edge Optimize e che il traffico da persone non sia interessato da alcuna modifica.

1. Test del traffico da bot (deve risultare ottimizzato)

Simula una richiesta da un bot IA utilizzando un agente utente da IA agentica:

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

Se il test ha esito positivo, la risposta contiene l’intestazione x-edgeoptimize-request-id, a conferma che la richiesta è stata indirizzata tramite il servizio Edge Optimize:

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

2. Test del traffico da persone (deve risultare NON interessato da modifiche)

Simula una normale richiesta inserita da una persona nel browser:

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 risposta non deve contenere l’intestazione x-edgeoptimize-request-id. Il contenuto della pagina e il tempo di risposta devono risultare identici rispetto a prima che sia stata abilitata la funzione Ottimizza su rete edge.

3. Differenze tra i due scenari

Lo stato del routing del traffico può essere controllato anche nell’interfaccia utente di LLM Optimizer. Passa a Configurazione cliente e seleziona la scheda Configurazione CDN.

Per ulteriori informazioni su Ottimizza in Edge, tra cui le opportunità disponibili, i flussi di lavoro di ottimizzazione automatica e le domande frequenti, torna alla Panoramica sull’ottimizzazione in Edge.