Resolución de problemas del entorno local
En la siguiente tabla se enumeran los problemas comunes, las posibles causas y las soluciones recomendadas para entornos locales:
Incidencia
Causa posible
Solución
PTC SaaS Platform
No se puede iniciar sesión en la organización.
Sus credenciales no son válidas o la suscripción de su organización se ha visto afectada.
Consulte la comunicación de incorporación o póngase en contacto con su administrador de socios de PTC para solicitar credenciales de PTC SaaS Platform.
Falta la asignación del producto de Windchill.
El producto de Windchill no se ha asignado a su organización.
Póngase en contacto con su administrador de socios de PTC para que asigne el producto de Windchill a su organización.
No se puede asignar administrador al producto de Windchill.
El administrador de Windchill no es miembro de la organización de PTC SaaS Platform.
Invite al administrador de Windchill a la organización de PTC SaaS Platform para conceder permisos para la instalación del plug-in.
Servicios de Azure
Error en la creación del grupo de recursos de Azure.
No tiene permiso para crear un grupo de recursos.
Compruebe que dispone de los permisos necesarios para crear recursos en la suscripción de Azure.
Error en la implementación de infraestructura como código de Azure
La directiva de Azure requiere que existan etiquetas específicas.
Los registros de IaC contienen el código de error RequestDisallowedByPolicy.
Revise las directivas de suscripción de Azure con el administrador de Azure e identifique las etiquetas necesarias. Agregue las etiquetas que faltan al parámetro common_tags y luego vuelva a ejecutar el script de IaC.
Los recursos ya se han creado, o se han creado parcialmente, con el mismo nombre de implementación en otra región.
Los registros de IaC contienen un error similar al siguiente:
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'." }
Quite los servicios, el almacenamiento u otros recursos en conflicto antes de reintentar la creación de recursos, o vuelva a crear los recursos con un nombre de implementación diferente.
Se ha producido un error transitorio en las implementaciones de Azure para AI Foundry.
Los registros de IaC contienen un error similar al siguiente:
IfMatchPreconditionFailed
Vuelva a ejecutar el script de IaC.
Token de autenticación vencido. Los registros de IaC contienen un error similar al siguiente:
ClientAuthenticationError: (ExpiredAuthenticationToken)
Vuelva a ejecutar el script de IaC.
La capacidad del modelo de integración de Azure AI Foundry se agota en la región seleccionada. Como resultado, el script de IaC falla con el siguiente error: el valor del parámetro text_embedding_capacity debe ser un entero positivo.
Utilice una de las siguientes opciones:
Cambie el tamaño de las implementaciones de modelos existentes para liberar capacidad.
Abra una solicitud de soporte de Microsoft para aumentar la capacidad del modelo.
Implemente los recursos en otra región de Azure con capacidad disponible.
Se ha alcanzado el número máximo de índices, indexadores, conjuntos de aptitudes u orígenes de datos de Azure AI Search. Como resultado, se produce un fallo en el script de IaC con el siguiente error: Skillset quota of 50 has been exceeded for this service.
Delete unused Azure AI Search indexes, indexers, skillsets, or data sources. Si la limpieza no es posible, aumente el nivel de servicio de Azure AI Search o implemente el servicio en otra región
Error de configuración de recursos de Azure; el indicador de servicio no muestra el estatus "Sano".
La creación de recursos se invocó con parámetros o valores de configuración incorrectos en los ficheros JSON.
Verifique que las entradas de creación de recursos sean correctas y repita la creación de recursos.
Se han introducido tokens o identificadores de recursos incorrectos en la configuración del plug-in.
Compruebe que se utilizan los tokens e identificadores correctos de la salida de creación de recursos de Azure.
Los recursos de Azure están configurados correctamente pero exceden los límites.
Compruebe que la suscripción de Azure y los recursos creados cuentan con las asignaciones necesarias. No exceda los límites de uso o almacenamiento.
Los servicios de Azure no son accesibles.
Verifique la configuración de la red y el estatus de los servicios de Azure.
Instalación del plug-in
El plug-in de Windchill AI Assistant no se muestra en Administrador de plug-ins.
No ha iniciado sesión en PTC SaaS Platform.
Verifique el estatus de la conexión. La conexión se activa seleccionando en una ventana de Windchill, que abre un elemento emergente independiente del explorador. Asegúrese de que las ventanas emergentes estén activadas.
El administrador de la organización de PTC SaaS Platform no le ha asignado al producto de Windchill.
Póngase en contacto con el administrador de la organización de PTC SaaS Platform para que le añada al producto de Windchill.
Las cookies de terceros están desactivadas.
Habilite las cookies de terceros, incluso cuando navegue en modo privado. Los plug-ins están alojados en servicios SaaS de PTC, que son independientes de su instalación de Windchill y requieren el uso de cookies.
Otras causas.
Borre la caché del explorador y vuelva a intentarlo.
La instalación del plug-in Windchill AI Assistant falla con un error de verificación de seguridad que muestra el siguiente mensaje: "La instalación de Windchill AI Assistant falló debido a un error de verificación de seguridad. Póngase en contacto con su administrador para obtener ayuda".
Este error de seguridad puede producirse si el JAR del plug-in se firma con una compilación de Java más reciente, mientras la instalación se realiza en un sistema que ejecuta una compilación anterior de la misma versión de Java.
Asegúrese de que el entorno del cliente utiliza la última compilación de Java para la versión correspondiente de Java que se utiliza para firmar el fichero JAR del plug-in.
Configuración del plug-in
Al configurar el plug-in, el sistema muestra el siguiente mensaje de error: "No tiene permiso para configurar los ajustes administrativos de AI Assistant. Póngase en contacto con el administrador".
Windchill está configurado con certificados personalizados.
Si Windchill está configurado con certificados personalizados para aplicaciones personalizadas (por ejemplo, la aplicación Navigate), realice los siguientes pasos:
1. Copie manualmente el contenido del fichero de certificado personalizado en HTTPServer/conf/sslvhostconf.d/allClientCerts.crt.
2. Quite el fichero de configuración que hace referencia al certificado personalizado.
Indexación de documentos
Los documentos grandes fallan durante el proceso de indexación.
La indexación tiene un límite superior de 128 MB por documento o 4 millones de caracteres en un fichero individual. Los documentos que superan estos límites producen errores de indexación.
Se debe utilizar uno de los siguientes enfoques:
Divida los documentos grandes en ficheros más pequeños.
Impida la indexación de documentos de gran tamaño quitando el acceso del usuario de indexación a dichos documentos.
Las consultas no devuelven respuestas basadas en documentos después de la instalación.
La indexación continua automatizada solo reacciona a los cambios de documentos del depósito de Windchill.
Verifique que su administrador haya activado la sincronización pulsando Iniciar en el Panel de indexación al menos una vez después de la instalación.
La indexación se detiene o los documentos nuevos no se indexan correctamente, aunque el tipo de documento esté soportado.
La indexación puede detenerse debido al agotamiento de la capacidad del nivel.
Revise los registros para ver el siguiente mensaje de error: "Vector index size quota has been exceeded for this service. You must either delete documents first or use a higher SKU for additional quota."
Ficha Windchill AI Assistant
La ficha Windchill AI Assistant no está visible después de la instalación.
La configuración del explorador en caché puede impedir que aparezca la nueva ficha.
Borre la caché del navegador y el almacenamiento del sitio con las herramientas del inspector del navegador.
Compruebe que el usuario afectado tiene acceso a AI Assistant en la configuración del perfil.
Solicite el reinicio del servidor Windchill como último recurso.
Tiempos de respuesta lentos.
La generación de respuestas se ve afectada por factores como el tamaño del depósito o índice, la disponibilidad de los servicios de Azure y la conexión de red.
Vuelva a intentar la consulta más tarde para determinar si la incidencia es temporal e intentar identificar la causa principal.
El sistema muestra el siguiente error: "Actualmente, el sistema está manejando un gran volumen de solicitudes".
Limitación de velocidad debido a una capacidad insuficiente del modelo de lenguaje grande (LLM).
Abra el portal de Azure AI Foundry, seleccione el modelo gpt-5-mini y aumente la capacidad asignada.
Cuando se vuelve a ejecutar el script de IaC, la capacidad del modelo se restablece al valor predeterminado de 1.000 (1 millón de tokens por minuto).
Si se necesita capacidad adicional, solicite una cuota más alta. Para obtener más información, consulte Azure OpenAI in Microsoft Foundry Models quotas and limits.
Al utilizar el explorador de Firefox, el indicador de respuesta continúa girando indefinidamente.
Si se produce una interrupción de la red durante la generación de la respuesta, la ficha Windchill AI Assistant puede desconectarse del servicio back-end.
Cambie brevemente a otra ficha en el navegador y, a continuación, vuelva a la ficha Windchill AI Assistant. Esta acción normalmente restaura la conexión. Es posible que deba volver a enviar su pregunta.
¿Fue esto útil?