Если возникли проблемы
При первом запуске ошибка dependency ... is unhealthy
При самом первом запуске Langfuse создает базы данных и выполняет миграции ClickHouse и Postgres. Это занимает несколько минут, и docker compose up -d может не дождаться их и завершиться ошибкой вида:
dependency failed to start: container langfuse-workshop-clickhouse-1 is unhealthy
Это нормально - просто выполните команду еще раз (иногда нужно 2-3 раза), пока все контейнеры не запустятся:
docker compose up -d
Проект не запускается
Попробуйте удалить все контейнеры и volume с именем langfuse*.
docker compose down
docker volume ls
docker volume rm langfuse-workshop_qdrant_data
docker volume rm ...
...
docker compose up -d
Проверьте настройки в .env, они должны выглядеть примерно так:
Агент выдает ошибку при обработке запроса
Убедитесь, что все контейнеры запущены с помощью docker ps -a, должно быть так:
Убедитесь, что в https://console.mws.ru/ вы корректно создали сервисный аккаунт и развернули все 4 модели (как описано в разделе Подготовка).
Агент долго отвечает, а в логах есть LLM rate limit
MWS GPT ограничивает число запросов в минуту для каждой модели: у glm-5-3 лимит 10 запросов в минуту, а один ответ агента - это 3-6 запросов к LLM. Если лимит исчерпан, агент ждет его сброса и повторяет запрос, в логах cookbook-agent появляется сообщение LLM rate limit for glm-5-3, retry in ...s. Это нормально - просто подождите ответа.
Агент или судья получают ошибку 403 ACCESS_DENIED
MWS GPT отвечает 403 Forbidden с текстом ACCESS_DENIED, если закончился баланс проекта, ключ сервисного аккаунта удален или у аккаунта нет роли gpt.inferencer. Проверьте баланс и сервисный аккаунт в https://console.mws.ru/.
Оценки LLM-as-a-judge не появляются в трейсах
Откройте Evaluators и посмотрите статус вашего оценщика. Если он на паузе (paused) с причиной EVAL_MODEL_CONFIG_INVALID, значит Langfuse не смог обратиться к модели-судье - например, когда вы создавали оценщик, у MWS GPT закончился баланс или был неверно указан ключ.
После того как доступ к модели восстановлен, оценщик сам не включится. Откройте его, проверьте модель (qwen3-6-35b-a3b) и сохраните заново - Langfuse повторит проверочный запрос и снимет паузу. Если в Settings \ LLM Connections был неверный ключ, сначала исправьте его там.
Сценарий не воспроизводится
Убедитесь, что выставлены корректные флаги в .env и изменения сохранены.
Выполните полный перезапуск проекта
docker compose up -d --force-recreate
Если ничего не помогает
Воспользуйтесь командой docker ai, чтобы спросить совета у ИИ-помощника Gordon. Объясните ему суть проблемы или симптомы ошибки.
