110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# NDC AI First Layer (LLM Normalizer Playground)
|
||
|
||
Локальный модуль `front + back` для нормализации бухгалтерских запросов через OpenAI token.
|
||
|
||
Ключевые свойства:
|
||
- русифицированный GUI (терминология `NDC`);
|
||
- backend-proxy (ключ не уходит во фронт);
|
||
- Responses API + structured JSON schema `normalized_query_v1` / `normalized_query_v2` / `normalized_query_v2_0_1`;
|
||
- trace/history/eval;
|
||
- совместимый `accounting-agent` namespace для будущей интеграции в `dc_node`.
|
||
|
||
## Быстрый запуск (Windows)
|
||
|
||
1. Опционально: отдельная среда Miniconda
|
||
|
||
```powershell
|
||
conda create -n ndc-gui nodejs=22 -y
|
||
conda activate ndc-gui
|
||
```
|
||
|
||
2. Backend
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer\backend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
3. Frontend (в новом терминале)
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer\frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
4. Открыть GUI
|
||
|
||
- `http://localhost:5174`
|
||
|
||
Backend по умолчанию:
|
||
- `http://localhost:8787`
|
||
|
||
Чтобы включить live-probe в 1С через MCP (для `hybrid_store_plus_live` и `live_mcp_drilldown`), задайте переменные перед запуском backend:
|
||
|
||
```powershell
|
||
$env:FEATURE_ASSISTANT_MCP_RUNTIME_V1='1'
|
||
$env:ASSISTANT_MCP_PROXY_URL='http://127.0.0.1:6003'
|
||
$env:ASSISTANT_MCP_CHANNEL='default'
|
||
```
|
||
|
||
## Запуск из одной папки (VS Code)
|
||
|
||
Открой в VS Code папку:
|
||
- `X:\1C\NDC_1C\llm_normalizer`
|
||
|
||
Дальше 2 варианта:
|
||
|
||
1. Через Tasks:
|
||
- `Terminal -> Run Task -> NDC: Install All` (первый раз)
|
||
- `Terminal -> Run Task -> NDC: Dev All (Backend + Frontend)`
|
||
|
||
2. Через одну команду в терминале:
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer
|
||
start-dev.cmd
|
||
```
|
||
|
||
С live-MCP (прокси 1С на `127.0.0.1:6003`):
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer
|
||
start-dev-mcp.cmd
|
||
```
|
||
|
||
Или:
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer
|
||
npm.cmd run dev:all
|
||
```
|
||
|
||
## Основные endpoint-ы
|
||
|
||
- `POST /api/openai/test-connection`
|
||
- `POST /api/normalize`
|
||
- `POST /api/eval/run`
|
||
- `GET /api/history`
|
||
- `GET /api/history/:trace_id`
|
||
- `POST /api/presets/save`
|
||
- `GET /api/presets`
|
||
- `GET /api/health`
|
||
- `GET /api/accounting-agent/v1/health`
|
||
|
||
## Где хранятся данные
|
||
|
||
- traces: `llm_normalizer/data/traces`
|
||
- presets: `llm_normalizer/data/presets`
|
||
- eval cases/reports: `llm_normalizer/data/eval_cases`
|
||
|
||
Для `POST /api/eval/run` поддержан batch-ввод через `rawQuestions` (разделитель `;` или пустая строка).
|
||
|
||
## Тесты backend
|
||
|
||
```powershell
|
||
cd X:\1C\NDC_1C\llm_normalizer\backend
|
||
npm test
|
||
```
|