Windchill AI Assistant Plugin > Troubleshooting and Known Issues > Troubleshooting for SaaS Environment
Troubleshooting for SaaS Environment
The following table lists common issues, possible causes and recommended solutions for SaaS environments:
Issue
Possible Cause
Solution
Azure Services
Azure resources configuration error; the service indicator does not show “HEALTHY” status.
Azure services are temporarily unreachable.
Verify your network configuration and check the Azure services status.
Azure services are permanently not reachable.
This issue can occur if the configured authentication credentials are no longer valid. For example, the Client ID or Secret Key may have expired or been rotated, or the associated service principal may have been deleted in the PTC SaaS portal.
Contact your PTC Windchill+ administrator.
Document Indexing
Large documents fail during the indexing process.
Indexing has an upper limit of 128 MB per document or 4 million characters for an individual file. Documents that exceed these limits result in indexing errors.
Use one of the following approaches:
Split large documents into smaller files.
Prevent indexing of large documents by removing the indexing user’s access to those documents.
Queries do not return document‑based answers after installation.
Automated continuous indexing reacts only to document changes in the Windchill vault.
Verify that your administrator has triggered synchronization by clicking Start in the Indexing Dashboard at least once after installation.
Windchill AI Assistant Tab
The Windchill AI Assistant tab is not visible after installation.
Cached browser settings may prevent the new tab from appearing.
Clear the browser cache and site storage using the browser’s Inspector tools.
As a last resort, request a Windchill server restart.
Slow response times.
Response generation is affected by factors such as vault or index size, Azure services availability, and network connection.
Retry the query later to determine whether the issue is temporary and try to identify the root cause.
When using the Firefox browser, the response indicator continues to spin indefinitely.
If a network interruption occurs during response generation, the Windchill AI Assistant tab may disconnect from the backend service.
Switch briefly to another tab in the Navigator, and then return to the Windchill AI Assistant tab. This action typically restores the connection. You may need to submit your question again.
Was this helpful?