Akamai (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 configurare le regole di Akamai Property Manager, assicurati di:
- aver accesso ad Akamai Property Manager per il tuo dominio;
- aver recuperato una chiave API di ottimizzazione edge dall’interfaccia di LLM Optimizer. Per i passaggi, consulta Recuperare le chiavi API.
- (Facoltativo) Per verificare il routing dell’area di gestione temporanea, vedere Chiave API di gestione temporanea.
Configurazione
La seguente regola di Akamai Property Manager indirizza il traffico di pagina HTML agente ad Edge Optimize. La configurazione include i seguenti passaggi:
1. Imposta criteri di routing (corrispondenza traffico agente utente e HTML)
Impostare l’instradamento per i seguenti agenti utente:
*AdobeEdgeOptimize-AI*
*ChatGPT-User*
*GPTBot*
*OAI-SearchBot*
*PerplexityBot*
*Perplexity-User*
html e EMPTY_STRING per gli URL di pagina senza estensione. Se il sito utilizza HTML da altri pattern di URL o include route non di pagina senza estensione, come endpoint API, perfeziona la regola con criteri aggiuntivi basati sul percorso.
2. Imposta il comportamento di origine e SSL
Imposta l’origine come live.edgeoptimize.net e abbina SAN a *.edgeoptimize.net
3. Imposta la variabile chiave della cache
Imposta la variabile della chiave della cache PMUSER_EDGE_OPTIMIZE_CACHE_KEY su LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}
4. Regole di memorizzazione in cache
5. Modifica le intestazioni delle richieste in ingresso
Imposta le seguenti intestazioni di richiesta in ingresso:x-edgeoptimize-api-key alla chiave API recuperata da LLMO
Da x-edgeoptimize-config a LLMCLIENT=TRUE;
Da x-edgeoptimize-url a {{builtin.AK_URL}}
Consenti ottimizzazione in Edge tramite regole firewall (facoltativo)
Se la rete CDN utilizza un WAF o un Bot Manager:
-
Inserire nell’elenco Consentiti l’agente utente
*AdobeEdgeOptimize/1.0*nel WAF o nel gestore bot in modo che il servizio Optimize at Edge possa recuperare il contenuto di origine. -
Se il firewall richiede ulteriori verifiche oltre all’agente utente, generare un segreto (ad esempio,
openssl rand -hex 32) e:- Aggiungi
x-edgeoptimize-fetcher-keycon il segreto nelle regole di routing insieme alle altre intestazionix-edgeoptimize-*. - Aggiungi una regola di WAF o Bot Manager per consentire le richieste in cui
x-edgeoptimize-fetcher-keycorrisponde allo stesso segreto.
- Aggiungi
-
Ottimizza in Edge inoltra questa intestazione così com’è, sei il proprietario dell’intero ciclo di vita delle chiavi.
*AdobeEdgeOptimize/1.0* e l'intestazione x-edgeoptimize-fetcher-key in Akamai Bot Manager.6. Modifica le intestazioni delle risposte in ingresso
7. Modifica l’ID cache
8. Modifica le intestazioni delle richieste in uscita
Imposta l’intestazione x-forwarded-host su {{builtin.AK_HOST}}
9. Failover del sito
La configurazione di failover del sito è composta da due parti: il comportamento di failover (che viene configurato all’interno della regola di indirizzamento optimize-at-edge principale) e una regola distinta per l’intestazione a scopo di test del failover.
9a. Comportamento di failover del sito (nella regola di indirizzamento optimize-at-edge principale)
Nella regola di indirizzamento principale, configura il comportamento di failover del sito e lo snippet XML avanzato come indicato di seguito:
Aggiungi l’intestazione di richiesta x-edgeoptimize-request con il valore fo tramite XML avanzato:
<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>
9b. Regola intestazione per test del failover (regola di pari livello)
| code language-none |
|---|
|
Se il valore dell’intestazione della richiesta x-edgeoptimize-request è fo, imposta l’intestazione della risposta in uscita x-edgeoptimize-fo su true.
Il failover del sito fa sì che, se il servizio Edge Optimize restituisce un errore 4XX o 5XX, la richiesta viene indirizzata automaticamente all’origine predefinita, in modo che l’utente finale riceva comunque una risposta.
2XX4XX o 5XXVerificare 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
x-edgeoptimize-request-idx-edgeoptimize-fo1)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.