Akamai (BYOCDN)

Diese Konfiguration leitet den Agentenverkehr (Anfragen von KI-Bots und LLM-Benutzeragenten) an den Backend-Service von Edge Optimize (live.edgeoptimize.net) weiter. Menschliche Besucher und SEO-Bots werden weiterhin von Ihrem Ursprung aus bedient. Um die Konfiguration zu testen, suchen Sie nach Abschluss der Einrichtung in der Antwort nach dem Header-x-edgeoptimize-request-id.

Voraussetzungen

Bevor Sie die Regeln für den Akamai Property Manager einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Zugriff auf den Akamai Property Manager für Ihre Domain.
  • Einen Edge Optimize-API-Schlüssel, der von der LLM Optimizer-Benutzeroberfläche abgerufen wurde. Anweisungen hierzu finden Sie unter Abrufen Ihrer API-Schlüssel.
  • (Optional) Informationen zum Testen des Staging-Routings finden Sie unter Staging-API-Schlüssel.

Konfiguration

Die folgende Akamai Property Manager-Regel leitet den Seitendatenverkehr von Agent HTML an Edge Optimize weiter. Die Konfiguration umfasst die folgenden Schritte:

1. Routing-Kriterien festlegen (Traffic-Übereinstimmung zwischen Benutzeragent und HTML)

Legen Sie das Routing für die folgenden Benutzeragenten fest:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
NOTE
Wenden Sie die Routingregel „Optimieren bei Edge" nur auf den agenten HTML-Seiten-Traffic an. Bei einer gängigen Einrichtung werden anforderungsseitige Kriterien wie "" verwendet um html und EMPTY_STRING für Seiten-URLs ohne Erweiterung abzugleichen. Wenn Ihre Site HTML über andere URL-Muster bereitstellt oder erweiterungslose Nicht-Seiten-Routen wie API-Endpunkte enthält, verfeinern Sie die Regel mit zusätzlichen pfadbasierten Kriterien.

Festlegen von Routing-Kriterien

2. Festlegen der Herkunft und des SSL-Verhaltens

Herkunft als live.edgeoptimize.net festlegen und SAN an *.edgeoptimize.net anpassen

NOTE
Wenn die Eigenschaftenaktivierung nach dem Hinzufügen der Regel „Optimieren bei Edge" fehlschlägt, überprüfen Sie, ob die Regel einen anderen SSL-Verifizierungsmodus für den Ursprungs-Server verwendet als die Standardregel. Wenn dies der Fall ist, aktualisieren Sie die Regel „Optimieren unter Edge", um sie an die Standardregel anzupassen. Wenn die Standardregel beispielsweise "" verwendet verwenden Sie auch Plattformeinstellungen hier. Wenn Sie die erforderliche Einstellung nicht verwenden können, wenden Sie sich an den Akamai-Support.

Festlegen der Herkunft und des SSL-Verhaltens

3. Festlegen der Cache-Schlüsselvariablen

Legen Sie die Cache-Schlüsselvariable PMUSER_EDGE_OPTIMIZE_CACHE_KEY auf LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}} fest.

Festlegen der Cache-Schlüsselvariablen

4. Caching-Regeln

Caching-Regeln

5. Ändern der eingehenden Anfrage-Header

Legen Sie die folgenden Header für eingehende Anfragen fest:
x-edgeoptimize-api-key zum von LLMO abgerufenen API-Schlüssel
x-edgeoptimize-config in LLMCLIENT=TRUE;
x-edgeoptimize-url zu {{builtin.AK_URL}}

Ändern der eingehenden Anfrage-Header

Zulassen, dass in Edge durch Firewall-Regeln optimiert wird (optional)

Wenn Ihr CDN einen WAF oder Bot Manager verwendet:

  • Zulassungsliste des *AdobeEdgeOptimize/1.0*-Benutzeragenten in WAF oder Bot-Manager, damit der Service „Optimieren unter Edge" Ihre Ursprungs-Inhalte abrufen kann.

  • Wenn Ihre Firewall eine zusätzliche Überprüfung über den Benutzeragenten hinaus erfordert, generieren Sie ein Geheimnis (z. B. openssl rand -hex 32) und:

    • Fügen Sie x-edgeoptimize-fetcher-key mit dem Geheimnis in Ihren Routing-Regeln zusammen mit den anderen x-edgeoptimize-* Kopfzeilen hinzu.
    • Fügen Sie eine WAF- oder Bot-Manager-Regel hinzu, um Anfragen zuzulassen, bei denen x-edgeoptimize-fetcher-key mit demselben Geheimnis übereinstimmt.
  • Bei Edge optimieren leitet diese Kopfzeile unverändert weiter - Sie besitzen den gesamten Schlüssellebenszyklus.

Legen Sie die Kopfzeile „x-edgeOptimize-fetcher-key“ im Eigenschaften-Manager fest

NOTE
Zulassungsliste des *AdobeEdgeOptimize/1.0*-Benutzeragenten und der x-edgeoptimize-fetcher-key-Kopfzeile in Akamai Bot Manager.

6. Ändern der eingehenden Antwort-Header

Ändern der eingehenden Antwort-Header

7. Cache-ID-Änderung

Cache-ID-Änderung

8. Ausgehende Anfragekopfzeilen ändern

x-forwarded-host-Header auf {{builtin.AK_HOST}} setzen

Ausgehende Anfragekopfzeilen ändern

9. Site-Failover

Die Site-Failover-Konfiguration besteht aus zwei Teilen: dem Failover-Verhalten (konfiguriert innerhalb der Haupt-Routingregel „Optimize-at-Edge„) und einer separaten Header-Regel für den Failover-Test.

9a. Site-Failover-Verhalten (innerhalb der Haupt-Routingregel „optimize-at-edge„)

Konfigurieren Sie innerhalb der Haupt-Routing-Regel das Verhalten bei Site-Failover und das erweiterte XML-Snippet wie folgt:

IMPORTANT
Das XML-Fragment in diesem Schritt erfordert das Erweitert-Verhalten. In einigen Akamai-Umgebungen ist dieses Verhalten nicht für die Self-Service-Bearbeitung verfügbar. Wenn die Option Erweitert nicht angezeigt wird, wenden Sie sich an Ihr Akamai-Account-Team oder den Akamai-Support, um die erforderliche Konfiguration zu aktivieren.

Site-Failover

Fügen Sie die Anfrage-Header-x-edgeoptimize-request mit dem Wert hinzu, der über Erweiterte XML fo wird:

<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>

Failover-Verhalten

9b. Failovertest-Header-Regel (gleichrangige Regel)

IMPORTANT
Erstellen Sie die EdgeOptimize-Failover Test-Header Regel als gleichrangiges (auf derselben Ebene) der Routing-Regeln - nicht in ihnen verschachtelt. In der Regelstruktur des Akamai Property Managers sollte die Hierarchie wie folgt aussehen:
code language-none
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
Dadurch wird sichergestellt, dass die Header-Regel des Failovertests für alle Routingregeln und nicht nur für eine bewertet wird.
Stellen Sie außerdem sicher dass die Regel „Optimieren bei Edge-Routing nicht durch eine spätere Übereinstimmungsregel überschrieben wird, die den Ursprung, das Caching-Verhalten oder die Cache-ID für dieselben Anfragen ändert. Wenn diese Verhaltensweisen durch eine andere übereinstimmende Regel zurückgesetzt werden, funktioniert das Routing oder Caching von Optimieren bei Edge möglicherweise nicht wie erwartet.

Wenn der x-edgeoptimize-request für die Anfrage fo ist, setzen Sie die x-edgeoptimize-fo für die ausgehende Antwort auf true.

Failover-Regeln

Site Failover stellt sicher, dass die Anfrage automatisch an Ihren Standardursprung zurückgeleitet wird, wenn Edge Optimize einen 4XX- oder 5XX zurückgibt, sodass der Endbenutzer weiterhin eine Antwort erhält.

Szenario
Verhalten
Edge Optimize gibt 2XX zurück
Der Client erhält eine optimierte Antwort.
Edge Optimize gibt 4XX oder 5XX zurück
Die Anfrage wird an den Standardursprung zurückgeleitet.

Überprüfen Sie das Setup

Stellen Sie nach Abschluss des Setups sicher, dass Bot-Traffic an Edge Optimize weitergeleitet wird und dass der menschliche Traffic nicht betroffen ist.

1. Bot-Traffic testen (sollte optimiert werden)

Simulieren einer KI-Bot-Anfrage mithilfe eines agenten Benutzeragenten:

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

Eine erfolgreiche Antwort enthält den x-edgeoptimize-request-id-Header, der bestätigt, dass die Anfrage über Edge Optimize weitergeleitet wurde:

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

2. Testen des menschlichen Traffics (sollte NICHT betroffen sein)

Simulieren Sie eine normale menschliche Browser-Anfrage:

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"

Die Antwort sollte nicht den x-edgeoptimize-request-id-Header enthalten. Seiteninhalt und Antwortzeit sollten vor der Aktivierung von Optimieren bei Edge identisch mit bleiben.

3. Wie lassen sich die beiden Szenarien voneinander unterscheiden

Kopfzeile
Bot-Traffic (optimiert)
Menschlicher Verkehr (nicht betroffen)
x-edgeoptimize-request-id
Präsenz - enthält eine eindeutige Anfrage-ID
Abwesend
x-edgeoptimize-fo
Nur vorhanden, wenn Failover aufgetreten ist (Wert: 1)
Abwesend

Der Status des Traffic-Routings kann auch in der LLM Optimizer-Benutzeroberfläche überprüft werden. Navigieren Sie zu Kundenkonfiguration und wählen Sie die Registerkarte CDN-Konfiguration aus.

Optimierung für KI-Agenten bereitstellen - abgeschlossen

Weitere Informationen zu „Optimieren bei Edge", einschließlich verfügbarer Opportunitys, Workflows für die automatische Optimierung und häufig gestellte Fragen, finden Sie unter "​ bei Edge - Überblick.

recommendation-more-help
llm-optimizer-help-main-toc