47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
# llm_project — карта файлов AI-ассистента
|
|
|
|
Всё, что связано с AI-ассистентом документации: планы, документация, тесты, диагностика.
|
|
|
|
## Главное
|
|
|
|
| Файл | Что |
|
|
|---|---|
|
|
| **[docs/ASSISTANT_ARCHITECTURE.md](docs/ASSISTANT_ARCHITECTURE.md)** | **Полная документация**: архитектура, API, поиск, безопасность, деплой, тесты, эмбеддинги v2, инциденты |
|
|
| **[docs/ROADMAP_AND_LIMITS.md](docs/ROADMAP_AND_LIMITS.md)** | **Дорожная карта, границы применимости, план тестирования (DevOps), варианты сбора данных** |
|
|
| [PLAN_docs_ai_assistant_STEPS.md](PLAN_docs_ai_assistant_STEPS.md) | План по шагам (11 этапов) |
|
|
|
|
## Диагностика и обоснования
|
|
|
|
| Файл | Что |
|
|
|---|---|
|
|
| [probe/RESULTS.md](probe/RESULTS.md) | Результаты live-проверки `api.aillm.ru` (response_format, reasoning_effort, лимиты) |
|
|
| [probe/probe_aillm.js](probe/probe_aillm.js) | Скрипт-пробник API |
|
|
| [golden/EVAL_1.md](golden/EVAL_1.md) | Оценка поиска на эталонном наборе |
|
|
| [golden/golden_questions.json](golden/golden_questions.json) | 28 эталонных вопросов с ожидаемыми страницами |
|
|
| [tests/ANALYSIS_bad_llm_output.md](tests/ANALYSIS_bad_llm_output.md) | Разбор отказов 502, причины и фиксы |
|
|
|
|
## Тесты и авто
|
|
|
|
| Файл | Что |
|
|
|---|---|
|
|
| [tests/run_e2e_live.js](tests/run_e2e_live.js) | Прогон 62 вопросов по живому эндпоинту (учёт 429) |
|
|
| [tests/redeploy.js](tests/redeploy.js) | Redeploy tf-docs через Nubes API |
|
|
| [tests/debug_bad_llm_output.js](tests/debug_bad_llm_output.js) | Захват сырого ответа LLM (диагностика) |
|
|
| [tests/RESULTS_LIVE.md](tests/RESULTS_LIVE.md) / .json | Результаты прогонов (5 итераций) |
|
|
|
|
## Как запускать
|
|
|
|
```bash
|
|
# прогон тестов на живом стенде
|
|
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.
|