Диагностика проблем
Начните с docker compose ps -a, карточки запуска и логов соответствующего сервиса.
| Симптом | Что проверить |
|---|---|
| Бот не отвечает | Членство в канале, упоминание, include_ids, reconcile_from, токен |
| Workflow не загружается | validate, YAML, строковую revision, пересечения маршрутов |
unknown_profile | Точное имя профиля, активность профиля и аккаунта в Настройках |
validation_error | error.details с путём некорректного поля |
capacity_exhausted | Активные задачи, песочницы в ожидании удаления и лимит параллельности |
sandbox_provision_timeout | Доступность AgentBox и логи worker. Дедлайн первоначальной подготовки действует отдельно от таймаута запуска |
sandbox_cleanup_pending / sandbox_provision_conflict | Проверьте sandbox.error, логи worker и ресурсы в AgentBox. Пустой поиск не доказывает отсутствие ресурса. Слот занят до подтверждения удаления. Состояние песочницы остаётся unavailable и после удаления |
| Ошибка авторизации модели | Авторизация аккаунта, доступ API/worker к его S3-хранилищу и доступ к модели |
| Ошибка подготовки файлов | Доступ к Mattermost из AgentBox, Python, размер файлов |
| Ответ есть, файла нет | Инструкцию outbox, ошибки after_run, ограничения файлов |
| Web сообщает об отсутствии доступа | ORPHEUS_BROWSER_AUTH, SSO и публичный origin |
| Обновления приходят с задержкой | SSE-буферизацию reverse proxy и состояние подключения |
| SAML callback возвращает 401 | Подписи, ACS, время, AuthnStatement и метаданные |
| Старые модель или инструменты | Сохранённую конфигурацию сессии и revision workflow |
Как собрать данные для разбора
Запишите действие пользователя, время, session_id, run_id, код и фазу ошибки. Проверьте, повторяется ли проблема на новой тестовой задаче. Перед передачей логов удалите секреты и ненужные данные пользователей.
Не удаляйте БД и не пересоздавайте все сессии как первый шаг. Например, отказ публикации не означает, что агенту нужно заново выполнять задачу. Сначала проверьте, не появился ли результат в целевой системе.