Windchill AI Assistant Plugin > Problembehandlung und bekannte Probleme > Problembehandlung in lokalen Umgebungen
Problembehandlung in lokalen Umgebungen
In der folgenden Tabelle sind häufige Probleme, mögliche Ursachen und empfohlene Lösungen für lokale Umgebungen aufgeführt:
Problem
Mögliche Ursache
Lösung
PTC SaaS Platform
Anmeldung bei Organisation nicht möglich.
Ihre Anmeldeinformationen sind ungültig, oder das Abonnement Ihrer Organisation ist betroffen.
Weitere Informationen finden Sie in der Onboarding-Kommunikation, oder fordern Sie bei Ihrem PTC Partner Manager Anmeldeinformationen für die PTC SaaS Platform an.
Fehlende Zuweisung des Produkts Windchill.
Das Produkt Windchill wurde Ihrer Organisation nicht zugewiesen.
Wenden Sie sich an Ihren PTC Partner Manager, damit das Produkt Windchill Ihrer Organisation zugewiesen wird.
Administrator kann nicht dem Produkt Windchill zugewiesen werden.
Der Windchill Administrator ist kein Mitglied Ihrer Organisation auf der PTC SaaS Platform.
Laden Sie den Windchill Administrator zu Ihrer Organisation auf der PTC SaaS Platform ein, damit ihm Berechtigungen für die Installation des Plugins gewährt werden können.
Azure-Dienste
Fehler beim Erstellen der Azure-Ressourcengruppe.
Sie sind nicht berechtigt, eine Ressourcengruppe zu erstellen.
Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Erstellen von Ressourcen in Ihrem Azure-Abonnement verfügen.
Fehler bei der Azure Infrastructure-as-Code-Bereitstellung
Azure Policy erfordert, dass bestimmte Tags vorhanden sind.
Die IaC-Protokolle enthalten den Fehlercode RequestDisallowedByPolicy.
Überprüfen Sie die Azure-Abonnementrichtlinien mit Ihrem Azure-Administrator, und identifizieren Sie die erforderlichen Tags. Fügen Sie dem Parameter common_tags die fehlenden Tags hinzu, und führen Sie dann das IaC-Skript erneut aus.
Ressourcen wurden bereits unter Verwendung desselben Bereitstellungsnamens in einer anderen Region erstellt oder teilweise erstellt.
Die IaC-Protokolle enthalten einen Fehler ähnlich dem folgenden:
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'." }
Entfernen Sie alle in Konflikt stehenden Dienste, Speicher oder anderen Ressourcen, bevor Sie die Ressourcenerstellung wiederholen, oder erstellen Sie die Ressourcen unter Verwendung eines anderen Bereitstellungsnamens neu.
In Azure-Bereitstellungen für AI Foundry ist ein vorübergehender Fehler aufgetreten.
Die IaC-Protokolle enthalten einen Fehler ähnlich dem folgenden:
IfMatchPreconditionFailed
Führen Sie das IaC-Skript erneut aus.
Abgelaufenes Authentifizierungs-Token. Die IaC-Protokolle enthalten einen Fehler ähnlich dem folgenden:
ClientAuthenticationError: (ExpiredAuthenticationToken)
Führen Sie das IaC-Skript erneut aus.
Die Azure AI Foundry-Einbettungsmodellkapazität ist in der ausgewählten Region erschöpft. Infolgedessen schlägt das IaC-Skript mit dem folgenden Fehler fehl: Der Wert des Parameters text_embedding_capacity muss eine positive Ganzzahl sein.
Verwenden Sie eine der folgenden Optionen:
Ändern Sie die Größe vorhandener Modellbereitstellungen, um Kapazität freizugeben.
Öffnen Sie eine Microsoft-Supportanfrage, um die Modellkapazität zu erhöhen.
Stellen Sie die Ressourcen in einer anderen Azure-Region mit verfügbarer Kapazität bereit.
Die maximale Anzahl von Azure AI Search-Indizes, -Indexern, -Skillsets oder -Datenquellen wurde erreicht. Infolgedessen schlägt das IaC-Skript mit dem folgenden Fehler fehl: Skillset-Kontingent von 50 wurde für diesen Dienst überschritten.
Löschen Sie nicht verwendete Azure AI Search-Indizes, -Indexer, -Skillsets oder -Datenquellen. Wenn eine Bereinigung nicht möglich ist, erhöhen Sie die Azure AI Search-Dienstebene, oder stellen Sie den Dienst in einer anderen Region bereit.
Azure-Ressourcen-Konfigurationsfehler. Dienst-Indikator zeigt nicht den Status "FEHLERFREI" an.
Die Ressourcenerstellung wurde mit falschen Parametern oder Konfigurationswerten in den JSON-Dateien aufgerufen.
Überprüfen Sie die Eingaben für die Ressourcenerstellung auf Richtigkeit, und wiederholen Sie den Ressourcenerstellungsprozess.
In der Plugin-Konfiguration wurden falsche Token oder Ressourcen-Identifikatoren eingegeben.
Überprüfen Sie, ob die richtigen Token und Identifikatoren aus der Ausgabe der Azure-Ressourcenerstellung verwendet werden.
Azure-Ressourcen sind korrekt konfiguriert, überschreiten aber die Grenzwerte.
Überprüfen Sie, ob die erforderlichen Mengenzuteilungen für Ihr Azure-Abonnement und die erstellten Ressourcen vorhanden sind. Überschreiten Sie Ihre Nutzungs- oder Speicherbeschränkungen nicht.
Azure-Dienste sind nicht erreichbar.
Überprüfen Sie Ihre Netzwerkkonfiguration und den Status der Azure-Dienste.
Plugin-Installation
Das Plugin Windchill AI Assistant ist im Plugin-Manager nicht aufgeführt.
Sie sind nicht bei der PTC SaaS Platform angemeldet.
Überprüfen Sie Ihren Anmeldestatus. Die Anmeldung wird durch Auswahl von Ja in einem Windchill Fenster ausgelöst, worauf ein separates Browser-Popup geöffnet wird. Stellen Sie sicher, dass Popups aktiviert sind.
Sie wurden vom Organisations-Administrator Ihrer PTC SaaS Platform nicht dem Produkt Windchill zugewiesen.
Wenden Sie sich an den Organisations-Administrator Ihrer PTC SaaS Platform, damit er Sie dem Produkt Windchill hinzufügt.
Drittanbieter-Cookies sind deaktiviert.
Aktivieren Sie Cookies von Drittanbietern, auch beim Surfen im privaten Modus. Plugins werden im SaaS-Dienst von PTC gehostet, die unabhängig von Ihrer Windchill Installation sind und Cookies erfordern.
Andere Ursachen.
Löschen Sie den Browser-Cache und versuchen Sie es erneut.
Die Installation des Windchill AI Assistant Plugins schlägt mit einem Sicherheitsprüfungsfehler fehl, wobei die folgende Meldung angezeigt wird: "Installation von Windchill AI Assistant ist fehlgeschlagen aufgrund eines Fehlers bei der Sicherheitsprüfung. Wenden Sie sich an den Systemadministrator."
Dieser Sicherheitsfehler kann auftreten, wenn die Plugin-JAR mit einem neueren Java-Build signiert wird, während die Installation auf einem System ausgeführt wird, auf dem ein älterer Build derselben Java-Version läuft.
Stellen Sie sicher, dass in der Kundenumgebung der neueste Java-Build für die entsprechende Java-Version, mit der die Plugin-JAR signiert wird, verwendet wird.
Plugin-Konfiguration
Beim Konfigurieren des Plugins zeigt das System die folgende Fehlermeldung an: "Sie sind nicht berechtigt, die administrativen Einstellungen für den AI Assistant zu konfigurieren. Wenden Sie sich an Ihren Administrator."
Windchill ist mit benutzerdefinierten Zertifikaten konfiguriert.
Führen Sie die folgenden Schritte aus, wenn Windchill mit benutzerdefinierten Zertifikaten für benutzerdefinierte Anwendungen (z.B. Navigate) konfiguriert ist:
1. Kopieren Sie den Inhalt der benutzerdefinierten Zertifikatdatei manuell nach HTTPServer/conf/sslvhostconf.d/allClientCerts.crt.
2. Entfernen Sie die Konfigurationsdatei, die das benutzerdefinierte Zertifikat referenziert.
Dokumentindexierung
Große Dokumente schlagen während des Indexierungsprozesses fehl.
Für die Indexierung gilt eine Obergrenze von 128 MB pro Dokument bzw. 4 Millionen Zeichen für eine einzelne Datei. Bei Dokumenten, die diese Grenzwerte überschreiten, kommt es zu Indexierungsfehlern.
Verwenden Sie einen der folgenden Ansätze:
Teilen Sie große Dokumente in kleinere Dateien auf.
Verhindern Sie die Indexierung großer Dokumente, indem Sie den Zugriff des Indexierungsbenutzers auf diese Dokumente entfernen.
Abfragen geben nach der Installation keine dokumentbasierten Antworten zurück.
Die automatische fortlaufende Indexierung reagiert nur auf Dokumentänderungen im Windchill Depot.
Stellen Sie sicher, dass Ihr Administrator die Synchronisierung ausgelöst hat, indem Sie nach der Installation im Indexierungs-Dashboard mindestens einmal auf Starten klicken.
Die Indexierung wird angehalten oder neue Dokumente werden nicht richtig indiziert, obwohl der Dokumenttyp unterstützt wird.
Die Indexierung wird möglicherweise beendet, da die Ebenenkapazität ausgeschöpft ist.
Überprüfen Sie die Protokolle auf die folgende Fehlermeldung: "Vector index size quota has been exceeded for this service. You must either delete documents first or use a higher SKU for additional quota."
Registerkarte "Windchill AI Assistant"
Die Registerkarte "Windchill AI Assistant" ist nach der Installation nicht sichtbar.
Zwischengespeicherte Browser-Einstellungen verhindern möglicherweise, dass die neue Registerkarte angezeigt wird.
Löschen Sie den Browser-Cache und den Site-Speicher mit den Prüfungs-Tools des Browsers.
Vergewissern Sie sich, dass dem betroffenen Benutzer in den Profileinstellungen Zugriff auf den AI Assistant gewährt wird.
Fordern Sie als letzten Ausweg einen Neustart des Windchill Servers an.
Langsame Reaktionszeiten
Die Generierung von Antworten ist von Faktoren wie der Depot-/Indexgröße, der Verfügbarkeit von Azure-Diensten und der Netzwerkverbindung betroffen.
Wiederholen Sie Ihre Abfrage später, um zu bestimmen, ob es sich um ein vorübergehendes Problem handelt, und versuchen Sie, die Ursache zu identifizieren.
Das System zeigt den folgenden Fehler an: "System bearbeitet eine große Anzahl von Anfragen".
Ratenbegrenzung aufgrund unzureichender Kapazität für Large Language Model (LLM).
Öffnen Sie das Azure AI Foundry-Portal, wählen Sie das Modell "gpt-5-mini" aus, und erhöhen Sie die zugeordnete Kapazität.
Wenn das IaC-Skript erneut ausgeführt wird, wird die Modellkapazität auf den Standardwert von 1000 (1 Million Token pro Minute) zurückgesetzt.
Wenn zusätzliche Kapazität benötigt wird, fordern Sie ein höheres Kontingent an. Weitere Informationen finden Sie unter Azure OpenAI in Microsoft Foundry-Modelle Kontingente und Grenzwerte.
Wenn Sie den Firefox Browser verwenden, dreht sich die Antwortanzeige unendlich weiter.
Wenn während der Antwortgenerierung eine Netzwerkunterbrechung auftritt, kann die Verbindung der Registerkarte "Windchill AI Assistant" zum Backend-Dienst getrennt werden.
Wechseln Sie kurz zu einer anderen Registerkarte im Navigator, und kehren Sie dann zur Registerkarte "Windchill AI Assistant" zurück. Durch diese Aktion wird in der Regel die Verbindung wiederhergestellt. Möglicherweise müssen Sie Ihre Frage erneut einreichen.
War dies hilfreich?