|
問題
|
可能的原因
|
解決方案
|
|---|---|---|
|
PTC SaaS Platform
|
||
|
無法登入組織。
|
您的認證無效，或貴組織的訂閱受到影響。
|
如需請求 PTC SaaS Platform 認證，請查閱相關的上手溝通檔案或聯絡 PTC 合作夥伴經理。
|
|
缺少 Windchill 產品指派。
|
Windchill 產品尚未指派給貴組織。
|
請聯絡 PTC 合作夥伴經理以將 Windchill 產品指派給貴組織。
|
|
無法將管理員指派給 Windchill 產品。
|
Windchill 管理員不是 PTC SaaS Platform 組織的成員。
|
邀請 Windchill 管理員加入 PTC SaaS Platform 組織，以授與外掛程式安裝權限。
|
|
Azure 服務
|
||
|
Azure 資源群組建立失敗。
|
您無權建立資源群組。
|
驗證您是否擁有在 Azure 訂閱中建立資源所需的權限。
|
|
Azure 基礎架構即程式碼部署失敗
|
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 助手外掛程式未在「外掛程式管理員」中列出。
|
您未登入 PTC SaaS Platform。
|
驗證您的登入狀況。透過在 Windchill 視窗中選取「是」來觸發登入，進而開啟單獨的瀏覽器快顯視窗。確保啟用快顯視窗。
|
|
PTC SaaS Platform 組織管理員未將您指派給 Windchill 產品。
|
請聯絡 PTC SaaS Platform 組織管理員以將您新增至 Windchill 產品。
|
|
|
禁用第三方 cookie。
|
啟用第三方 cookie，包括在非公開模式下瀏覽時。外掛程式託管在 PTC 的 SaaS 服務中，與您的 Windchill 安裝分開，且需要啟用 cookie。
|
|
|
其他原因。
|
清除瀏覽器快取並重試。
|
|
|
Windchill AI 助手外掛程式安裝失敗，存在安全性驗證錯誤，顯示下列訊息：「WindchillAIAssistant 安裝失敗，因為安全驗證未通過。請聯絡管理員以尋求協助。」
|
如果外掛程式 JAR 是使用較新的 Java 版次來簽署，而安裝是在相同 Java 版本之較舊版次的系統上執行，則可能會發生此安全性錯誤。
|
請確保客戶環境使用了用來簽署外掛程式 JAR 的對應 Java 版本的最新 Java 版次。
|
|
外掛程式組態
|
||
|
配置外掛程式時，系統會顯示下列錯誤訊息：「您無權配置 AI 助手的管理設定。請聯絡管理員。」
|
已使用自訂憑證對 Windchill 進行配置。
|
如果已在 Windchill 中針對自訂應用程式 (例如 Navigate 應用程式) 配置自訂憑證，請執行以下步驟：
1. 手動將自訂憑證檔案的內容複製到 HTTPServer/conf/sslvhostconf.d/allClientCerts.crt。
2. 移除參考自訂憑證的組態檔案。
|
|
文件索引
|
||
|
大型文件在索引流程期間失敗。
|
索引的上限是每個文件 128 MB 或個別檔案 4 百萬個字元。超過這些限制的文件就會產生索引錯誤。
|
使用以下其中一個方法：
• 將大型文件分割成較小的檔案。
• 移除索引使用者對大型文件的存取權，以防止對大型文件進行索引。
|
|
安裝之後，查詢無法傳回以文件為基礎的答案。
|
自動連續索引僅對 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 助手標籤
|
||
|
安裝之後，「Windchill AI 助手」標籤不顯示。
|
快取的瀏覽器設定可能會導致新標籤無法顯示。
|
使用瀏覽器的「檢查器」工具清除瀏覽器快取和網站儲存。
核對受影響的使用者是否已在設定檔設定中獲得 AI 助手的存取權。
在萬不得已的情況下，只能請求重新啟動 Windchill 伺服器。
|
|
回應速度緩慢。
|
回應的產生受到儲存庫/索引大小、Azure 服務可用性和網路連線等因素的影響。
|
稍後再試一次查詢，判斷問題是否為暫時的，並嘗試找出根本原因。
|
|
系統會顯示下列錯誤：「系統目前正在處理大量的請求」。
|
大型語言模型 (LLM) 容量不足導致速率受限。
|
開啟 Azure AI Foundry 入口網站，選取 gpt-5-mini 模型，並增加配置的容量。
重新執行 IaC 指令碼時，模型容量會重設為預設值 1000 (每分鐘 1 百萬個權杖)。
如需額外的容量，可請求更高的配額。如需詳細資訊，請參閱 Azure OpenAI in Microsoft Foundry Models quotas and limits。
|
|
使用 Firefox 瀏覽器時，回應指示器持續無限旋轉。
|
如果在產生回應期間發生網路中斷，「Windchill AI 助手」標籤可能會中斷與後端服務的連線。
|
請短暫切換至「導覽器」中的其他標籤，然後返回至「Windchill AI 助手」標籤。此動作通常可以恢復連線。您可能需要再次提交問題。
|