Akamai(BYOCDN)
이 구성은 에이전틱 트래픽(AI 봇 및 LLM 사용자 에이전트의 요청)을 Edge Optimize 백엔드 서비스(live.edgeoptimize.net)로 라우팅합니다. 사람 방문자와 SEO 봇은 기존과 동일하게 사용자의 원본 서버에서 계속 제공됩니다. 구성을 테스트하려면 설정이 완료된 후 응답에서 헤더 x-edgeoptimize-request-id를 찾습니다.
사전 요구 사항
Akamai Property Manager 규칙을 설정하기 전에 다음을 확인하십시오.
- 도메인에 대한 Akamai Property Manager 액세스
- LLM Optimizer 온보딩 프로세스 완료
- LLM Optimizer로 CDN 로그 전달 완료
- LLM Optimizer UI에서 검색한 Edge Optimize API 키
- (선택 사항) 스테이징 라우팅을 테스트하려면 선택 사항: 이 페이지의 끝에 있는 스테이징 호스트 이름에서 라우팅 테스트를 참조하십시오.
프로덕션 Edge 최적화 API 키를 검색하는 단계:
-
LLM Optimizer에서 고객 구성을 열고 CDN 구성 탭을 선택합니다.
-
AI 에이전트에 최적화 배포 섹션을 찾습니다. 최적화 엔진 활성화 확인란을 선택합니다.
-
확인 대화 상자에서 활성화를 선택합니다.
-
세부 정보 보기를 선택합니다. 최적화 배포 세부 정보 대화 상자에서 프로덕션 API 키을(를) 복사합니다(필드 옆 사용).
note NOTE 대화 상자에서 설정이 완료되지 않았음을 보여줄 수 있습니다. 이는 라우팅을 확인할 때까지 발생합니다. IT 또는 CDN 팀이 구성을 완료할 수 있도록 API 키를 복사할 수 있습니다.
또한 위 단계에 대한 도움이 필요한 경우 Adobe 계정 팀 또는 llmo-at-edge@adobe.com에 문의하십시오.
구성
다음 Akamai Property Manager 규칙은 에이전틱 HTML 페이지 트래픽을 Edge Optimize로 라우팅합니다. 구성에는 다음 단계가 포함됩니다.
1. 라우팅 기준 설정(사용자 에이전트 및 HTML 트래픽 일치)
다음 사용자 에이전트에 대한 라우팅을 설정합니다.
*AdobeEdgeOptimize-AI*
*ChatGPT-User*
*GPTBot*
*OAI-SearchBot*
*PerplexityBot*
*Perplexity-User*
html 및 EMPTY_STRING을 일치시키기 위해 파일 확장자와 같은 요청 측 기준을 사용하는 것입니다. 사이트가 다른 URL 패턴에서 HTML을 제공하거나 API 엔드포인트와 같이 확장자 없는 비페이지 경로를 포함하는 경우, 추가 경로 기반 기준으로 규칙을 세분화합니다.
2. 원본 및 SSL 동작 설정
원본을 live.edgeoptimize.net으로 설정하고 SAN을 *.edgeoptimize.net으로 일치시킵니다.
3. 캐시 키 변수 설정
캐시 키 변수 PMUSER_EDGE_OPTIMIZE_CACHE_KEY를 LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}로 설정합니다.
4. 캐싱 규칙
5. 수신 요청 헤더 수정
다음 수신 요청 헤더를 설정합니다.x-edgeoptimize-api-key를 LLMO에서 가져온 API 키로 설정하고,x-edgeoptimize-config를 LLMCLIENT=TRUE;로 설정하며,x-edgeoptimize-url을 {{builtin.AK_URL}}로 설정합니다.
방화벽 규칙을 통해 Edge에서 최적화 허용(선택 사항)
CDN에서 WAF 또는 보트 관리자를 사용하는 경우:
-
Edge 서비스에서 최적화 서비스를 통해 원본 콘텐츠를 가져올 수 있도록 WAF 또는 봇 관리자에서
*AdobeEdgeOptimize/1.0*사용자 에이전트를 최적화합니다. -
방화벽에 사용자 에이전트 이외의 추가 확인이 필요한 경우 암호를 생성하고(예:
openssl rand -hex 32):- 다른
x-edgeoptimize-*헤더와 함께 라우팅 규칙에 암호가 포함된x-edgeoptimize-fetcher-key을(를) 추가합니다. x-edgeoptimize-fetcher-key이(가) 같은 암호와 일치하는 요청을 허용하도록 WAF 또는 보트 관리자 규칙을 추가합니다.
- 다른
-
Edge에서 최적화 는 이 헤더를 있는 그대로 전달합니다. — 전체 키 라이프사이클을 소유합니다.
*AdobeEdgeOptimize/1.0* 사용자 에이전트 및 x-edgeoptimize-fetcher-key Akamai Bot 관리자도 허용 목록에 추가하다합니다.6. 수신 응답 헤더 수정
7. 캐시 ID 수정
8. 발신 요청 헤더 수정
x-forwarded-host 헤더를 {{builtin.AK_HOST}}로 설정합니다.
9. 사이트 장애 조치(Failover)
사이트 장애 조치(Failover) 구성에는 장애 조치 비헤이비어(기본 optimize-at-edge 라우팅 규칙 내에서 구성됨)과 별도의 장애 조치 테스트 헤더 규칙이 있습니다.
9a. 사이트 장애 조치(Failover) 비헤이비어(기본 optimize-at-edge 라우팅 규칙 내)
기본 라우팅 규칙 내에서 다음과 같이 사이트 장애 조치(Failover) 비헤이비어와 고급 XML 스니펫을 구성합니다.
고급 XML을 통해 값이 fo인 요청 헤더 x-edgeoptimize-request를 추가합니다.
<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>
9b. 장애 조치(Failover) 테스트 헤더 규칙(형제 규칙)
| code language-none |
|---|
|
요청 헤더 x-edgeoptimize-request 값이 fo인 경우, 발신 응답 헤더 x-edgeoptimize-fo를 true로 설정합니다.
사이트 장애 조치(Failover)는 Edge Optimize가 4XX 또는 5XX 오류를 반환하는 경우, 요청이 자동으로 기본 원본으로 라우팅되어 최종 사용자가 응답을 계속 받게 됩니다.
2XX를 반환합니다.4XX 또는 5XX를 반환합니다.설정 확인
설정을 완료한 후 봇 트래픽이 Edge Optimize로 라우팅되고 있으며 사람 트래픽이 영향을 받지 않는지 확인합니다.
1. 봇 트래픽 테스트(최적화해야 함)
에이전틱 사용자 에이전트를 사용하여 AI 봇 요청을 시뮬레이션합니다.
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: chatgpt-user"
성공적인 응답에는 요청이 Edge Optimize를 통해 라우팅되었음을 확인하는 x-edgeoptimize-request-id 헤더가 포함됩니다.
< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85
2. 사람 트래픽 테스트(영향을 받지 않아야 함)
일반 사람 브라우저 요청을 시뮬레이션합니다.
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"
응답에는 x-edgeoptimize-request-id 헤더가 없어야 합니다. 페이지 콘텐츠와 응답 시간은 Optimize at Edge를 활성화하기 전과 동일하게 유지되어야 합니다.
3. 두 시나리오를 구분하는 방법
x-edgeoptimize-request-idx-edgeoptimize-fo1).LLM Optimizer UI에서 트래픽 라우팅 상태를 확인할 수도 있습니다. 고객 구성(으)로 이동하고 CDN 구성 탭을 선택합니다.
선택 사항: 스테이징 호스트 이름에서 라우팅을 테스트합니다
프로덕션 라우팅을 활성화하기 전에 더 낮은 환경에서 라우팅을 확인하려는 경우 스테이징 호스트 이름을 구성할 수 있습니다.
요구 사항
- 스테이징 호스트 이름은 프로덕션과 동일한 등록 가능한 도메인에 있어야 합니다(예: 프로덕션이
https://www.example.com인 경우https://staging.example.com). - 사이트당 one 스테이징 도메인만. 저장되면 Adobe에 문의하지 않으면 변경할 수 없습니다.
스테이징 API 키 가져오기
- 고객 구성을 열고 CDN 구성을 선택합니다.
- AI 에이전트에 최적화 배포에서 단계 도메인 추가(또는 스테이징 도메인이 이미 구성된 경우 단계 도메인)를 선택합니다.
https://을(를) 포함한 전체 스테이징 URL을 입력하고 도메인 설정을(를) 선택하십시오.- 확인 대화 상자에서 스테이징 API 키를 복사합니다.
스테이징 API 키를 사용하여 스테이징 환경에 동일한 라우팅 규칙을 배포합니다.
스테이징 보트 트래픽 테스트
https://staging.example.com/page.html을 실제 스테이징 URL 및 경로로 바꿉니다. 성공: 응답에 x-edgeoptimize-request-id 헤더가 포함되어 있습니다.
도움이 필요하면 llmo-at-edge@adobe.com에 문의하세요.
curl -svo /dev/null https://staging.example.com/page.html \
--header "user-agent: chatgpt-user"
사용 가능한 기회, 자동 최적화 워크플로 및 FAQ를 포함하여 Edge에서 최적화에 대해 자세히 알아보려면 Edge에서 최적화 개요로 돌아가십시오.