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 키를 검색하는 단계:

  1. LLM Optimizer에서 고객 구성​을 열고 CDN 구성 탭을 선택합니다.

    고객 구성으로 이동

  2. AI 에이전트에 최적화 배포 섹션을 찾습니다. 최적화 엔진 활성화 확인란을 선택합니다.

    AI 에이전트에 최적화 배포 — 보류 중

  3. 확인 대화 상자에서 활성화​를 선택합니다.

    최적화 엔진 확인 대화 상자 활성화

  4. 세부 정보 보기​를 선택합니다. 최적화 배포 세부 정보 대화 상자에서 프로덕션 API 키​을(를) 복사합니다(필드 옆 사용).

    배포 최적화 세부 정보의 프로덕션 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*
NOTE
Optimize at Edge 라우팅 규칙을 에이전틱 HTML 페이지 트래픽에만 적용합니다. 일반적인 설정은 확장자가 없는 페이지 URL에 대해 htmlEMPTY_STRING을 일치시키기 위해 파일 확장자​와 같은 요청 측 기준을 사용하는 것입니다. 사이트가 다른 URL 패턴에서 HTML을 제공하거나 API 엔드포인트와 같이 확장자 없는 비페이지 경로를 포함하는 경우, 추가 경로 기반 기준으로 규칙을 세분화합니다.

라우팅 기준 설정

2. 원본 및 SSL 동작 설정

원본을 live.edgeoptimize.net으로 설정하고 SAN을 *.edgeoptimize.net으로 일치시킵니다.

NOTE
Edge에서 최적화 규칙을 추가한 후 속성 활성화에 실패하는 경우, 규칙이 기본 규칙과 다른 원본 서버 SSL 확인 모드를 사용하는지 여부를 확인하십시오. 이 경우 기본 규칙과 일치하도록 Edge에서 최적화 규칙을 업데이트해야 합니다. 예를 들어 기본 규칙에서 플랫폼 설정​을 사용한다면 여기에서도 플랫폼 설정​을 사용하십시오. 필요한 설정을 사용할 수 없다면 Akamai 지원 센터에 문의하십시오.

원본 및 SSL 동작 설정

3. 캐시 키 변수 설정

캐시 키 변수 PMUSER_EDGE_OPTIMIZE_CACHE_KEYLLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}로 설정합니다.

캐시 키 변수 설정

4. 캐싱 규칙

캐싱 규칙

5. 수신 요청 헤더 수정

다음 수신 요청 헤더를 설정합니다.
x-edgeoptimize-api-key를 LLMO에서 가져온 API 키로 설정하고,
x-edgeoptimize-configLLMCLIENT=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에서 최적화 는 이 헤더를 있는 그대로 전달합니다. — 전체 키 라이프사이클을 소유합니다.

속성 관리자에서 x-edgeoptimize-fetcher-key 헤더 설정

NOTE
*AdobeEdgeOptimize/1.0* 사용자 에이전트 및 x-edgeoptimize-fetcher-key Akamai Bot 관리자도 허용 목록에 추가하다합니다.

6. 수신 응답 헤더 수정

수신 응답 헤더 수정

7. 캐시 ID 수정

캐시 ID 수정

8. 발신 요청 헤더 수정

x-forwarded-host 헤더를 {{builtin.AK_HOST}}로 설정합니다.

발신 요청 헤더 수정

9. 사이트 장애 조치(Failover)

사이트 장애 조치(Failover) 구성에는 장애 조치 비헤이비어(기본 optimize-at-edge 라우팅 규칙 내에서 구성됨)과 별도의 장애 조치 테스트 헤더 규칙이 있습니다.

9a. 사이트 장애 조치(Failover) 비헤이비어(기본 optimize-at-edge 라우팅 규칙 내)

기본 라우팅 규칙 내에서 다음과 같이 사이트 장애 조치(Failover) 비헤이비어와 고급 XML 스니펫을 구성합니다.

IMPORTANT
이 단계의 XML 스니펫에는 고급 비헤이비어가 필요합니다. 일부 Akamai 환경에서는 이 비헤이비어를 셀프서비스 편집에서 사용할 수 없습니다. 고급 옵션이 표시되지 않는 경우에는 Akamai 계정 팀이나 Akamai 지원 센터에 연락하여 필요한 구성을 활성화하십시오.

사이트 장애 조치(Failover)

고급 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>

장애 조치(Failover) 동작

9b. 장애 조치(Failover) 테스트 헤더 규칙(형제 규칙)

IMPORTANT
라우팅 규칙의 형제(동일한 수준)로서 EdgeOptimize 장애 조치(Failover) - 테스트 헤더 규칙을 만듭니다. 이 규칙들은 중첩되지 않습니다. Akamai Property Manager 규칙 트리에서 계층은 다음과 같아야 합니다.
code language-none
▼ Parent Rule
      ▶ Optimize at Edge Routing     ← routing rule
          EdgeOptimize Failover - Test Header       ← sibling, same level
이렇게 하면 장애 조치 테스트 헤더 규칙이 하나의 라우팅 규칙뿐만 아니라 모든 라우팅 규칙에 대해 평가됩니다.
또한 동일한 요청에 대해 원본, 캐싱 비헤이비어 또는 캐시 ID를 변경하는 향후 매칭 규칙에 의해 Edge 라우팅에서 최적화 규칙이 재정의되지 않도록 하십시오. 다른 매칭 규칙이 이들 비헤이비어를 재설정하면 Edge 라우팅 또는 캐싱에서 최적화가 예상대로 작동하지 않을 수 있습니다.

요청 헤더 x-edgeoptimize-request 값이 fo인 경우, 발신 응답 헤더 x-edgeoptimize-fotrue로 설정합니다.

장애 조치(Failover) 규칙

사이트 장애 조치(Failover)는 Edge Optimize가 4XX 또는 5XX 오류를 반환하는 경우, 요청이 자동으로 기본 원본으로 라우팅되어 최종 사용자가 응답을 계속 받게 됩니다.

시나리오
비헤이비어
Edge Optimize는 2XX를 반환합니다.
최적화된 응답을 클라이언트에 제공합니다.
Edge Optimize는 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-id
있음 — 고유한 요청 ID가 포함되어 있습니다.
없음
x-edgeoptimize-fo
장애 조치가 발생한 경우에만 표시됩니다(값: 1).
없음

LLM Optimizer UI에서 트래픽 라우팅 상태를 확인할 수도 있습니다. 고객 구성(으)로 이동하고 CDN 구성 탭을 선택합니다.

AI 에이전트에 최적화 배포 — 완료됨

선택 사항: 스테이징 호스트 이름에서 라우팅을 테스트합니다

프로덕션 라우팅을 활성화하기 전에 더 낮은 환경에서 라우팅을 확인하려는 경우 스테이징 호스트 이름을 구성할 수 있습니다.

요구 사항

  • 스테이징 호스트 이름은 프로덕션과 동일한 등록 가능한 도메인​에 있어야 합니다(예: 프로덕션이 https://www.example.com인 경우 https://staging.example.com).
  • 사이트당 one 스테이징 도메인만. 저장되면 Adobe에 문의하지 않으면 변경할 수 없습니다.

스테이징 API 키 가져오기

  1. 고객 구성​을 열고 CDN 구성​을 선택합니다.
  2. AI 에이전트에 최적화 배포​에서 단계 도메인 추가(또는 스테이징 도메인이 이미 구성된 경우 단계 도메인)를 선택합니다.
  3. https://을(를) 포함한 전체 스테이징 URL을 입력하고 도메인 설정​을(를) 선택하십시오.
  4. 확인 대화 상자에서 스테이징 API 키를 복사합니다.

스테이징 도메인 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에서 최적화 개요로 돌아가십시오.

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