Beta 온보딩 beta-onboarding

Adobe LLM Apps의 Beta 프로그램 참가자는 zip 아카이브 2개와 앱 구성 참조 정보가 포함된 이메일을 받게 됩니다. 앱을 라이브로 다운로드하려면 아래 단계를 따르십시오.

시작하기에 앞서

단계로 이동하기 전에 이 안내서 전체에서 사용되는 주요 개념을 숙지하십시오. 그러면 시간을 절약하고 모든 것이 제대로 작동하는 데 도움이 됩니다.

LLM 앱 - 사용자가 ChatGPT 또는 다른 LLM 플랫폼 내에서 상호 작용하는 브랜드 도우미입니다.

작업 — 앱에서 제공하는 기능입니다. 예를 들어 “배포자 찾기” 또는 "제품 찾아보기"가 있습니다. 사용자가 관련 질문을 할 때 LLM에서 각 작업을 호출합니다.

Action 처리기 — 작업을 호출할 때 실행되는 코드입니다. API를 호출하거나, 라이브 데이터를 가져오거나, 정적 데이터를 반환할 수 있습니다. Adobe에서 제공한 샘플 처리기는 실제 백엔드를 연결하기 전에 설치를 끝까지 확인할 수 있도록 하드코딩된 데이터를 반환합니다.

위젯 - 사용자에게 표시되는 시각적 응답(카드, 회전 메뉴, 테이블 또는 LLM의 텍스트 회신과 함께 렌더링된 사용자 지정 UI).

앱 구성 참조 — 앱을 설정할 때 각 작업에 대해 입력할 내용을 정확히 알려주는 Adobe의 파일입니다.

1단계: 제공된 아카이브를 GitHub에 푸시

Adobe은 이메일로 두 개의 zip 아카이브를 제공합니다.

GitHub에 새 빈 저장소 두 개​를 만든 다음(보관 파일당 한 개) 각 보관 파일의 압축을 풀고 푸시합니다. 해당 zip 파일 뒤에 각 저장소 이름을 지정하는 것이 좋습니다(응용 프로그램 코드의 경우 <project-name>, EDS 프로젝트의 경우 <project-name>-eds).

<your-github-org>은(는) 개인 GitHub 사용자 이름 또는 GitHub 조직(저장소를 소유하는 계정)을 참조합니다.

응용 프로그램 코드 저장소 — 보관 파일의 압축을 풀고 로컬 git 저장소를 초기화하고 GitHub에 푸시합니다.

# Unzip and enter the folder
unzip <project-name>.zip
cd <project-name>

# Initialize and push
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:<your-github-org>/<your-repo>.git
git push -u origin main

EDS 저장소 - EDS 보관에 대해 두 번째 저장소를 가리키도록 동일한 단계를 반복합니다.

unzip <project-name>-eds.zip
cd <project-name>-eds

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin git@github.com:<your-github-org>/<your-eds-repo>.git
git push -u origin main

2단계: LLM 앱 만들기

experience.adobe.com/llm-apps/​(으)로 이동한 다음 LLM 앱 만들기​를 클릭합니다.

앱 구성 참조의 앱 세부 정보 섹션에 있는 값을 사용하여 앱 세부 정보​를 입력합니다.

Analytics 데이터 영역​에서 Analytics 데이터가 저장될 영역을 선택하십시오. 앱을 만든 후에는 이 을(를) 변경할 수 없습니다.

저장소​에서 이전에 푸시한 GitHub 조직과 응용 프로그램 코드 저장소​를 선택합니다.

웹 사이트에 따라 자동으로 작업 제안​을 선택하지 않은 상태로 둡니다. 작업을 수동으로 구성합니다.

Adobe Developer 약관​에 동의한 다음 앱 만들기​를 클릭합니다.

3단계: 위젯 라이브 가져오기

이 단계에서는 Adobe이 제공한 EDS 프로젝트를 설정하고 Adobe 작성 및 CDN 계층인 DA.live을(를) 통해 게시합니다. 게시된 각 문서는 작업이 호출될 때 사용자에게 표시되는 위젯이 됩니다.

3.1단계: EDS 저장소를 DA.live에 연결

3.2단계: 각 작업에 대해 DA.live 문서 만들기

DA.live에서 작업당 하나의 문서를 만들어야. 게시되면 해당 작업이 호출될 때 각 문서가 사용자에게 표시되는 위젯이 됩니다.

각 작업에 대해:

게시되면 https://main--<your-eds-repo>--<your-github-org>.aem.live/<document-name>에서 각 문서에 액세스할 수 있습니다. 이 URL은 4단계에서 각 작업을 구성할 때 위젯 URL 필드에 입력하는 URL입니다.

3.3단계: EDS 사이트에 대한 CORS 헤더 구성

LLM 플랫폼에서 위젯을 원본 간에 로드하려면 EDS 사이트에 Access-Control-Allow-Origin 헤더를 추가해야 합니다.

tools.aem.live/tools/headers-edit/index.html의 HTTP 헤더 편집기(으)로 이동합니다.

AEM Edge Delivery Services의 사용자 지정 HTTP 헤더에 대한 전체 설명서는 aem.live/docs/custom-headers을(를) 참조하십시오.

헤더를 저장한 후 코드 동기화를 트리거하여 변경 사항을 모든 파일에 전파합니다.

curl -X POST "https://admin.hlx.page/code/<your-github-org>/<your-eds-repo>/main/*"

4단계: 작업 추가

LLM 앱 UI에서 앱을 열고 왼쪽 사이드바의 작업(으)로 이동합니다. 새 작업을 만들려면 +​을(를) 클릭하십시오. 앱 구성 참조에 설명된 모든 작업에 대해 이 작업을 반복합니다(작업 1, 작업 2, 작업 3 섹션 참조).

작업 탭

위젯 메타데이터 탭

CSP 구성​을 확장하고 다음을 채우십시오.

위젯 빌더 탭

위젯 원본​에서 기존 위젯 사용​을 선택한 다음 다음을 채우십시오.

작업 만들기​를 클릭합니다. 작업이 EDS 배지와 매개 변수 카운트가 있는 카드로 작업 페이지에 표시됩니다.

5단계: 배포

모든 작업이 구성되면 앱 세부 정보 페이지로 이동하여 오른쪽 상단의 배포​를 클릭합니다.

대상 환경을 선택하고 배포​를 클릭합니다. 파이프라인은 자격 증명 준비, 배포 시작, 저장소에서 앱 빌드, Adobe I/O Runtime에 게시의 네 단계를 통해 실행됩니다.

완료되면 앱 세부 정보 페이지의 앱 테스트 섹션으로 스크롤하여 MCP 서버 URL​을(를) 복사합니다. ChatGPT에 앱을 등록하려면 이 URL이 필요합니다.

6단계: ChatGPT에 앱 추가

ChatGPT에 사용자 지정 앱을 추가하려면 Pro, Business 또는 Enterprise 구독이 필요합니다. 무료 및 플러스 플랜은 사용자 정의 MCP 앱을 지원하지 않습니다.

앱이 활성화된 앱 아래에 개발 배지와 함께 표시됩니다.

새 대화를 시작하거나 + 단추를 사용하거나 @​을(를) 입력하고 앱 이름을 입력하여 앱을 연결하고 구성된 작업 중 하나와 일치하는 질문을 합니다.

다음 단계

배포한 샘플 앱은 하드코딩된 데이터를 사용합니다. 프로덕션 준비 환경으로 전환하려면 다음을 수행하십시오.