설명서AEM사용 안내서

사이트 카탈로그 스킬 site-catalog-skill

마지막 업데이트: 2026년 6월 4일
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • User
  • Admin
  • Developer

Experience 현대화 에이전트의 사이트 카탈로그 스킬이 Edge Delivery Services 마이그레이션 계획을 지원하기 위해 기존 웹 사이트를 자동으로 분석하는 방법에 대해 알아봅니다.

개요 overview

사이트 카탈로그 기술은 사이트의 모든 페이지를 검색하고, 사용 중인 페이지 템플릿과 블록 변형을 식별하고, 각 페이지의 스크린샷을 캡처하고, 콘솔 미리 보기 탭에서 찾아보거나 로컬로 다운로드하여 열 수 있는 대화형 HTML 보고서 번들을 생성합니다.

이 기술은 다음과 같은 방법으로 사용자와 기존 프로젝트를 Edge Delivery Services으로 마이그레이션하는 것을 지원합니다.

  • 마이그레이션 프로젝트 시작 - 페이지 수, 템플릿, 블록 변형, 로케일을 포함하여 사이트의 규모에 대한 파악을 시작하기 전에 스킬을 실행합니다. 다운스트림 결정이 종속될 때마다 기준선 인벤토리를 설정합니다.
  • 작업량 예상 및 계획 - 제안, 스프린트 계획 및 리소스 계산을 지원하도록 수량화된 지표를 가져옵니다.
  • 일괄 가져오기 준비 — template-catalog.json을(를) 사용하여 동일한 레이아웃을 공유하는 페이지를 식별하고 템플릿별로 일괄 가져오기를 계획합니다.
  • 관련자 보고 - 대화형 HTML 보고서 번들을 프로젝트 관리자, 설계자 및 비즈니스 이해 당사자와 공유합니다.

호출 중 invoking

Experience Modernation Console에서 ​은(는) 자연어를 사용하여 에이전트에게 사이트 카탈로그를 만들도록 요청합니다. 다음은 프롬프트 예입니다.

  • scope site https://www.example.com
  • site scope https://www.example.com
  • analyze https://www.example.com
  • find templates on https://www.example.com
  • discover templates on https://www.example.com
  • catalog site https://www.example.com
  • how many page types are there on https://www.example.com
  • what are the layouts on https://www.example.com
  • analyze site structure of https://www.example.com

스킬의 워크플로에는 순서대로 실행되는 네 가지 단계가 있습니다.

  1. 분석
  2. 템플릿
  3. 조정
  4. 카탈로그 차단

모든 단계를 재생할 수 있으며, 에이전트는 해당 단계의 출력과 모든 다운스트림 출력을 지운 다음 해당 시점부터 다시 시작합니다. 다음은 단계 재생에 대한 몇 가지 예제 메시지입니다.

  • Repeat analyzing / Redo page analysis / Rerun analyze pages
  • Repeat templating / Redo the template discovery step / Restart the templating step
  • Repeat tuning / Rerun tune templates / Redo template tuning
  • Repeat block cataloging / Restart catalog block variants

단계를 재생하면 이전 단계가 유지됩니다.

출력 output

스킬이 사이트의 카탈로그를 완료한 경우 세 가지 유형의 출력을 받습니다.

  1. 합계(페이지, 템플릿, EDS 매핑 및 사용자 지정 분류가 있는 블록 변형), 로케일 분류, 적용 범위 비율, 전체 보고서 상태(완료/미완료/실패)를 포함한 채팅의 완료 요약

  2. 대화형 HTML 보고서 번들​을(를) 기본 결과물로, catalog/template-catalog-report-bundle.zip에 저장함

    • 번들에는 template-catalog-report.html과(와) 참조된 모든 스크린샷과 자산이 포함되어 있습니다.
    • 번들을 다운로드하여 로컬에서 보거나 공유할 수 있습니다.
    • 또는 에이전트에게 Move template-catalog-report-bundle.zip to the /content folder to render it in the preview tab. Update all references as needed.에게 요청하여 콘솔에서 보고서를 볼 수 있습니다.

  3. summary.json, template-catalog.json, block-catalog.json, urls-all.json, urls-grouped.json, urls-checklist.json, .pages/, .blocks/을(를) 포함하여 다운스트림 기술 및 프로그래밍 용도로 catalog/의 구조화된 JSON 아티팩트

카탈로그 폴더 컨텐츠 contents

구조화된 JSON 아티팩트는 스킬에 의해 catalog/에 저장됩니다.

파일
설명
template-catalog-report-bundle.zip
대화형 HTML 보고서 번들(주요 결과물)
summary.json
롤업 지표 및 보고서 상태
template-catalog.json
각각 사용하는 URL이 있는 모든 고유 템플릿(일괄 가져오기에 사용됨)
block-catalog.json
메타데이터 및 스크린샷 참조가 포함된 모든 블록 변형
urls-all.json
검색된 모든 URL
urls-grouped.json
패턴 및 로케일별로 그룹화된 URL
urls-sample.json
분석을 위해 샘플링된 대표 URL
urls-checklist.json
URL당 분석 상태
catalog.log
실행 로그
.pages/<page-slug>/page-catalog.json
페이지 수준 분석 출력
.pages/<page-slug>/full-page.jpg
전체 페이지 스크린샷
.pages/<page-slug>/blocks/<block-name>.jpg
블록별 스크린샷
.pages/_global/header.json + header.jpg
글로벌 헤더 분석 및 스크린샷
.pages/_global/footer.json + footer.jpg
글로벌 바닥글 분석 및 스크린샷
.blocks/<variantId>/metadata.json
변형 메타데이터 차단
.blocks/<variantId>/screenshots/<name>.jpg
변형 스크린샷 차단

보고서 상태 status

summary.json의 status 필드는 다음과 같을 수 있습니다.

상태
의미
complete
모든 페이지가 성공적으로 분석되었습니다(또는 10% 이하의 실패율이 있음).
incomplete
10% 이상의 페이지가 실패하거나 50% 이상의 페이지에서 블록 감지가 충돌했습니다. 출력은 계속 사용할 수 있지만 일부는 사용할 수 있습니다.
failed
페이지가 성공적으로 분석되지 않았습니다.

대규모 사이트에 대한 샘플링 sampling

기본적으로 스킬은 딥페이지 분석을 1000개의 URL로 제한합니다. 최대 1000개의 URL을 포함하는 사이트의 경우 모든 페이지가 분석됩니다.

URL이 1000개가 넘는 사이트의 경우 에이전트가 일시 중지되어 진행 방법을 묻습니다.

  • 샘플링 상한 늘리기(최대 4000개의 URL)
  • 특정 그룹만 분석(예: /products/* 또는 /blog/*)
  • 모든 URL을 분석하고 샘플링 없이 전체 사이트를 실행합니다.

URL 검색은 샘플 제한에 관계없이 항상 전체 사이트를 포함합니다. 심층 페이지당 분석 단계만 제한됩니다.

모든 페이지를 재정의하고 분석하려면 에이전트에게 다음과 같이 알립니다.

  • analyze all URLs
  • analyze everything
  • analyze every page
  • run the full site

일괄 가져오기 워크플로우 bulk-import

사이트 카탈로그 기술은 전체 사이트를 마이그레이션하는 데 권장되는 접근 방식의 일부입니다.

  1. 사이트 카탈로그 스킬을 실행하여 전체 템플릿 카탈로그를 가져오고 블록 카탈로그를 가져옵니다.
  2. HTML 보고서 번들을 열어 에이전트가 식별한 템플릿을 시각적으로 검토합니다.
  3. 각 템플릿에 대해 template-catalog.json에 나열된 대표 페이지를 수동으로 가져와서 출력이 정확해질 때까지 가져오기를 구체화합니다.
  4. template-catalog.json의 URL 목록을 사용하여 해당 템플릿의 나머지 페이지를 일괄 가져옵니다.
  5. 전체 사이트가 마이그레이션될 때까지 각 템플릿에 대해 이 작업을 반복합니다.

제한 사항 limitations

사이트 카탈로그 스킬에는 다음과 같은 제한 사항이 있습니다.

  • 공개 사이트만 — 대상을 공개적으로 액세스할 수 있어야 합니다(인증, VPN 또는 방화벽 없음).
  • 다이내믹 콘텐츠가 지원되지 않음 — DOM에 표시되어야 하는 사용자 상호 작용이 필요한 콘텐츠는 캡처되지 않을 수 있습니다.
  • 기본 1000 URL 제한 - 딥분석 단계는 기본적으로 1000개의 URL로 제한되며, 재정의할 수 있습니다 최대 4000개의 URL까지.
recommendation-more-help
experience-manager-cloud-service-help-main-toc