SagaAI

Главная / Документация / Решение проблем

Решение проблем

Решение проблем

streamlit: команда не найдена

Окружение не активировано или зависимости не установлены:

pip install -r requirements.txt
python -m streamlit run app.py

Приложение стартует, но страница пустая

Проверьте терминал: Streamlit печатает ошибки импорта туда, а не в браузер. Частая причина — несовпадение версий библиотек. Сверьте их:

pip install -U -r requirements.txt

Порт 8501 занят

Запустите на другом порту:

streamlit run app.py --server.port 8502

Предупреждение о версиях при старте

Это ожидаемое поведение: приложение проверяет установленные библиотеки и просит выполнить конкретную команду установки. Выполните её — предупреждение исчезнет.

Ответов нет, в журнале ошибка провайдера

Различайте два класса ошибок:

  • ошибка провайдера — неверный ключ, исчерпана квота, недоступен адрес API;
  • внутренняя ошибка — сбой в самой платформе.

Ошибки провайдера помечены как повторяемые или неповторяемые: первые платформа повторяет сама, вторые требуют вашего вмешательства (ключ, тариф, адрес).

База знаний не находит документ

  1. Проверьте, что документ проиндексирован после загрузки.
  2. Задайте вопрос словами из документа: лексический поиск чувствителен к терминам.
  3. Если документ — скан без текстового слоя, распознайте его до загрузки.

Долгая задача обрывается

Платформа защищает контекст от переполнения и выносит состояние задачи в отдельный журнал. Если задача всё равно обрывается, разбейте её на шаги: короткие задачи доводятся до конца надёжнее.

Обновление не применилось

Раздел «Обновления» показывает состояние каждого файла. Скачанные обновления применяются при следующем холодном старте — перезапустите приложение. Файлы сверяются по контрольным суммам: недокачанный файл не применяется.

Тесты падают после ваших правок

python -m pytest

Начните с первого упавшего теста: он обычно указывает на модуль, который вы изменили. Полный набор — около 2690 тестов, он же служит защитой от регрессий.

Где спросить

Технические вопросы — в issues репозитория TVD2100/sagaai-platform. Проблемы безопасности туда писать не нужно: см. раздел «Безопасность».