문제 해결 troubleshooting

마지막 업데이트: 2026년 10월 19일

IMPORTANT

Adobe LLM Apps이(가) 현재 Beta에 있습니다.

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

관찰할 수 있는 증상부터 시작하세요. 문제를 해결하는 동안 자격 증명, 토큰, 비공개 MCP URL 또는 중요한 처리기 결과를 공유하지 마십시오.

앱 만들기 및 작업 생성

증상

해결 방법

Adobe 관리 인프라 설정 실패

설치 실패의 오류를 읽은 다음 다시 시도를 선택하십시오. 페이지에서 진행률을 확인할 수 없으면 다시 확인을 선택합니다. 백그라운드에서 설치를 계속합니다.

사용 가능한 AEM 프로그램 없음

관리자에게 프로그램 액세스 권한을 요청하십시오. 로드하지 못한 경우 프로그램 로드 다시 시도를 선택하십시오.

새 저장소가 표시되지 않음

다른 저장소 연결을 사용하여 Adobe LLM 앱 GitHub 앱 액세스 권한을 부여하고 마법사로 돌아가 조직 및 저장소 새로 고침을 선택하십시오.

작업 또는 위젯 저장소 유효성 검사 실패

호환되는 기존 프로젝트 또는 빈 저장소를 사용합니다. 작업 및 위젯에 별도의 저장소를 사용한 다음 저장소 유효성 검사를 다시 선택합니다.

AEM 코드 동기화가 감지되지 않음

위젯 리포지토리에 대한 AEM 코드 동기화를 설치하고 확인 페이지에서 자신을 사이트 관리자로 추가한 후 마법사로 돌아가 AEM 코드 동기화 설치 확인을 선택합니다.

앱을 만들 때 작업이 생성되지 않았습니다.

앱 생성은 인프라만 설정합니다. 앱 페이지에서 자동으로 작업 빌드를 선택하고 웹 사이트를 입력한 다음 내 작업 빌드를 선택합니다. 작업 만들기를 참조하세요.

작업이 아직 생성 중입니다.

UI는 생성할 때 최대 30분을 예상합니다. 작업 페이지에서 진행 상황을 따르거나 페이지를 떠났다가 나중에 돌아가기

작업 생성 보고서 실패

HTTPS를 통해 웹 사이트가 공개되고 자신의 저장소에 대해 해당 저장소 액세스가 여전히 유효한지 확인합니다. 문제가 지속되면 Beta 팀에 오류 메시지가 표시됩니다

작업 및 핸들러

증상

해결 방법

작업이 호출되지 않음

대화에서 앱의 플러그인 또는 커넥터를 활성화합니다. 작업 설정에서 AI 모델 노출을 확인하고 앱 페이지에서 작업의 가시성 스위치를 켜십시오. 설명 개선 및 메타데이터 변경 사항 재배포

비어 있거나 오류 응답

npm test을(를) 실행한 다음 MCP 검사기 또는 curl을(를) 사용하여 처리기를 호출합니다. 로컬 처리기 개발 및 테스트를 참조하세요.

핸들러는 로컬에서 작동하지만 배포 후에는 작동하지 않음

푸시된 최신 커밋을 확인하고 런타임 구성을 확인한 다음 작업 코드 식별자가 actions/<code-identifier>/index.js과(와) 일치하는지 확인하십시오.

생성된 작업은 검토됨으로 표시할 수 없습니다.

핸들러 및 위젯 생성을 확인했습니다. 생성된 끌어오기 요청에 대한 병합 충돌을 확인하고 작업을 다시 로드한 다음 검토됨으로 표시를 다시 선택합니다.

위젯

증상

해결 방법

위젯이 렌더링되지 않음

스크립트 URL, 위젯 URL, HTTPS, EDS 게시, CSP 도메인 및 CORS 헤더를 확인합니다

위젯은 렌더링되지만 데이터가 표시되지 않음

MCP 검사기를 사용하여 핸들러를 호출하고 해당 structuredContent 모양을 bridge.toolResult에서 읽은 필드와 비교합니다.

위젯은 직접 미리 보기에서 작동하지만 ChatGPT에서는 작동하지 않음

직접 미리 보기는 샘플 데이터를 사용할 수 있습니다. 배포된 핸들러 결과를 테스트하고 CORS 및 CSP에서 EDS 원본을 허용하는지 확인합니다.

브라우저 요청이 차단됨

필요한 원본만 올바른 CSP 필드에 추가하고 다시 배포합니다.

HTTP 헤더 편집기에서 구성을 저장할 수 없음

AEM 구성 서비스를 사용하거나 EDS 관리자에게 사이트 헤더 구성을 초기화하도록 요청하십시오

개인 또는 중요한 데이터를 포함할 수 있는 경우 전체 bridge.toolResult 값을 기록하지 마십시오.

배포

증상

해결 방법

준비 중 배포가 실패합니다.

핸들러 저장소가 연결되어 있고 Adobe Developer Console 액세스가 여전히 유효한지 확인

앱 빌드 중 배포가 실패합니다.

로컬에서 npm install, npm test 및 npm run build을(를) 실행합니다. 종속성, 구문 또는 테스트 오류를 수정하고 변경 사항을 푸시합니다

배포가 성공했지만 변경 사항이 누락되었습니다.

예상 커밋이 푸시되었는지 확인하고 동일한 환경에 다시 배포합니다.

작업이 배포되지 않음 상태로 유지됩니다.

작업을 검토하거나 메타데이터 변경 후 다시 배포

인증 authentication

인증 사용이 켜져 있을 때 적용됩니다. 자체 ID 공급자를 사용하여 최종 사용자 인증을 참조하십시오.

증상

해결 방법

설정을 저장한 후에도 작업은 여전히 공개 상태입니다.

해당 환경에 앱을 다시 배포합니다. 인증 변경 사항은 다음 배포에 적용됩니다.

환경을 전환한 후 설정이 잘못됨

Workspace 선택기에 의도한 환경이 표시되는지 확인하십시오. Stage 및 Production이(가) 독립적으로 구성되어 있습니다

로그인이 시작되지 않음

인증을 사용하도록 설정한 후 앱을 배포했으며 작업에서 필수을(를) 사용하는지 확인합니다. 해당 처리기에서 로그인을 요청할 때만 Optional 작업이 표시됩니다

플랫폼에서 사용자를 잘못된 로그인 페이지로 보냅니다.

발급자가 ID 공급자의 발급자 URL과 정확히 일치하는지, 공용 HTTPS를 통해 연결할 수 있는지 확인하십시오.

로그인이 성공했지만 모든 호출이 계속 거부됨

ID 공급자가 해당 환경에 대한 앱의 MCP 서버 URL을 대상으로 하는 토큰을 발급하고 토큰이 비대칭 알고리즘으로 서명된 JWT인지 확인합니다. 토큰 요구 사항을 참조하세요.

ID 공급자는 트래픽을 수신하지 않습니다

공급자의 검색, 인증 및 토큰 끝점은 공개 HTTPS를 통해 접근 가능해야 합니다. 방화벽, WAF 또는 그 앞에 IP 앱이 있는지 확인하십시오. 공급자가 연결되어 있지 않을 때 연결할 수 있습니다.

ID 공급자는 요청한 대상자에 대한 토큰 발급을 거부합니다

일부 공급자는 토큰에 등록된 리소스에 대해서만 토큰을 발행합니다. 앱의 MCP 서버 URL이 ID 공급자에 리소스 식별자로 등록되어 있는지 확인합니다

새로 추가된 범위는 로그인 시 요청되지 않습니다

LLM 플랫폼은 몇 분 동안 앱의 게시된 메타데이터를 캐시합니다. 기다린 후 로그인을 다시 시도하십시오.

범위를 위해 다시 로그인하라는 메시지가 표시됩니다

이 작업에는 토큰이 전달하지 않는 범위가 필요합니다. ID 공급자에서 클라이언트의 부여에 범위를 추가하거나 작업에서 범위를 제거합니다.

사용자가 로그인 프롬프트를 반복해서 받습니다

인증 후 호출자의 ID 요청을 다시 확인하지 않고 모든 호출에서 extra.challengeAuth()을(를) 반환하는 처리기입니다. 작업에 필요한 ID가 누락된 경우에만 인증 요청

사용자가 ID 공급자에 도달하기 전에 로그인이 거부됩니다

LLM 플랫폼이 전송한 리디렉션 URI가 인증 서버에 등록되어 있지 않습니다. 일부 플랫폼은 각 커넥터에 대해 서로 다른 값을 발행하므로 커넥터 설정 화면에 표시된 값을 등록합니다

지원되지 않는 범위 메시지로 저장 차단됨

지원되는 범위에 범위를 추가하거나 필요한 작업에서 범위를 제거하십시오

Claude에 로그인하라는 공개 메시지가 표시됩니다.

커넥터가 지금 로그인이 아니라 필요한 경우 로그인을 사용하는지 확인하세요. 배포된 이전 앱의 경우 런타임을 업데이트하고 다시 배포합니다. 현재 런타임에 혼합 앱을 사용하면 공용 작업을 익명으로 호출할 수 있습니다.

Optional 작업이 로그인 텍스트를 반환하지만 클라우드 로그인 프롬프트는 반환하지 않습니다.

extra.challengeAuth()은(는) ChatGPT 도구 결과 챌린지입니다. 이식 가능한 로그인 게이트의 경우 런타임에서 Claude가 예상한 HTTP 문제를 반환하도록 필수 작업을 사용합니다.

모든 작업이 없음인 경우에도 앱에서 로그인하라는 메시지가 표시됩니다.

인증 사용을 해제하고 배포하십시오. 이 기능이 켜져 있는 동안 앱이 아무 작업도 표시되지 않는 경우에도 인증 서버를 광고합니다

액세스 토큰, 클레임 세트 또는 ID 공급자 클라이언트 암호를 지원 요청에 붙여 넣지 마십시오.

ChatGPT 플러그인

증상

해결 방법

플러그인이 표시되지 않음

chatgpt.com/plugins을(를) 열고 계정 또는 작업 영역에서 사용자 지정 MCP 서버를 허용하는지 확인한 다음 결과 플러그인을 설치하거나 연결합니다

플러그인 생성 실패

앱 테스트에서 전체 HTTPS MCP 서버 URL을 다시 복사하고 앱과 일치하는 인증 방법을 선택하십시오. 실패한 OAuth에 대한 해결 방법으로 공용 앱에 대해서만 인증 없음을 사용합니다.

플러그인은 연결하지만 작업을 호출할 수 없습니다.

플러그인이 채팅에 첨부되고 작업이 모델에 노출되고 최신 버전이 배포되는지 확인합니다.

플러그인이 잘못된 환경을 사용함

의도한 스테이지 또는 프로덕션 MCP 서버 URL로 플러그인을 편집하거나 다시 만듭니다.

플러그인에 여전히 이전 작업 메타데이터가 표시됨

변경 내용을 배포하고 ChatGPT 연결에서 새로 고침을 선택한 다음 새 대화를 시작하십시오.

문제가 지속되면 Beta 팀에 문의하기 전에 앱 이름, 환경, 실패한 단계, 시간 및 표시되는 오류 메시지를 기록하십시오. 비밀 또는 중요한 고객 데이터를 포함하지 마십시오.

recommendation-more-help

llm-apps-help-main-toc