|
문제점
|
가능한 원인
|
솔루션
|
|---|---|---|
|
PTC SaaS Platform
|
||
|
조직에 로그인할 수 없습니다.
|
사용자의 자격 증명이 유효하지 않거나 조직의 가입에 영향을 미쳤습니다.
|
온보딩 중 전달된 내용을 참조하거나 PTC 파트너 관리자에게 문의하여 PTC SaaS Platform 자격 증명을 요청하십시오.
|
|
Windchill 제품 지정이 누락되었습니다.
|
Windchill 제품이 사용자의 조직에 지정되지 않았습니다.
|
PTC 파트너 관리자에게 문의하여 Windchill 제품을 조직에 지정하십시오.
|
|
Windchill 제품에 관리자를 지정할 수 없습니다.
|
Windchill 관리자가 PTC SaaS Platform 조직의 구성원이 아닙니다.
|
Windchill 관리자를 PTC SaaS Platform 조직에 초대하여 플러그 인 설치 권한을 부여하십시오.
|
|
Azure 서비스
|
||
|
Azure 리소스 그룹 작성이 실패합니다.
|
리소스 그룹을 작성할 권한이 없습니다.
|
Azure 구독에 리소스를 작성하는 데 필요한 권한이 있는지 확인하십시오.
|
|
Azure Infrastructure as Code 배포에 실패합니다.
|
Azure 정책에는 특정 태그가 있어야 합니다.
IaC 로그에는 오류 코드 RequestDisallowedByPolicy가 포함되어 있습니다.
|
Azure 관리자와 함께 Azure 구독 정책을 검토하여 필요한 태그를 파악합니다. 누락된 태그를 common_tags 매개변수에 추가한 다음 IaC 스크립트를 다시 실행합니다.
|
|
리소스가 다른 지역에서 같은 배포 이름을 사용하여 이미 작성되었거나 일부가 작성되었습니다.
IaC 로그에 다음과 유사한 오류가 포함되어 있습니다.
json { "code": "InvalidResourceLocation", "message":
"The resource '${DeploymentName}' already exists in location 'region1' in resource group '${ResourceGroup}'. A resource with the same name cannot be created in location 'region2'." } |
리소스 작성을 재시도하기 전에 충돌하는 서비스, 스토리지 또는 기타 리소스를 제거하거나 다른 배포 이름을 사용하여 리소스를 다시 작성하십시오.
|
|
|
AI Foundry를 위한 Azure 배포에서 일시적인 오류가 발생했습니다.
IaC 로그에 다음과 유사한 오류가 포함되어 있습니다.
IfMatchPreconditionFailed
|
IaC 스크립트를 다시 실행하십시오.
|
|
|
인증 토큰이 만료되었습니다. IaC 로그에 다음과 유사한 오류가 포함되어 있습니다.
ClientAuthenticationError: (ExpiredAuthenticationToken)
|
IaC 스크립트를 다시 실행하십시오.
|
|
|
선택한 지역에서 Azure AI Foundry 임베딩 모델 용량이 소진되었습니다. 따라서 IaC 스크립트 실행에 실패하고 다음 오류가 발생합니다. 매개변수 text_embedding_capacity의 값은 양의 정수여야 합니다.
|
다음 옵션 중 하나를 사용합니다.
• 기존 모델 배포의 크기를 조정하여 사용 가능한 용량을 확보합니다.
• Microsoft 지원 요청을 진행하여 모델 용량을 늘립니다.
• 사용 가능한 용량이 있는 다른 Azure 지역에 리소스를 배포합니다.
|
|
|
Azure AI 검색 인덱스, 인덱서, 기술 세트 또는 데이터 소스의 최대 수에 도달했습니다. 따라서 IaC 스크립트에 실패하고 다음 오류가 표시됩니다. 이 서비스에 대한 기술 세트 할당량 50이 초과되었습니다.
|
사용하지 않는 Azure AI 검색 인덱스, 인덱서, 기술 세트 또는 데이터 소스를 삭제하십시오. 정리가 불가능한 경우 Azure AI 검색 서비스 계층을 늘리거나 다른 지역에서 서비스를 배포하십시오.
|
|
|
Azure 리소스 구성 오류. 서비스 표시기에 "정상" 상태가 표시되지 않습니다.
|
JSON 파일의 매개 변수 또는 구성 값이 잘못된 상태에서 리소스 작성이 호출되었습니다.
|
리소스 작성 입력 정보가 올바른지 확인하고 리소스 작성 프로세스를 다시 수행하십시오.
|
|
플러그 인 구성에 올바르지 않은 토큰 또는 리소스 식별자가 입력되었습니다.
|
Azure 리소스 작성 출력에 올바른 토큰과 식별자가 사용되는지 확인하십시오.
|
|
|
Azure 리소스가 올바르게 구성되었지만 한계를 초과합니다.
|
Azure 구독 및 작성된 리소스에 필요한 한도가 남아 있는지 확인합니다. 사용량 또는 스토리지 한도를 초과하지 마십시오.
|
|
|
Azure 서비스에 연결할 수 없습니다.
|
네트워크 구성 및 Azure 서비스 상태를 확인하십시오.
|
|
|
플러그 인 설치
|
||
|
Windchill AI Assistant 플러그 인이 플러그 인 관리자에 나열되지 않습니다.
|
PTC SaaS Platform에 로그인되지 않았습니다.
|
로그인 상태를 확인하십시오. Windchill 창에서 예를 선택하면 로그인이 트리거되며 별도의 브라우저 팝업이 열립니다. 팝업이 사용 가능하도록 설정되어 있는지 확인하십시오.
|
|
PTC SaaS Platform 조직 관리자가 사용자를 Windchill 제품에 지정하지 않았습니다.
|
PTC SaaS Platform 조직 관리자에게 연락하여 Windchill 제품에 사용자로 추가하도록 요청하십시오.
|
|
|
타사 쿠키가 비활성화되어 있습니다.
|
비공개 모드에서 찾아보는 경우를 포함하여 타사 쿠키를 활성화합니다. 플러그 인은 PTC의 SaaS 서비스에서 호스팅됩니다. 이러한 서비스는 Windchill 설치와 별개이며 쿠키가 필요합니다.
|
|
|
다른 원인.
|
브라우저 캐시를 지우고 다시 시도하십시오.
|
|
|
Windchill AI Assistant 플러그 인 설치에 실패하고 보안 확인 오류가 발생하여 다음 메시지가 표시됩니다. "Windchill AI Assistant 설치가 보안 검증 실패로 인해 실패했습니다. 관리자에게 문의하여 도움을 받으십시오."
|
이 보안 오류는 최신 Java 빌드를 사용하여 플러그 인 JAR에 서명했는데, 동일한 Java 버전의 이전 빌드를 실행하는 시스템에서 설치하는 경우 발생할 수 있습니다.
|
고객 환경에서 플러그 인 JAR에 서명하는 데 사용한 Java 버전의 최신 Java 빌드를 사용하고 있는지 확인하십시오.
|
|
플러그 인 구성
|
||
|
플러그 인을 구성할 때 시스템에 다음 오류 메시지가 표시됩니다. "AI Assistant의 관리 설정을 구성할 권한이 없습니다. 관리자에게 문의하십시오."
|
Windchill은 사용자 정의 인증서로 구성됩니다.
|
Windchill이 사용자 정의 응용 프로그램(예: Navigate 앱)에 대해 사용자 정의 인증서를 사용하도록 구성된 경우, 다음 단계를 수행하십시오.
1. 사용자 정의 인증서 파일의 내용을 HTTPServer/conf/sslvhostconf.d/allClientCerts.crt 파일에 수동으로 복사합니다.
2. 사용자 정의 인증서를 참조하는 구성 파일을 제거합니다.
|
|
문서 인덱싱
|
||
|
대용량 문서는 인덱싱 과정에서 실패할 수 있습니다.
|
인덱싱은 문서당 최대 128MB 또는 개별 파일 기준 최대 400만 자로 제한됩니다. 이 제한을 초과하는 문서는 인덱싱 오류가 발생합니다.
|
다음 중 하나의 방법을 사용하십시오.
• 대용량 문서를 더 작은 파일로 분할합니다.
• 인덱싱 사용자에게 해당 문서에 대한 액세스 권한을 제거하여 대용량 문서의 인덱싱을 방지합니다.
|
|
설치 후 질의에서 문서 기반 답변이 반환되지 않습니다.
|
자동화된 연속 인덱싱은 Windchill 보관소의 문서가 변경된 경우에만 실행됩니다.
|
설치 후 한 번 이상 인덱싱 대시보드에서 시작을 클릭하여 관리자가 동기화를 트리거했는지 확인하십시오.
|
|
해당 문서 유형이 지원되더라도 인덱싱이 중지되거나 새 문서가 올바르게 인덱싱되지 않습니다.
|
계층 용량이 소진되어 인덱싱이 중지될 수 있습니다.
|
로그에서 다음 오류 메시지를 검토하십시오. "Vector index size quota has been exceeded for this service. You must either delete documents first or use a higher SKU for additional quota.”
|
|
Windchill AI Assistant 탭
|
||
|
설치 후 Windchill AI Assistant 탭이 표시되지 않습니다.
|
캐시된 브라우저 설정으로 인해 새 탭이 표시되지 않을 수 있습니다.
|
브라우저의 검사관 도구를 사용하여 브라우저 캐시와 사이트 저장소를 지웁니다.
프로파일 설정에서 영향 받는 사용자에게 AI Assistant에 대한 액세스 권한이 부여되어 있는지 확인하십시오.
마지막 방법으로 Windchill 서버 재시작을 요청합니다.
|
|
응답 시간이 느립니다.
|
응답 생성은 보관소 또는 인덱스 크기, Azure 서비스 가용성 및 네트워크 연결과 같은 요인의 영향을 받습니다.
|
나중에 다시 질의를 시도하여 일시적인 문제인지 확인하고 근본 원인을 파악해 보십시오.
|
|
시스템에 "시스템이 현재 대량의 요청을 처리하고 있습니다."라는 오류가 표시됩니다.
|
LLM(거대 언어 모델) 용량 부족으로 인해 속도가 제한됩니다.
|
Azure AI Foundry 포털을 열고 gpt-5-mini 모델을 선택한 다음 할당된 용량을 늘립니다.
IaC 스크립트가 재실행되면 모델 용량이 기본값인 1000(분당 100만 토큰)으로 재설정됩니다.
용량이 더 필요한 경우 더 큰 할당량을 요청하십시오. 자세한 내용은 Microsoft Foundry 모델의 Azure OpenAI 할당량 및 한도를 참조하십시오.
|
|
Firefox 브라우저를 사용하는 경우 응답 표시기가 계속 회전합니다.
|
응답 생성 중에 네트워크가 중단되면 Windchill AI Assistant 탭과 백엔드 서비스 연결이 끊어질 수 있습니다.
|
탐색기의 다른 탭으로 잠시 이동한 다음 Windchill AI Assistant 탭으로 돌아갑니다. 이렇게 하면 일반적으로 연결이 복원됩니다. 질문을 다시 제출해야 할 수도 있습니다.
|