|
问题
|
可能的原因
|
解决方案
|
|---|---|---|
|
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 助手插件安装失败，提示安全验证错误，同时显示以下消息：“由于安全验证失败，Windchill AI 助手安装失败。请联系管理员，以获得协助。”
|
如果插件 JAR 文件使用较新的 Java 版次进行签名，则可能会出现此安全错误。
|
确保客户环境使用签署插件 JAR 时所用相应 Java 版本的最新 Java 版次。
|
|
插件配置
|
||
|
配置插件时，系统会显示以下错误消息：“您没有权限配置 AI 助手管理设置。请联系管理员。”
|
Windchill 配置有自定义证书。
|
如果 Windchill 针对自定义应用程序 (例如 Navigate 应用程序) 配置了自定义证书，请执行以下步骤：
1. 将自定义证书文件的内容手动复制到 HTTPServer/conf/sslvhostconf.d/allClientCerts.crt。
2. 移除引用自定义证书的配置文件。
|
|
文档索引
|
||
|
大型文档的索引建立过程失败。
|
每个文档的索引上限为 128 MB，或单个文件的索引上限为 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 助手选项卡
|
||
|
安装后，“Windchill AI 助手”选项卡不可见。
|
缓存的浏览器设置可能会阻止新选项卡显示。
|
使用浏览器的“检查器”工具清除浏览器缓存和站点存储。
验证是否已在“配置文件”设置中为受影响的用户授予 AI 助手的访问权限。
在万不得已的情况下，只能请求重新启动 Windchill 服务器。
|
|
响应速度缓慢。
|
响应的生成受电子仓库或索引大小、Azure 服务可用性和网络连接等因素的影响。
|
稍后重试查询，判断该问题是否为临时的，并尝试找出根本原因。
|
|
系统显示以下错误：“系统当前正在处理大量请求”。
|
由于大型语言模型 (LLM) 容量不足而导致速率限制。
|
打开 Azure AI Foundry 门户，选择 gpt-5-mini 模型，然后增加分配的容量。
重新执行 IaC 脚本时，模型容量将重置为默认值 1000 (每分钟 100 万个令牌)。
如果需要额外的容量，请申请更高配额。有关详细信息，请参阅 Microsoft Foundry 模型中的 Azure OpenAI 配额和限制。
|
|
使用 Firefox 浏览器时，响应指示器会无限期旋转。
|
如果在响应生成过程中出现网络中断，则“Windchill AI 助手”选项卡可能会与后端服务断开连接。
|
在导航器中短暂切换到另一个选项卡，然后返回到“Windchill AI 助手”选项卡。此操作通常可恢复连接。您可能需要再次提交问题。
|