Files

llm_project — карта файлов AI-ассистента

Всё, что связано с AI-ассистентом документации: планы, документация, тесты, диагностика.

Главное

Файл Что
docs/ASSISTANT_ARCHITECTURE.md Полная документация: архитектура, API, поиск, безопасность, деплой, тесты, эмбеддинги v2, инциденты
docs/ROADMAP_AND_LIMITS.md Дорожная карта, границы применимости, план тестирования (DevOps), варианты сбора данных
PLAN_docs_ai_assistant_STEPS.md План по шагам (11 этапов)

Диагностика и обоснования

Файл Что
probe/RESULTS.md Результаты live-проверки api.aillm.ru (response_format, reasoning_effort, лимиты)
probe/probe_aillm.js Скрипт-пробник API
golden/EVAL_1.md Оценка поиска на эталонном наборе
golden/golden_questions.json 28 эталонных вопросов с ожидаемыми страницами
tests/ANALYSIS_bad_llm_output.md Разбор отказов 502, причины и фиксы

Тесты и авто

Файл Что
tests/run_e2e_live.js Прогон 62 вопросов по живому эндпоинту (учёт 429)
tests/redeploy.js Redeploy tf-docs через Nubes API
tests/debug_bad_llm_output.js Захват сырого ответа LLM (диагностика)
tests/RESULTS_LIVE.md / .json Результаты прогонов (5 итераций)

Как запускать

# прогон тестов на живом стенде
node llm_project/tests/run_e2e_live.js --stand nubes-test

# redeploy сервиса
node llm_project/tests/redeploy.js

Связанные HowTo

  • ~/nubes/HowTo/howto-publish-docs-site.md — публикация сайта (виджет).
  • ~/nubes/HowTo/howto-tf-docs-redeploy-api.md — redeploy через API.
  • ~/nubes/HowTo/howto-sync-to-vm213.md — синк на ВМ 213.