설명서LLM 앱

작업 및 위젯 필드 action-widget-configuration

마지막 업데이트: 2026년 11월 13일
IMPORTANT
LLM 앱은 모든 AEM Sites Cloud Service 고객이 자체 앱을 개발하고 관리할 수 있습니다. 계량이 시작되면 각 앱 호출은 고객의 AEM Sites 콘텐츠 요청에 계산됩니다. Adobe은 계량 시행 전 계량 요율과 시작 날짜를 발표합니다.

이 페이지를 사용하여 작업 편집기에서 필드를 조회합니다. 만들기 단계는 처음부터 작업 만들기를 참조하십시오.

설정 찾기

새 작업 만들기 대화 상자와 저장된 작업 편집기는 동일한 네 개의 탭을 사용합니다.

탭
설정
작업 세부 정보
주석, 호출 상태 텍스트 및 가시성을 포함한 작업 이름, 코드 식별자, 설명, 입력 매개 변수 및 LLM 설정
LLM 위젯 세부 정보
위젯 유형, 샌드박스 도메인, 위젯 설명, 템플릿 URL 및 CSP
응용 프로그램 인사이트
사용자 의도 수집 및 지침
ChatGPT 확장
직접 열기 진입점, 작업 아이콘, 표시 환경 설정 및 작성기 언급

편집 내용을 저장하려면 변경 내용 저장​을 선택합니다. 검토 대기 중인 생성된 작업에는 대신 검토됨으로 표시​가 표시되며, 이는 생성된 끌어오기 요청 또는 분기도 병합됩니다.

작업 매개 변수

입력 매개 변수는 LLM 플랫폼이 작업 핸들러로 보내는 값입니다. 이 모델은 사용자 메시지에서 값을 추출하여 구성된 매개변수에 매핑합니다.

속성
설명
이름
매개 변수 식별자(예: category, query)
유형
업로드된 파일 매개 변수에 대한 String, Number, Integer, Boolean, Object 또는 File
설명
사람이 읽을 수 있는 설명 — LLM 플랫폼은 설명을 사용하여 올바른 값을 추출합니다
필수
이 옵션이 선택되어 있으면 작업을 호출하기 전에 모델이 이 매개변수를 제공해야 합니다

파일 매개 변수

파일 매개 변수는 File 형식의 입력 매개 변수입니다. 사용자가 파일을 업로드할 때 호스트는 일반적으로 download_url 및 file_id을(를) 포함하여 해당 인수에 대한 파일 개체를 제공합니다.

업로드된 파일 매개 변수가 파일 진입점과(와) 다릅니다. 파일 진입점은 열린 파일의 name 및 resourceUri을(를) 포함하는 개체 매개 변수 file을(를) 사용합니다.

메타데이터 필드

기본 정보

필드
필수
설명
작업 이름
예
작업의 표시 이름(예: 제품 검색)
설명
예
작업이 수행하는 작업에 대한 설명 - LLM 플랫폼은 설명을 사용하여 작업을 호출할 시기를 결정합니다

만들기 대화 상자에서 작업 이름에서 파생된 변경할 수 없는 코드 식별자​을 미리 봅니다. 앱 내에서 고유하며 소문자로 시작하고 소문자, 숫자, 하이픈 또는 밑줄을 사용하여 최대 63자를 포함합니다. 작업을 처리기 저장소의 actions/<code-identifier>/index.js에 매핑합니다.

주석

작업의 동작을 설명하는 선택적 힌트입니다.

주석
설명
파괴적 힌트
작업은 데이터를 삭제하거나 덮어쓸 수 있습니다
Idempotent(동일한 인수 = 추가 효과 없음)
동일한 요청을 반복해도 환경에 추가적인 영향을 주지 않습니다. 반복되는 요청이 반드시 동일한 데이터를 반환하지는 않습니다
Open World 힌트
작업이 외부 시스템과 상호 작용합니다
읽기 전용 힌트
작업은 데이터만 읽고 쓰지는 않습니다.

OpenAI 메타데이터

필드
최대 길이
설명
상태 텍스트 호출
64자
작업이 실행되는 동안 LLM 플랫폼에 표시되는 메시지(예: 제품 로드 중…)
상태 텍스트를 호출했습니다
64자
작업이 완료된 후 표시되는 메시지(예: 제품을 로드함…)

가시성

작업을 켜거나 끄려면 앱 페이지에서 가시성 스위치를 사용하십시오. 스위치는 다음 배포에 작업이 포함되는지 여부를 제어합니다. 작업 편집기에는 별도의 온/오프 스위치가 없습니다.

다음 작업 편집기 설정은 앱 수준의 켜기/끄기 상태가 아닌 모델 및 위젯 노출을 제어합니다.

토글
설명
AI 모델에 표시
대화하는 동안 AI 모델이 작업을 호출할 수 있습니다
앱 표면에 위젯으로 표시
이 작업은 앱에서 시각적 위젯을 렌더링합니다

모델 및 위젯 노출 설정은 위젯 유형 선택을 대체하지 않습니다.

분석

필드
설명
사용자 의도 수집
기본적으로 활성화되어 있습니다. Analytics에 대한 작업을 유도한 목표에 대한 익명화된 요약을 요청합니다
사용자 의도 설명
요약을 요청하는 데 사용되는 지침(최대 2,000자). 기본값은 개인적이고 민감한 정보를 제외합니다. 개인정보 처리방침에 대한 모든 사용자 정의 검토

위젯 필드

위젯 정보

필드
설명
위젯 유형
대화형 위젯의 경우 Edge Delivery Services 블록​을, 텍스트 전용 작업의 경우 대화형 UI가 없음​을 참조하십시오.
위젯 도메인
호스트에서 사용하는 샌드박스 원본. UI는 앱 제출에 필요하고 앱별로 고유함을 식별합니다. EDS 페이지의 위젯 URL​과(와) 별개입니다.
위젯 설명
최대 512자. _meta["openai/widgetDescription"]에 매핑됩니다. 모델에 대해 렌더링된 구성 요소를 요약하고 반복되는 내레이션을 줄입니다. 작업 설명은 모델이 작업을 선택할 때를 제어합니다. 위젯 설명은 구성 요소가 렌더링 후 표시되는 내용을 설명합니다

템플릿 URL

필드
설명
스크립트 URL
EDS scripts/aem-embed.js 진입점의 HTTPS URL입니다. 동일한 EDS 프로젝트의 작업 간에 공유됨
위젯 URL
작업에서 렌더링된 EDS 페이지의 HTTPS URL입니다. 생성된 작업은 URL을 자동으로 구성합니다.

CSP 구성

컨텐츠 보안 정책은 위젯 iframe이 연결할 수 있는 외부 도메인을 제어합니다. 모든 외부 도메인은 명시적으로 허용 목록에추가된여야 합니다.

지침
설명
리소스 도메인
정적 에셋용 도메인 — 이미지, 글꼴, 스크립트, 스타일
도메인 연결
fetch, XHR 또는 WebSocket을(를) 통해 위젯이 연결할 수 있는 도메인
프레임 도메인
중첩된 iframe에 허용된 원본. 더 엄격한 앱 검토를 트리거합니다.
도메인 리디렉션
openExternal개의 리디렉션 링크에 대한 신뢰할 수 있는 대상(ChatGPT별)
기본 URI 도메인
base-uri CSP 지시문(MCP 앱 SDK 전용, ChatGPT 제외)

ChatGPT 확장 필드 chatgpt-extension-fields

이러한 옵션 설정은 ChatGPT 전용이며 Cloud 또는 기타 LLM 플랫폼을 구성하지 않습니다. 사용 가능 여부는 ChatGPT 클라이언트별로 다릅니다. 요구 사항 및 단계는 ChatGPT 확장 구성을 참조하십시오.

진입점 및 작업 아이콘

진입점에는 위젯이 필요합니다. 동일한 위젯에 대해 [전역], [스레드] 및 [파일]의 조합을 선택하거나 모두 선택 취소한 상태로 두십시오. 전역 및 스레드는 입력 없이 작업을 호출합니다. 파일은 file 개체만 제공합니다. 다른 필수 입력으로 인해 해당 진입점이 작동하지 않습니다. 파일이 전역 또는 스레드와 결합된 경우 file은(는) 선택 사항이어야 합니다.

필드
설명
사용자가 이 앱을 열 수 있는 위치
전역(탐색의 전체 화면), 스레드(대화 측 콘텐츠 탭) 및 파일(파일 확장자와 일치하는 사용자 지정 뷰어)에 대한 확인란입니다. 여러 유형을 선택할 수 있습니다.
아이콘 URL
해당 진입점에서 공유되는 선택적 작업 아이콘. HTTP(S) URL 또는 데이터 URI를 허용합니다. 공개 HTTPS 이미지 URL을 선호합니다. URL을 변경하거나 지우면 저장된 모든 아이콘 변형이 대체됩니다
파일 확장명
하나 이상의 확장명(예: .csv)이 파일 진입점에 사용됩니다. 생략하면 편집기에서 선행 점이 추가됩니다

파일을 선택하면 file(이)라는 선택적 개체 입력이 누락된 경우 추가됩니다. 기존 정의는 유지되며 열린 파일의 name 및 resourceUri을(를) 허용해야 합니다.

환경 설정 표시

이러한 위젯 설정은 진입점과 별개입니다. 호스트가 최종 프레젠테이션을 선택합니다.

필드
선택 사항 및 기본 동작
모델에 의해 시작될 때 표시
inline, fullscreen 또는 환경 설정 없음
지원되는 리소스 표시 모드
인라인, 전체 화면 또는 둘 다. 두 옵션을 모두 선택하면 호스트 기본값이 적용됩니다.
초기 리소스 표시
호스트 기본값, 인라인 또는 전체 화면. 지원되는 모드를 선택하면 초기 모드가 포함되어야 합니다

작성기 언급

작성기 언급 사용​은(는) 앱의 리소스 검색 작업을 지정합니다. 앱당 하나의 작업만 언급 검색을 제공할 수 있습니다. 작업은 읽기 전용이고 앱에 표시되어야 하며, 빈 텍스트와 다른 필수 입력을 허용하지 않는 문자열 매개 변수 query이(가) 있어야 합니다. 공급자는 텍스트 전용일 수 있습니다. 앱 가시성을 활성화하면 검색 공급자에 대한 위젯을 구성할 필요가 없습니다.

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