Akamai (BYOCDN)
Cette configuration achemine le trafic généré par l’IA agentique (demandes provenant de robots d’IA et d’agents utilisateurs LLM) vers le service principal Edge Optimize (live.edgeoptimize.net). Les personnes humaines et les robots d’optimisation du moteur de recherche continuent d’être servis depuis votre origine comme d’habitude. Pour tester la configuration, une fois celle-ci terminée, recherchez l’en-tête x-edgeoptimize-request-id dans la réponse.
Conditions préalables
Avant de configurer les règles du gestionnaire de propriétés Akamai, vérifiez que vous disposez des éléments suivants :
- Accès au gestionnaire de propriétés Akamai pour votre domaine.
- Clé d’API Edge Optimize récupérée à partir de l’interface d’utilisation de LLM Optimizer. Pour connaître les étapes, voir Récupération de vos clés API.
- (Facultatif) Pour tester le routage de préproduction, consultez Clé API de préproduction.
Configuration
La règle Akamai Property Manager suivante redirige le trafic des pages HTML agentiques vers Edge Optimize. La configuration contient les étapes suivantes :
1. Définir des critères de routage (correspondance de trafic Agent-utilisateur et HTML)
Définir le routage pour les agents utilisateurs suivants :
*AdobeEdgeOptimize-AI*
*ChatGPT-User*
*GPTBot*
*OAI-SearchBot*
*PerplexityBot*
*Perplexity-User*
*ClaudeBot*
*Claude-User*
*Claude-SearchBot*
html et EMPTY_STRING pour les URL de page sans extension. Si votre site diffuse HTML à partir d’autres modèles d’URL ou inclut des itinéraires sans extension hors page, tels que des points d’entrée d’API, affinez la règle avec des critères supplémentaires basés sur un chemin d’accès.
2. Définir l’origine et le comportement SSL
Définir l’origine comme live.edgeoptimize.net et faire correspondre le SAN à *.edgeoptimize.net
3. Définir la variable de clé de cache
Définir la variable de clé de cache PMUSER_EDGE_OPTIMIZE_CACHE_KEY sur LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}
4. Règles de mise en cache
5. Modifier les en-têtes des demandes entrantes
Définissez les en-têtes de requête entrante suivants :x-edgeoptimize-api-key à la clé API récupérée depuis LLMOx-edgeoptimize-config vers LLMCLIENT=TRUE;x-edgeoptimize-url à {{builtin.AK_URL}}
Autoriser l’optimisation sur Edge via des règles de pare-feu (facultatif)
Si votre réseau CDN utilise un WAF ou un gestionnaire de robots :
-
Placez sur la liste autorisée l’agent utilisateur
*AdobeEdgeOptimize/1.0*dans votre WAF ou Gestionnaire de robots afin que le service Optimize at Edge puisse récupérer votre contenu d’origine. -
Si votre pare-feu nécessite une vérification supplémentaire au-delà de l’agent utilisateur, générez un secret (par exemple,
openssl rand -hex 32) et :- Ajoutez des
x-edgeoptimize-fetcher-keyavec le secret dans vos règles de routage à côté des autres en-têtesx-edgeoptimize-*. - Ajoutez une règle WAF ou Gestionnaire de robots pour autoriser les requêtes où
x-edgeoptimize-fetcher-keycorrespond au même secret.
- Ajoutez des
-
Optimiser dans Edge transmet cet en-tête en l’état : vous êtes propriétaire du cycle de vie complet des clés.
*AdobeEdgeOptimize/1.0* et l’en-tête x-edgeoptimize-fetcher-key dans Akamai Bot Manager.6. Modifier les en-têtes de réponse entrante
7. Modification de l’ID de cache
8. Modifier Les En-Têtes De Requête Sortante
Définir l’en-tête x-forwarded-host sur {{builtin.AK_HOST}}
9. Basculement de site
La configuration de basculement de site comporte deux parties : un comportement de basculement dans la règle de routage principale Optimiser pour Edge et une règle sœur qui ajoute un en-tête de réponse lorsque le basculement se produit.
9 bis. Configuration du comportement de basculement de site
Dans la règle de routage principale Optimiser sur Edge , créez une règle enfant nommée Comportement de basculement de site. Définissez-la sur Ne correspond à aucun et ajoutez les critères suivants :
- Le code d’état de réponse est compris entre
400et599. - Le délai d’expiration d’origine est
Yes.
9 ter. Configuration de la règle d’en-tête de réponse de basculement
| code language-none |
|---|
|
Le basculement de site garantit que si Edge Optimize renvoie une erreur ou expire, Akamai recrée la demande pour votre nom d’hôte d’origine afin que le visiteur reçoive toujours la réponse habituelle du site.
2XX ou 3XXx-edgeoptimize-request-id est présent.4XX-5XX, ou l’origine expirex-edgeoptimize-fo: true.Vérifier la configuration
Une fois la configuration terminée, vérifiez que le trafic des robots est acheminé vers Edge Optimize et que le trafic humain n’est pas affecté.
1. Tester le trafic de robots (doit être optimisé)
Simulez une requête de robot d’IA à l’aide d’une chaîne utilisateur-agent :
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: chatgpt-user"
Une réponse réussie inclut l’en-tête x-edgeoptimize-request-id, confirmant que la requête a été acheminée via Edge Optimize :
< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85
2. Tester le trafic humain (ne devrait PAS être affecté)
Simulez une requête régulière de navigateur humain :
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 réponse ne doit pas contenir l’en-tête x-edgeoptimize-request-id. Le contenu de la page et le temps de réponse doivent rester identiques à avant l’activation de l’option Optimize at Edge.
3. Comment différencier les deux scénarios
x-edgeoptimize-request-idx-edgeoptimize-fotrue)Le statut du routage du trafic peut également être vérifié dans l’interface utilisateur de LLM Optimizer. Accédez à Configuration du client et sélectionnez l’onglet Configuration du réseau CDN.
Pour en savoir plus sur l’optimisation sur Edge, y compris sur les opportunités disponibles, les workflows d’optimisation automatique et les questions fréquentes, revenez à la Présentation de l’optimisation sur Edge .