DocumentazioneAdobe Brand Visibility

Akamai (BYOCDN)

Ultimo aggiornamento: 7 agosto 2026

Creato per:

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

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 Gestione proprietà Akamai, assicurati di disporre di:

  • aver accesso ad Akamai Property Manager per il tuo dominio;
  • Chiave API di ottimizzazione Edge recuperata dall’interfaccia utente di Adobe Brand Visibility. Per la procedura, consulta Recuperare le chiavi API.
  • (Facoltativo) Per verificare l’indirizzamento in fase di staging, consulta Chiave API di staging.

Opzioni di configurazione

Esistono due modi per configurare Akamai per l’ottimizzazione in Edge:

Opzione 1: configurazione guidata in Adobe Brand Visibility

La configurazione guidata richiede un client API Akamai EdgeGrid nel tuo account Akamai, con accesso Gestione proprietà (PAPI) - READ-WRITE al gruppo della proprietà di destinazione e il contratto e l’autorizzazione per attivare le versioni delle proprietà in Akamai Staging e Produzione. Adobe Brand Visibility utilizza queste credenziali solo per l’installazione e non le memorizza.

Preparare il client API Akamai EdgeGrid

Se non disponi già di un client API appropriato, creane uno in Akamai Control Center:

  1. Apri Amministrazione > Identità e accesso.
  2. In Utenti e client API, selezionare Crea client API.
  3. Seleziona Io, quindi Avanzate. Limitare il client a Gestione proprietà (PAPI) - LETTURA-SCRITTURA, mantenere solo il gruppo di destinazione e il contratto e confermare l’autorizzazione per l’attivazione in staging e produzione.
  4. Crea il client, quindi scarica o copia immediatamente il file delle credenziali. Sono necessari il segreto client, l’host API, il token di accesso e il token client. Il segreto client viene visualizzato una sola volta.

Creare un client API in Akamai Identity and Access Management

Limitare il client API a Property Manager (PAPI) READ-WRITE

NOTE
Memorizza il file delle credenziali nel gestore dei segreti approvato dall'organizzazione. Adobe Brand Visibility non memorizza queste credenziali, che rimangono nella sessione del browser e vengono cancellate quando chiudi il dashboard di distribuzione.

Distribuire la configurazione di indirizzamento

  1. Aprire Configurazione CDN per l’URL che si desidera configurare.
  2. In Distribuisci ottimizzazioni agli agenti di intelligenza artificiale, se necessario, seleziona Abilita.
  3. Selezionare Distribuisci routing in Akamai (Beta).
  4. Incolla il file delle credenziali EdgeGrid oppure immetti singolarmente il segreto client, l’host API, il token di accesso e il token client, quindi connettiti.
  5. Seleziona la proprietà Akamai, rivedi le modifiche proposte e segui i passaggi guidati per la distribuzione. Ottieni l’approvazione prima di attivare la nuova versione della proprietà.

Distribuisci routing in Akamai da Adobe Brand Visibility

NOTE
La configurazione guidata è disponibile come funzione di accesso anticipato per gli account idonei. Per assistenza sull'onboarding, contatta il team del tuo account Adobe o invia un messaggio e-mail a llmo-at-edge@adobe.com.

Opzione 2: configurazione manuale

Per configurare manualmente le regole di Gestione proprietà Akamai, effettua le seguenti operazioni.

Configurazione

La seguente regola di Akamai Property Manager indirizza il traffico della pagina HTML da IA agentica verso il servizio Edge Optimize. La configurazione include i seguenti passaggi:

​1. Impostare i criteri di routing (corrispondenza traffico agente utente e HTML)

Imposta l’indirizzamento per i seguenti agenti utente:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Applica la regola di indirizzamento Ottimizza su rete Edge solo al traffico delle pagine HTML da IA agentica. Una configurazione comune prevede l’utilizzo di criteri lato richiesta come Estensione file per far corrispondere html e EMPTY_STRING per gli URL di pagine senza estensione. Se il tuo sito fornisce codice HTML da altri modelli di URL o include indirizzamenti senza estensione che non portano a pagine (ad esempio, endpoint API), perfeziona la regola con ulteriori criteri basati sul percorso.

Imposta i criteri di indirizzamento

​2. Impostare il comportamento di Origin e SSL

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

NOTE
Se l’attivazione della proprietà non riesce dopo aver aggiunto la regola Ottimizza su rete Edge, verifica se la regola utilizza una modalità di verifica SSL del server di origine diversa da quella predefinita. In tal caso, aggiorna la regola Ottimizza su rete Edge in modo che corrisponda alla regola predefinita. Ad esempio, se la regola predefinita utilizza Impostazioni della piattaforma, utilizza anche qui le Impostazioni della piattaforma. Se non riesci a utilizzare l’impostazione richiesta, contatta l’assistenza clienti di Akamai.

Imposta il comportamento di origine e SSL

​3. Imposta variabile chiave cache

Imposta la variabile della 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 intestazioni richieste in ingresso

Imposta le seguenti intestazioni per le richieste in entrata:
x-edgeoptimize-api-key verso la chiave API recuperata da LLMO
x-edgeoptimize-config a LLMCLIENT=TRUE;
x-edgeoptimize-url a {{builtin.AK_URL}}

Modifica le intestazioni delle richieste in ingresso

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* in WAF o Bot Manager 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-key con il segreto nelle regole di routing insieme alle altre intestazioni x-edgeoptimize-*.
    • Aggiungi una regola di WAF o Bot Manager per consentire le richieste in cui x-edgeoptimize-fetcher-key corrisponde allo stesso segreto.

  • Ottimizza in Edge inoltra questa intestazione così com’è, sei il proprietario dell’intero ciclo di vita delle chiavi.

Imposta l’intestazione x-edgeoptimize-fetcher-key in Property Manager

NOTE
Inoltre, inserisci l’agente utente *AdobeEdgeOptimize/1.0* e l’intestazione x-edgeoptimize-fetcher-key all’elenco Consentiti in Akamai Bot Manager.

​6. Modifica intestazioni di risposta in ingresso

Modifica le intestazioni delle risposte in ingresso

​7. Modifica ID cache

Modifica l’ID cache

​8. Modifica intestazioni richieste in uscita

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

Modifica le intestazioni delle richieste in uscita

​9. Failover del sito

La configurazione del failover del sito è composta da due parti: un comportamento di failover all’interno della regola principale di routing Optimize at Edge e una regola di pari livello che aggiunge un’intestazione di risposta quando si verifica il fallback.

9 bis. Configurare il comportamento di failover del sito

All’interno della regola di routing principale Ottimizza in Edge, creare una regola figlio denominata Comportamento failover sito. Impostalo su Corrispondenza con qualsiasi e aggiungi i seguenti criteri:

  • Il codice di stato della risposta è compreso tra 400 e 599.
  • Timeout origine è Yes.

Failover del sito

Configurare il comportamento di failover del sito

9 ter. Configurare la regola di intestazione della risposta di failover

IMPORTANT
Crea la regola EdgeOptimize Failover - Test Header come una regola sibiling (di pari livello) rispetto alle regole di indirizzamento, non nidificata al loro interno. Nella struttura delle regole di Akamai Property Manager, la gerarchia si presenterà così:
code language-none 
▼ Optimize at Edge                         ← parent rule group
      ▼ Optimize at Edge Routing               ← routing child
          Site Failover Behavior                 ← nested child
      EdgeOptimize Failover - Test Header      ← sibling of routing child
La regola di pari livello viene valutata quando Akamai ricrea la richiesta non riuscita per il nome host originale. Il criterio della chiave API nella regola di indirizzamento impedisce che la richiesta venga inviata nuovamente ad Edge Optimize.
Accertati inoltre che la regola di indirizzamento Ottimizza su rete Edge non venga sovrascritta da alcuna regola corrispondente successiva che modifichi l’origine, il comportamento di caching o l’ID della cache per le stesse richieste. Se un’altra regola di corrispondenza reimposta questi comportamenti, l’indirizzamento o il caching di Ottimizza su rete Edge potrebbero non funzionare come previsto.

Configurare la regola di intestazione della risposta di failover

Il failover del sito assicura che, se Edge Optimize restituisce un errore o un timeout, Akamai ricrei la richiesta per il nome host originale in modo che il visitatore riceva comunque la normale risposta del sito.

Scenario
Comportamento
Il servizio Edge Optimize restituisce 2XX o 3XX
Viene trasmessa la risposta ottimizzata. x-edgeoptimize-request-id è presente.
Edge Optimize restituisce 4XX-5XX oppure l’origine scade
La richiesta viene ricreata per il nome host originale. La risposta include x-edgeoptimize-fo: true.

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

Intestazione
Traffico da bot (ottimizzato)
Traffico da persone (non interessato da modifiche)
x-edgeoptimize-request-id
Presente: contiene un ID di richiesta univoco
Assente
x-edgeoptimize-fo
Presente solo in caso di failover (valore: true)
Assente

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

Implementare le ottimizzazioni negli agenti IA - Completato

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
brand-visibility-help-main-toc