인프라 설정 create-first-app

IMPORTANT
Adobe LLM Apps이(가) 현재 Beta에 있습니다.
여기에 표시된 기능, 워크플로우 및 UI가 반드시 제품의 최종 상태를 나타내지는 않습니다. Beta에 참여하려면 llm-apps-beta@adobe.com으로 이메일을 보내십시오.

인프라는 앱을 위한 기술적 기반입니다. 즉, 코드를 저장하는 저장소와 작업 핸들러를 실행하고 사용자에게 위젯을 전달하는 서비스입니다.

개요에 설명된 대로 작업 처리기​가 제품 찾기와 같은 작업을 수행하는 반면 위젯​은(는) 그 결과를 대화의 대화형 경험으로 표시합니다.

LLM Apps은(는) 처리기 및 위젯 소스 코드를 두 개의 별도 GitHub 저장소에 저장합니다.

  • 작업 리포지토리 — 서버측 처리기와 해당 테스트가 포함되어 있습니다.
  • 위젯 리포지토리 — 대화형 위젯의 코드와 스타일을 포함합니다.

예를 들어 제품 검색 처리기는 일치하는 제품을 검색하고 해당 위젯에 제품 카드로 표시됩니다. 저장소는 해당 코드를 저장합니다. Adobe I/O Runtime은 배포된 처리기를 실행하고 Edge Delivery Services은 위젯을 제공합니다.

설정 마법사는 이러한 저장소를 준비하고 앱에 필요한 서비스를 연결합니다. 가장 빠른 시작 방법인 Adobe 관리 인프라​로 시작하는 것이 좋습니다. Adobe은 작업 핸들러 및 위젯에 대한 저장소를 생성하고 호스팅합니다. 저장소를 직접 설정할 필요가 없습니다.

또는 사용자 계정 또는 조직에 빈 GitHub 저장소 두 개를 제공합니다. 플랫폼은 필요한 프로젝트 파일로 초기화하므로 미리 작업 또는 위젯 코드를 준비할 필요가 없습니다.

이 안내서: 인프라 옵션을 선택하고 설치 마법사로 앱을 만드는 방법을 알아봅니다. 설치 후 작업 만들기를 계속합니다.

앱을 만드는 동안 작업 생성이 시작되지​않습니다. 앱 페이지와 별도로 작업 생성을 시작합니다.

앱 만들기 마법사를 엽니다.

Adobe LLM 앱을 엽니다. 시작 페이지에서 시작​을 선택합니다. 이미 열려 있는 앱이 있는 경우 앱 선택기를 사용하여 새 앱 만들기​를 선택합니다.

LLM 앱 만들기 마법사는 시작(으)로 시작합니다. 기술 환경을 설정하는 방법을 선택합니다.

LLM 앱 만들기 — Adobe 관리 인프라와 고유한 저장소 연결 중 선택

인프라 옵션
마법사에서 선택
의미
Adobe 관리 인프라
처리하게 해 주세요
Adobe은 앱에 대한 저장소 및 연결된 서비스를 만들고 관리합니다. 요청에 따라 코드 액세스를 사용할 수 있습니다.
자신의 저장소
직접 설정하겠습니다
두 개의 빈 GitHub 저장소를 제공하고 마법사를 통해 액세스 권한을 부여합니다. 플랫폼은 작업 처리기에 대해 하나를 초기화하고 위젯에 대해 다른 하나를 초기화합니다.

두 옵션 모두 나중에 자동 작업 생성을 지원합니다. 두 옵션 모두 작업을 수동으로 쓸 필요가 없습니다.

Adobe 관리 인프라 사용 adobe-managed-infrastructure

이 옵션을 사용하여 Adobe에서 앱에 대한 저장소 및 연결된 서비스를 설정하고 관리하도록 할 수 있습니다. 저장소를 만들거나 GitHub 앱을 직접 설치할 필요가 없습니다.

  1. 처리 허용​을 선택하세요.
  2. 다음 단계​를 선택합니다.
  3. 앱 세부 정보를 완료합니다.
  4. 앱 만들기​를 선택합니다.

Adobe이 저장소를 준비하고 위젯 사이트를 연결하는 동안 앱 페이지에는 앱 설정​이 표시됩니다. UI는 일반적으로 설정이 1~2분 정도 소요됨을 나타냅니다. 작업, 테스트 및 배포는 설정이 준비될 때까지 사용할 수 없습니다.

앱 설정 — Adobe에서 앱 인프라를 준비하는 중입니다

설치에 실패하면 오류를 읽고 다시 시도​를 선택하세요. 페이지에서 진행률을 확인할 수 없는 경우 백그라운드에서 설치를 계속합니다. 다시 확인​을 선택하여 다시 연결합니다.

설치가 완료되면 작업 만들기를 계속합니다.

자신의 저장소 연결 your-own-repositories

직접 설정하겠습니다, 다음 단계​를 선택하십시오. 이 경로에는 네 가지 마법사 단계가 있습니다.

→ 인프라 설정 → 위젯 인프라 설정 → 앱 세부 정보를 시작합니다.

필요한 GitHub 앱을 설치하거나 구성하려면 선택한 저장소에 대한 액세스 권한과 권한이 필요합니다. 조직 소유 저장소의 경우 관리자가 액세스 권한을 승인해야 할 수 있습니다.

두 개의 빈 저장소를 만듭니다. 하나는 작업 처리기용이고 하나는 위젯용입니다. README, 라이선스 또는 .gitignore 중 하나로 초기화하지 마십시오. 마법사에서 각 저장소의 유효성을 검사할 때 필요한 프로젝트 구조가 플랫폼에 추가됩니다.

호환 가능한 작업 및 EDS 프로젝트가 이미 있는 경우 대신 연결할 수 있지만 기존 코드가 필요하지 않습니다.

NOTE
빈 저장소의 경우 유효성 검사가 초기 프로젝트 파일을 기록합니다. 저장소 유효성 검사​를 선택하기 전에 이 앱에 사용할 저장소를 선택하십시오.

작업 인프라 설정

작업 리포지토리에는 LLM 플랫폼이 작업을 호출할 때 실행되는 서버측 처리기와 테스트가 포함되어 있습니다.

  1. 작업 원본​에서 GitHub​을(를) 선택합니다. 다른 코드 소스는 현재 사용할 수 없습니다.

  2. 답변 GitHub 리포지토리를 이미 만들었습니까?:

    • 예, 이미 만들어진 저장소를 사용합니다. 이 옵션을 선택하여 호환되는 기존 프로젝트 또는 빈 저장소를 연결합니다.
    • 아직 리포지토리가 없습니다, GitHub에서 리포지토리 만들기​를 차례로 선택하여 빈 작업 리포지토리를 만듭니다. 나중에 마법사로 돌아갑니다.
  3. Adobe LLM 앱 GitHub 앱에 저장소 연결:

    • 연결된 조직이 없으면 GitHub에 설치​를 선택하십시오.
    • 조직이 이미 연결되어 있는 경우 저장소 연결​을(를) 선택하고 해당 설치에 저장소를 추가하십시오.
  4. GitHub에서 저장소만 선택​을(를) 선택하고 이 앱에서 사용하는 저장소에만 액세스 권한을 부여합니다.

  5. 마법사로 돌아갑니다. 저장소 선택​에서 조직 및 저장소​를 선택합니다.

  6. 저장소 유효성 검사​를 선택합니다. 유효성 검사는 Adobe LLM 앱 보일러판으로 빈 저장소를 초기화합니다. 기존 저장소에는 호환되는 작업 프로젝트가 있어야 합니다.

  7. 유효성 검사에 성공하면 다음 단계​를 선택하십시오.

작업 인프라 설정 — GitHub를 선택하고 작업 리포지토리를 연결합니다

조직 또는 저장소가 없으면 선택기에서 다른 조직 연결 또는 다른 저장소 연결​을 사용합니다. GitHub에 대한 액세스를 변경한 후 조직 및 저장소 새로 고침​을 선택하세요.

위젯 인프라 설정

위젯은 제품 카드나 예약 양식과 같은 작업에 첨부된 선택적 시각적 응답입니다. 마법사가 Edge Delivery Services​(EDS) 저장소를 호스트에 연결합니다.

  1. 위젯 원본​에서 수동으로 위젯 저장소 선택​을(를) 선택합니다.
  2. 코드 원본​에서 GitHub​을(를) 선택합니다.
  3. 저장소가 이미 있는지 여부를 선택합니다. 그렇지 않으면 GitHub에서 저장소 만들기​를 선택하고 빈 위젯 저장소를 만든 다음 마법사로 돌아갑니다.
  4. 작업 리포지토리의 경우처럼 이 리포지토리에 대해 Adobe LLM 앱 GitHub 앱을 설치하거나 구성하십시오.
  5. 해당 조직 및 저장소​를 선택하십시오. 작업 저장소를 선택하지 마십시오.
  6. 저장소 유효성 검사​를 선택합니다. 유효성 검사는 AEM 보일러판으로 빈 저장소를 초기화합니다. 기존 저장소는 호환되는 EDS 프로젝트여야 합니다.
  7. AEM 코드 동기화 설치​를 선택하고 위젯 저장소에 AEM 코드 동기화 액세스 권한을 부여합니다.
  8. 설치 확인 페이지에서 설치 마법사를 사용하여 자신을 EDS 사이트의 관리자로 추가합니다.
  9. LLM Apps​(으)로 돌아가서 AEM 코드 동기화 설치 확인​을 선택합니다.
  10. AEM 코드 동기화 설치​가 나타나면 다음 단계​를 선택합니다.
NOTE
마법사에서 Cloud Manager Edge Delivery Services 사용​을(를) 준비 중(으)로 표시하고 선택을 허용하지 않습니다. 수동 위젯 저장소 옵션을 사용합니다.

유효성 검사에서 AEM 코드 동기화가 검색되지 않는 경우 AEM 코드 동기화에서 선택한 위젯 저장소에 액세스할 수 있는지, 그리고 자신을 사이트 관리자로 추가했는지 확인하십시오. 그런 다음 다시 확인합니다.

앱 세부 정보 입력 app-details

인프라 옵션 모두 앱 세부 정보(으)로 끝납니다.

앱 세부 정보 — 앱 이름을 입력하고 AEM 프로그램을 선택하고 analytics 데이터 영역을 선택합니다

  1. LLM 앱 이름​을 입력하십시오. Frescopa Coffee​와 같이 브랜드 또는 경험을 식별하는 이름을 사용하십시오.
  2. 앱이 속한 AEM 프로그램​을(를) 선택하십시오. 한 프로그램에만 액세스할 수 있는 경우 마법사는 해당 프로그램을 자동으로 선택합니다.
  3. Analytics 데이터 지역​에서 미국(US) 또는 유럽(EU)​을 선택하세요.
  4. 앱 만들기​를 선택합니다.
IMPORTANT
앱을 만든 후에는 AEM 프로그램 및 분석 데이터 영역을 변경할 수 없습니다. 분석 영역은 앱의 분석 데이터가 저장되는 위치를 결정합니다.

사용 가능한 AEM 프로그램이 없는 경우 관리자에게 액세스 권한을 요청하십시오. 프로그램 로드가 실패하면 프로그램 로드 다시 시도​를 선택하십시오.

마법사는 앱 페이지를 만든 후 엽니다. Adobe 관리 인프라를 사용하는 경우 계속하기 전에 인프라 설정이 완료될 때까지 기다리십시오.

다음: 작업 만들기

이제 앱에 인프라가 있지만 생성된 작업은 아직 없습니다. 웹 사이트를 분석하거나 수동 작업 만들기를 선택하려면 작업 만들기를 계속하십시오.

액션 메타데이터, 핸들러, 위젯 및 배포된 MCP 서버 간의 관계에 대해서는 앱이 함께 연결되는 방법을 참조하십시오.

recommendation-more-help
llm-apps-help-main-toc