Akamai (BYOCDN)

Questa configurazione indirizza il traffico agente (richieste da bot di IA e agenti utente LLM) al servizio back-end Edge Optimize (live.edgeoptimize.net). I visitatori umani e i bot SEO continuano a essere serviti dalla tua origine come al solito. Per verificare la configurazione, al termine dell'installazione, cercare l'intestazione x-edgeoptimize-request-id nella risposta.

Prerequisiti

Prima di impostare le regole di Gestione proprietà Akamai, assicurati di disporre dei seguenti elementi:

  • Accesso ad Akamai Property Manager per il dominio.
  • Processo di onboarding in LLM Optimizer completato.
  • Inoltro del registro CDN a LLM Optimizer completato.
  • Chiave API di ottimizzazione Edge recuperata dall’interfaccia utente di LLM Optimizer.

Passaggi per recuperare la chiave API:

  1. Passa a Configurazione cliente e seleziona la scheda Configurazione rete CDN.

    Passa a Configurazione cliente

  2. In Routing traffico IA per distribuire ottimizzazioni, selezionare la casella di controllo Distribuisci ottimizzazioni agli agenti IA.

    Distribuisci ottimizzazioni agli agenti di intelligenza artificiale

  3. Copia la chiave API e procedi con i passaggi di configurazione dell’indirizzamento riportati di seguito.

    Copia la chiave API

    note note
    NOTE
    A questo punto, lo stato potrebbe mostrare una croce rossa che indica che la configurazione non è ancora stata completata. Questo è previsto: una volta completata la configurazione di indirizzamento seguente e il traffico da bot AI inizia a fluire, lo stato si aggiorna a un segno di spunta verde che conferma che il routing è stato abilitato correttamente.

Inoltre, se hai bisogno di assistenza per i passaggi precedenti, contatta il team del tuo account Adobe o llmo-at-edge@adobe.com.

Configurazione

La regola di Akamai Property Manager seguente indirizza gli agenti utente LLM ad Edge Optimize. La configurazione include i seguenti passaggi:

1. Imposta i criteri di indirizzamento (corrispondenza agente utente)

Imposta routing per i seguenti agenti utente:image.png

 *AdobeEdgeOptimize-AI*,
 *ChatGPT-User*,
 *GPTBot*,
 *OAI-SearchBot*,
 *PerplexityBot*,
 *Perplexity-User*

Imposta i criteri di indirizzamento

2. Imposta il comportamento di origine e SSL

Imposta origine come live.edgeoptimize.net e abbina SAN a *.edgeoptimize.net

Imposta il comportamento di origine e SSL

3. Imposta la variabile chiave della cache

Imposta la variabile chiave della cache PMUSER_EDGE_OPTIMIZE_CACHE_KEY su LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

Imposta la variabile chiave della cache

4. Regole di memorizzazione in cache

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}}

Modifica le intestazioni delle richieste in ingresso

6. Modifica le intestazioni delle risposte in ingresso

Modifica le intestazioni delle risposte in ingresso

7. Modifica l’ID cache

Modifica l’ID cache

8. Modifica intestazioni richieste in uscita

Imposta intestazione x-forwarded-host su {{builtin.AK_HOST}}

Modifica intestazioni richieste in uscita

9. Failover del sito

La configurazione di failover del sito è composta da due parti: il comportamento di failover (configurato all'interno della regola principale di routing optimize-at-edge) e una regola di intestazione del test di failover separata.

9 bis. Comportamento failover sito (all'interno della regola principale di routing di ottimizzazione in Edge)

All'interno della regola di routing principale, configurare il comportamento Failover del sito e lo snippet XML avanzato come indicato di seguito:

Failover del sito

Aggiungere l'intestazione della 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>

Comportamenti di failover

9 ter. Regola intestazione test di failover (regola di pari livello)

IMPORTANT
Crea la regola Failover EdgeOptimize - Testing Header come pari livello (allo stesso livello) delle regole di routing - non nidificate al loro interno. Nella struttura ad albero delle regole di Gestione proprietà Akamai, la gerarchia deve essere simile alla seguente:
code language-none
▼ Parent Rule
   ▶ Optimize at Edge Routing     ← routing rule
       EdgeOptimize Failover - Test Header       ← sibling, same level
In questo modo la regola di intestazione del test di failover valuta tutte le regole di routing, non solo una.

Se il valore dell'intestazione di richiesta x-edgeoptimize-request è fo, impostare l'intestazione di risposta in uscita x-edgeoptimize-fo su true.

Regole di failover

Il failover del sito garantisce che se Edge Optimize restituisce un errore 4XX o 5XX, la richiesta venga automaticamente indirizzata all'origine predefinita, in modo che l'utente finale riceva comunque una risposta.

Scenario
Comportamento
Edge Optimize restituisce 2XX
Al client viene fornita una risposta ottimizzata.
Edge Optimize restituisce 4XX o 5XX
La richiesta viene indirizzata all’origine predefinita.

Verifica installazione

Dopo aver completato la configurazione, verifica che il traffico da bot venga indirizzato ad Edge Optimize e che non venga influenzato dal traffico umano.

1. Verifica traffico da bot (deve essere ottimizzato)

Simulare una richiesta bot di intelligenza artificiale utilizzando un agente utente:

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

Una risposta corretta include l'intestazione x-edgeoptimize-request-id, a conferma che la richiesta è stata instradata tramite Edge Optimize:

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

2. Test del traffico umano (non dovrebbe essere interessato)

Simula una richiesta browser umana regolare:

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 deve non contenere l'intestazione x-edgeoptimize-request-id. Il contenuto della pagina e il tempo di risposta devono rimanere identici a prima di abilitare l’opzione Ottimizza in Edge.

3. Come distinguere tra i due scenari

Intestazione
Traffico bot (ottimizzato)
Traffico umano (non interessato)
x-edgeoptimize-request-id
Presente — contiene un ID richiesta univoco
Assente
x-edgeoptimize-fo
Presente solo se si è verificato il failover (valore: 1)
Assente

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 rete CDN.

Stato routing traffico IA con routing abilitato

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.

recommendation-more-help
c815c0f2-e460-4c64-ba18-da1db7461075