Подключаемый модуль Windchill AI Assistant > Устранение проблем и известные проблемы > Устранение неисправностей для локальной среды
Устранение неисправностей для локальной среды
В следующей таблице перечислены типичные проблемы, возможные причины и рекомендуемые решения для локальных сред.
Проблема
Возможная причина
Решение
PTC SaaS Platform
Невозможно войти в организацию.
Ваши учетные данные недействительны, или это влияет на подписку вашей организации.
Обратитесь к специалисту по присоединению или к своему менеджеру по работе с партнерами PTC, чтобы запросить учетные данные PTC SaaS Platform.
Отсутствует назначение продукта 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'." }
Удалите все конфликтующие службы, хранилища или другие ресурсы перед повторной попыткой создания ресурсов или повторно создайте ресурсы, используя другое наименование развертывания.
Возник временный сбой в развертываниях Azure для AI Foundry.
Журналы IaC содержат сообщение об ошибке, аналогичное следующему:
IfMatchPreconditionFailed
Повторно выполните сценарий IaC.
Истек срок действия лексемы аутентификации. Журналы IaC содержат сообщение об ошибке, аналогичное следующему:
ClientAuthenticationError: (ExpiredAuthenticationToken)
Повторно выполните сценарий IaC.
Исчерпана вместимость модели встраивания Azure AI Foundry в выбранном регионе. В результате возникнет сбой сценария IaC со следующим сообщением об ошибке: "Значение параметра text_embedding_capacity должно быть положительным целым числом".
Используйте один из следующих вариантов.
Измените размер существующих развертываний моделей, чтобы высвободить вместимость.
Откройте запрос в службу поддержки Microsoft, чтобы увеличить вместимость модели.
Разверните ресурсы в другом регионе Azure с доступной вместимостью.
Достигнуто максимальное число индексов, индексаторов, наборов навыков или источников данных поиска Azure AI. В результате возникнет сбой сценария IaC со следующим сообщением об ошибке: "Превышена квота набора навыков 50 для этой службы".
Удалите неиспользуемые индексы, индексаторы, наборы навыков или источники данных поиска Azure AI. Если очистка невозможна, повысьте уровень службы поиска AI Azure или разверните службу в другом регионе
Ошибка конфигурации ресурсов Azure, индикатор сервиса не показывает статус HEALTHY.
Процесс создания ресурса был вызван с неверными параметрами или значениями конфигурации в файлах JSON.
Проверьте правильность входных данных создания ресурса и повторите процесс создания ресурса.
В конфигурации подключаемого модуля введены неверные лексемы или идентификаторы ресурсов.
Убедитесь, что используются правильные лексемы и идентификаторы из выходных данных создания ресурсов Azure.
Ресурсы Azure сконфигурированы правильно, но превышают пределы.
Убедитесь, что для подписки Azure и созданных ресурсов имеются необходимые допуски. Не превышайте ограничения для использования или хранения.
Сервисы Azure недоступны.
Проверьте конфигурацию сети и состояние сервисов Azure.
Установка подключаемого модуля
Подключаемый модуль Windchill AI Assistant отсутствует в Диспетчере подключаемых модулей.
Вы не вошли в PTC SaaS Platform.
Проверьте статус входа в систему. Вход в систему инициируется нажатием кнопки Да в модальном окне Windchill, которое открывает отдельное всплывающее окно браузера. Убедитесь, что всплывающие окна включены.
Вы не назначены для работы с продуктом Windchill вашим администратором организации PTC SaaS Platform.
Обратитесь к администратору организации PTC SaaS Platform, чтобы добавить вас в продукт Windchill.
Сторонние файлы cookie отключены.
Включите сторонние файлы cookie, в том числе при просмотре в приватном режиме. Подключаемые модули размещаются в сервисах SaaS PTC отдельно от установки Windchill и требуют включения файлов cookie.
Другие причины.
Очистите кэш браузера и повторите попытку.
Сбой установки подключаемого модуля Windchill AI Assistant с ошибкой проверки безопасности с отображением следующего сообщения: "Установка WindchillAIAssistant завершена неудачно из-за сбоя проверки безопасности. Обратитесь за помощью к системному администратору".
Такая ошибка безопасности может возникать, когда подключаемый модуль JAR подписан с использованием более новой сборки Java, тогда как установка выполняется в системе, в которой выполняется более старая сборка той же версии Java.
Убедитесь, что в клиентской среде используется последняя сборка Java для соответствующей версии Java, которая используется для подписания подключаемого модуля JAR.
Конфигурация подключаемого модуля
При конфигурировании подключаемого модуля система отображает следующее сообщение об ошибке: "У вас нет разрешения на конфигурирование административных настроек AI Assistant. Обратитесь к администратору".
Windchill сконфигурирован с использованием пользовательских сертификатов.
Если Windchill сконфигурирован с пользовательскими сертификатами для пользовательских приложений (например, для приложения Navigate), выполните следующие шаги.
1. Вручную скопируйте содержимое файла пользовательского сертификата в файл HTTPServer/conf/sslvhostconf.d/allClientCerts.crt.
2. Удалите файл конфигурации, который ссылается на пользовательский сертификат.
Индексирование документов
В больших документах возникают сбои в процессе индексирования.
Существует верхний предел для индексирования, составляющий 128 МБ на документ или 4 миллиона символов для отдельного файла. Превышение этих ограничений в документах приводит к ошибкам индексирования.
Вместо этого используйте один из следующих способов.
Разделяйте большие документы на более мелкие файлы.
Предотвращайте индексирование больших документов путем удаления доступа пользователя индексирования к этим документам.
Запросы не возвращают основанные на документах ответы после установки.
Автоматизированное непрерывное индексирование реагирует только на изменения документов в архиве Windchill.
Убедитесь, что администратор инициировал синхронизацию, щелкнув Запустить на Инструментальной панели индексирования хотя бы один раз после установки.
Индексирование останавливается, или новые документы индексируются неправильно, даже если данный тип документа поддерживается.
Индексирование может остановиться, если исчерпана вместимость уровня.
Просмотрите журналы и найдите следующее сообщение об ошибке: "Превышена квота размера индекса вектора для этого сервиса. Необходимо либо сначала удалить документы, либо использовать более высокий уровень SKU для получения дополнительной квоты".
Вкладка Windchill AI Assistant
Вкладка Windchill AI Assistant невидима после установки.
Кэшированные настройки браузера могут помешать отображению новой вкладки.
Очистите кэш браузера и хранилище сайта, используя средства инспектора браузера.
Убедитесь, что изменяемому пользователю предоставлен доступ к AI Assistant в настройках профиля.
В качестве крайней меры запросите перезагрузку сервера Windchill.
Длительное время ответа.
На генерирование ответа влияют такие факторы, как размер архива или индекса, доступность сервисов Azure и сетевое подключение.
Повторите запрос позже, чтобы проверить, является ли проблема временной, и определить основную причину.
Система отображает следующее сообщение об ошибке: "В настоящее время система обрабатывает большой объем запросов".
Ограничение скорости из-за недостаточной вместимости большой языковой модели (LLM, Large Language Model).
Откройте портал Azure AI Foundry, выберите модель gpt-5-mini и увеличьте выделенную вместимость.
При повторном выполнении сценария IaC вместимость модели сбрасывается до значения по умолчанию 1000 (1 миллион лексем в минуту).
Если требуется дополнительная вместимость, запросите более высокую квоту. Дополнительные сведения см. в статье Квоты и ограничения Azure OpenAI в моделях Microsoft Foundry.
При использовании браузера Firefox индикатор ответа продолжает вращаться бесконечно.
При возникновении прерывания соединения в сети во время генерации ответа может быть разорвано соединение вкладки Windchill AI Assistant с серверной службой.
Переключитесь на короткое время на другую вкладку в навигаторе, а затем вернитесь на вкладку Windchill AI Assistant. Обычно это действие восстанавливает соединение. Возможно, вам придется отправить свой вопрос еще раз.
Было ли это полезно?