|
Problema
|
Possibile causa
|
Soluzione
|
|---|---|---|
|
PTC SaaS Platform
|
||
|
Impossibile accedere all'organizzazione.
|
Le credenziali non sono valide o il problema dipende dalla sottoscrizione dell'organizzazione.
|
Per richiedere le credenziali di PTC SaaS Platform, fare riferimento alle comunicazioni di onboarding o contattare il PTC Partner Manager di riferimento.
|
|
Assegnazione del prodotto Windchill mancante.
|
Il prodotto Windchill non è stato assegnato all'organizzazione.
|
Contattare il PTC Partner Manager per assegnare il prodotto Windchill all'organizzazione.
|
|
Impossibile assegnare un amministratore al prodotto Windchill.
|
L'amministratore Windchill non è membro dell'organizzazione PTC SaaS Platform.
|
Invitare l'amministratore Windchill nell'organizzazione PTC SaaS Platform per concedere i permessi per l'installazione del plug-in.
|
|
Servizi di Azure
|
||
|
Creazione del gruppo di risorse di Azure non riuscita.
|
Non si dispone dei permessi per creare un gruppo di risorse.
|
Verificare di disporre dei permessi necessari per creare le risorse nella sottoscrizione di Azure.
|
|
La distribuzione di Infrastructure as Code di Azure non riesce.
|
I criteri di Azure richiedono la presenza di tag specifici.
I log IaC contengono il codice di errore RequestDisallowedByPolicy.
|
Esaminare i criteri di sottoscrizione di Azure con l'amministratore di Azure e identificare i tag necessari. Aggiungere i tag mancanti al parametro common_tags, quindi rieseguire lo script IaC.
|
|
Le risorse sono già state create, o parzialmente create, utilizzando lo stesso nome di distribuzione in una regione diversa.
I log IaC contengono un errore simile al seguente:
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'." } |
Rimuovere eventuali servizi, spazio di archiviazione o altre risorse in conflitto prima di ritentare la creazione delle risorse oppure ricreare le risorse utilizzando un nome di distribuzione diverso.
|
|
|
Si è verificato un errore temporaneo nelle distribuzioni di Azure per AI Foundry.
I log IaC contengono un errore simile al seguente:
IfMatchPreconditionFailed
|
Rieseguire lo script IaC.
|
|
|
Token di autenticazione scaduto. I log IaC contengono un errore simile al seguente:
ClientAuthenticationError: (ExpiredAuthenticationToken)
|
Rieseguire lo script IaC.
|
|
|
La capacità del modello di embedding di Azure AI Foundry è esaurita nella regione selezionata. Di conseguenza, lo script IaC restituisce un errore indicante che il valore del parametro text_embedding_capacity deve essere un numero intero positivo.
|
Utilizzare una delle opzioni riportate di seguito.
• Ridimensionare le distribuzioni di modelli esistenti per liberare capacità.
• Aprire una richiesta di supporto Microsoft per aumentare la capacità del modello.
• Distribuire le risorse in una regione di Azure diversa con capacità disponibile.
|
|
|
È stato raggiunto il numero massimo di indici, indicizzatori, insiemi di competenze o origini dei dati di Azure AI Search. Di conseguenza, lo script IaC restituisce un errore indicante che la quota dell'insieme di competenze di 50 è stata superata per questo servizio.
|
Eliminare gli indici, gli indicizzatori, gli insiemi di competenze o le origini dei dati di Azure AI Search inutilizzati. Se la pulizia non è possibile, aumentare il livello di servizio di Azure AI Search o distribuire il servizio in una regione diversa.
|
|
|
Errore di configurazione delle risorse di Azure. L'indicatore del servizio non mostra lo stato "INTEGRO".
|
La creazione delle risorse è stata richiamata con valori di configurazione o parametri errati nei file JSON.
|
Verificare la correttezza degli input per la creazione delle risorse e ripetere il processo di creazione delle risorse.
|
|
Nella configurazione del plug-in sono stati immessi token o identificatori di risorsa non corretti.
|
Verificare che vengano utilizzati i token e gli identificatori corretti dell'output di creazione della risorsa di Azure.
|
|
|
Le risorse di Azure sono configurate correttamente, ma superano i limiti.
|
Verificare che la sottoscrizione di Azure e le risorse create dispongano delle concessioni necessarie. Non superare i limiti di utilizzo o di archiviazione.
|
|
|
I servizi di Azure non sono raggiungibili.
|
Verificare la configurazione di rete e lo stato dei servizi di Azure.
|
|
|
Installazione del plug-in
|
||
|
Il plug-in Windchill AI Assistant non è elencato in Gestione plug-in.
|
Non è stato effettuato l'accesso a PTC SaaS Platform.
|
Verificare lo stato di accesso. L'accesso viene attivato selezionando Sì in una finestra di Windchill, che apre una finestra popup del browser separata. Assicurarsi che i popup siano attivati.
|
|
L'utente non è stato assegnato al prodotto Windchill dall'amministratore d'organizzazione PTC SaaS Platform.
|
Contattare l'amministratore d'organizzazione PTC SaaS Platform per essere aggiunto al prodotto Windchill.
|
|
|
I cookie di terze parti sono disattivati.
|
Attivare i cookie di terze parti, anche durante la navigazione in modalità privata. I plug-in sono ospitati nei servizi SaaS di PTC, separati dall'installazione di Windchill, e richiedono cookie.
|
|
|
Altre cause.
|
Cancellare la cache del browser e riprovare.
|
|
|
L'installazione del plug-in Windchill AI Assistant non riesce con un errore di verifica della sicurezza e viene visualizzato il seguente messaggio: "Installazione di WindchillAIAssistant non riuscita a causa di un errore di verifica della sicurezza. Per assistenza, contattare l'amministratore."
|
Questo errore di sicurezza si può verificare se il JAR del pug-in è firmato utilizzando una build di Java più recente mentre l'installazione viene eseguita in un sistema che utilizza una build precedente della stessa versione di Java.
|
Accertarsi che l'ambiente del cliente utilizzi la build di Java più recente per la versione di Java corrispondente utilizzata per firmare il JAR del plug-in.
|
|
Configurazione del plug-in
|
||
|
Durante la configurazione del plug-in, il sistema visualizza il messaggio di errore seguente: "Non si dispone del permesso per configurare le impostazioni di amministrazione di AI Assistant. Contattare l'amministratore."
|
Windchill è configurato con certificati personalizzati.
|
Se Windchill è configurato con certificati personalizzati per applicazioni personalizzate (ad esempio, l'app Navigate), attenersi alla procedura descritta di seguito.
1. Copiare manualmente il contenuto del file dei certificati personalizzati in HTTPServer/conf/sslvhostconf.d/allClientCerts.crt.
2. Rimuovere il file di configurazione che fa riferimento al certificato personalizzato.
|
|
Indicizzazione dei documenti
|
||
|
I documenti di grandi dimensioni causano un errore durante il processo di indicizzazione.
|
L'indicizzazione ha un limite massimo di 128 MB per documento o 4 milioni di caratteri per singolo file. I documenti che superano questi limiti generano errori di indicizzazione.
|
Utilizzare uno degli approcci di seguito indicati.
• Dividere i documenti di grandi dimensioni in file più piccoli.
• Impedire l'indicizzazione di documenti di grandi dimensioni rimuovendo l'accesso a tali documenti da parte dell'utente per l'indicizzazione.
|
|
Le interrogazioni non restituiscono risposte basate su documenti dopo l'installazione.
|
L'indicizzazione continua automatizzata reagisce solo alle modifiche dei documenti presenti nell'archivio di Windchill.
|
Verificare che l'amministratore abbia attivato la sincronizzazione facendo clic su Avvia in Dashboard indicizzazione almeno una volta dopo l'installazione.
|
|
L'indicizzazione si interrompe o i nuovi documenti non vengono indicizzati correttamente, anche se il tipo di documento è supportato.
|
È possibile che l'indicizzazione venga interrotta a causa dell'esaurimento della capacità del livello.
|
Esaminare i log per controllare se contiene il messaggio di errore seguente: "Vector index size quota has been exceeded for this service. You must either delete documents first or use a higher SKU for additional quota."
|
|
Scheda Windchill AI Assistant
|
||
|
La scheda Windchill AI Assistant non è visibile dopo l'installazione.
|
Le impostazioni del browser memorizzate nella cache potrebbero impedire la visualizzazione della nuova scheda.
|
Cancellare la cache del browser e lo spazio di archiviazione del sito utilizzando gli strumenti di verifica del browser.
Verificare che all'utente interessato sia concesso l'accesso ad AI Assistant nelle impostazioni del profilo.
Come ultima alternativa, richiedere il riavvio del server Windchill.
|
|
Tempi di risposta lenti.
|
La generazione della risposta è influenzata da fattori quali la dimensione dell'archivio o dell'indice, la disponibilità dei servizi di Azure e la connessione di rete.
|
Riprovare l'interrogazione in un secondo momento per stabilire se il problema è temporaneo e provare a identificare la causa principale.
|
|
Viene visualizzato il seguente errore: "Il sistema gestisce al momento un elevato volume di richieste".
|
Limitazione della velocità dovuta a capacità insufficiente di LLM (Large Language Model).
|
Aprire il portale Azure AI Foundry, selezionare il modello gpt-5-mini e aumentare la capacità allocata.
Quando lo script IaC viene rieseguito, la capacità del modello viene reimpostata sul valore di default di 1000 (1 milione di token al minuto).
Se è necessaria capacità aggiuntiva, richiedere una quota maggiore. Per ulteriori informazioni, vedere Azure OpenAI in Microsoft Foundry Models quotas and limits.
|
|
Quando si utilizza il browser Firefox, l'indicatore di risposta continua a girare all'infinito.
|
Se si verifica un'interruzione della rete durante la generazione della risposta, la scheda Windchill AI Assistant potrebbe disconnettersi dal servizio di back-end.
|
Passare brevemente a un'altra scheda nel navigatore, quindi tornare alla scheda Windchill AI Assistant. Questa azione in genere ripristina la connessione. Potrebbe essere necessario inviare nuovamente la domanda.
|