문제 해결 troubleshooting
IMPORTANT
LLM 앱은 모든 AEM Sites Cloud Service 고객이 자체 앱을 개발하고 관리할 수 있습니다. 계량이 시작되면 각 앱 호출은 고객의 AEM Sites 콘텐츠 요청에 계산됩니다. Adobe은 계량 시행 전 계량 요율과 시작 날짜를 발표합니다.
관찰할 수 있는 증상부터 시작하세요. 문제를 해결하는 동안 자격 증명, 토큰, 비공개 MCP URL 또는 중요한 처리기 결과를 공유하지 마십시오.
앱 만들기 및 작업 생성
증상
해결 방법
LLM Apps 관리 인프라 설정 실패
설치 실패의 오류를 읽은 다음 다시 시도를 선택하십시오. 페이지에서 진행률을 확인할 수 없으면 다시 확인을 선택합니다. 백그라운드에서 설치를 계속합니다.
사용 가능한 AEM 프로그램 없음
관리자에게 프로그램 액세스 권한을 요청하십시오. 로드하지 못한 경우 프로그램 로드 다시 시도를 선택하십시오.
새 저장소가 표시되지 않음
저장소를 Cloud Manager 프로그램에 개인 저장소로 추가하고 준비 상태가 될 때까지 기다린 다음 저장소 목록을 다시 엽니다. Cloud Manager에서 Adobe이 호스팅하는 저장소는 지원되지 않습니다
연결된 Edge Delivery Services 사이트 없음
GitHub에 없는 위젯 리포지토리는 Bring Your Own Git을 사용하여 Cloud Manager의 EDS 사이트에 연결해야 합니다. 연결한 다음 저장소 유효성 검사를 다시 선택하십시오. Git 가져오기 참조
작업 또는 위젯 저장소 유효성 검사 실패
호환되는 기존 프로젝트 또는 빈 저장소를 사용합니다. 작업 및 위젯에 별도의 저장소를 사용한 다음 저장소 유효성 검사를 다시 선택합니다.
AEM 사이트 설정 또는 액세스 유효성 검사 실패(GitHub 위젯 저장소)
AEM 사이트 액세스 설정을 따르십시오. 새 코드 동기화 설치에 대해 확인 페이지 마법사를 완료합니다. 기존 사이트의 경우 설치를 유지하고 사이트 관리자에게 AEM 사용자 관리를 통해 Adobe 계정
admin 액세스 권한을 부여하도록 요청하십시오. 코드 동기화가 위젯 리포지토리를 포함하는지 확인한 다음 AEM 설정 유효성 검사를 선택합니다.DA 쓰기 액세스 권한 필요
DA 조직 관리자에게 LLM 앱에 사용된 Adobe 계정에 사이트의 모든 콘텐츠에 대한 쓰기 액세스 권한을 부여하도록 요청하십시오. DA 쓰기 액세스 권한 부여에 따라 해당 계정으로 로그인한 다음 AEM 설정 유효성 검사를 선택합니다. AEM 사이트 역할이 DA 권한을 부여하지 않음
AEM 또는 DA 액세스를 확인할 수 없음
임시 확인 실패에 대해 AEM 설정의 유효성을 확인해 보십시오. 대신 메시지가 액세스 거부를 보고하는 경우 위의 지침을 사용하여 AEM 또는 DA 권한을 수정한 후 다시 시도하십시오
앱을 만들 때 작업이 생성되지 않았습니다.
앱 생성은 인프라만 설정합니다. 앱 페이지에서 자동으로 작업 빌드를 선택하고 웹 사이트를 입력한 다음 내 작업 빌드를 선택합니다. 작업 만들기를 참조하세요.
작업이 아직 생성 중입니다.
UI는 생성할 때 최대 30분을 예상합니다. 작업 페이지에서 진행 상황을 따르거나 페이지를 떠났다가 나중에 돌아가기
작업 생성 보고서 실패
HTTPS를 통해 웹 사이트가 공개되고 자신의 저장소에 대해 해당 저장소 액세스가 여전히 유효한지 확인합니다. 문제가 지속되면 오류 메시지가 표시된 LLM 앱 팀에 문의하십시오
작업 및 핸들러
증상
해결 방법
작업이 호출되지 않음
대화에서 앱의 플러그인 또는 커넥터를 활성화합니다. 작업 설정에서 AI 모델 노출을 확인하고 앱 페이지에서 작업의 가시성 스위치를 켜십시오. 설명 개선 및 메타데이터 변경 사항 재배포
비어 있거나 오류 응답
핸들러는 로컬에서 작동하지만 배포 후에는 작동하지 않음
푸시된 최신 커밋을 확인하고 런타임 구성을 확인한 다음 작업 코드 식별자가
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 값을 기록하지 마십시오.
ChatGPT 확장
누락된 진입점, 파일 뷰어 문제, 잘못된 아이콘 URL, 표시 설정 또는 작성기 언급 오류에 대해서는 ChatGPT 확장 문제 해결을 참조하십시오. 앱을 변경하기 전에 클라이언트 지원 확인: 작동 중인 연결로 인해 해당 클라이언트에서 모든 확장이 지원되는 것은 아닙니다.
배포
증상
해결 방법
준비 중 배포가 실패합니다.
핸들러 저장소가 연결되어 있고 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 연결에서 새로 고침을 선택한 다음 새 대화를 시작하십시오.
문제가 지속되면 LLM 앱 팀에 문의하기 전에 앱 이름, 환경, 실패한 단계, 시간 및 표시되는 오류 메시지를 기록하십시오. 비밀 또는 중요한 고객 데이터를 포함하지 마십시오.
recommendation-more-help
llm-apps-help-main-toc