Browse Source
- Страница /settings: ввод и проверка API ключа DeepSeek - POST /api/llm/generate — генерация вопросов по названию теста - POST /api/llm/improve — улучшение формулировки вопроса + ответов (модал с галочками) - POST /api/llm/distractors — генерация дистракторов - POST /api/llm/review — рецензия теста + кнопка «Предложить вариант» - POST /api/llm/improve_all — улучшение всего теста с постатейным сравнением - Миграция 004: таблица settings (key-value) - Шапка приложения с навигацией на /settings Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>dev-new-design-page-createtest
Aleksey Razorvin
2 months ago
19 changed files with 1485 additions and 43 deletions
@ -0,0 +1,101 @@
|
||||
# ШАГ 011 — Спринт 4: AI-помощник (DeepSeek) |
||||
|
||||
**Дата:** 2026-03-21 |
||||
**Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники. |
||||
|
||||
--- |
||||
|
||||
## Запрос |
||||
|
||||
> запускам спринт 4 |
||||
|
||||
--- |
||||
|
||||
## Реализовано |
||||
|
||||
Интеграция с DeepSeek LLM при создании и редактировании тестов. Страница настроек для управления API ключом. |
||||
|
||||
--- |
||||
|
||||
## Новые файлы |
||||
|
||||
``` |
||||
backend/app/models/setting.py ← модель Setting (key-value) |
||||
backend/app/schemas/setting.py ← SettingOut, SettingUpdate |
||||
backend/app/services/__init__.py ← пакет services |
||||
backend/app/services/llm.py ← DeepSeek клиент (все 4 функции) |
||||
backend/app/api/settings.py ← GET/PUT /api/settings/{key} |
||||
backend/app/api/llm.py ← POST /api/llm/check|generate|improve|distractors|review |
||||
backend/alembic/versions/004_settings.py ← миграция: таблица settings |
||||
frontend/src/api/settings.ts ← API клиент настроек |
||||
frontend/src/api/llm.ts ← API клиент LLM |
||||
frontend/src/pages/Settings/index.tsx ← страница /settings |
||||
``` |
||||
|
||||
## Изменённые файлы |
||||
|
||||
``` |
||||
backend/app/main.py ← зарегистрированы роутеры settings и llm |
||||
backend/alembic/env.py ← импорт модели setting |
||||
backend/requirements.txt ← добавлен openai==1.57.0 |
||||
frontend/src/components/TestForm/index.tsx ← добавлены AI-кнопки |
||||
frontend/src/App.tsx ← Layout с шапкой, роут /settings |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## API эндпоинты (новые) |
||||
|
||||
| Метод | URL | Описание | |
||||
|-------|-----|----------| |
||||
| GET | `/api/settings/{key}` | Получить значение настройки | |
||||
| PUT | `/api/settings/{key}` | Сохранить значение настройки | |
||||
| POST | `/api/llm/check` | Проверить подключение к DeepSeek | |
||||
| POST | `/api/llm/generate` | Сгенерировать вопросы по теме | |
||||
| POST | `/api/llm/improve` | Улучшить формулировку вопроса | |
||||
| POST | `/api/llm/distractors` | Сгенерировать дистракторы | |
||||
| POST | `/api/llm/review` | Проверить качество всего теста | |
||||
|
||||
--- |
||||
|
||||
## Схема БД (новое) |
||||
|
||||
``` |
||||
settings |
||||
key VARCHAR(100) PK |
||||
value TEXT nullable |
||||
updated_at TIMESTAMP auto-updated |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## AI-функции в форме теста |
||||
|
||||
| Кнопка | Расположение | Действие | |
||||
|--------|-------------|---------| |
||||
| «Сгенерировать с AI» | Над списком вопросов | Открывает модал → ввод темы → превью → «Применить все вопросы» | |
||||
| «Проверить тест» | Над списком вопросов | Открывает модал с рекомендациями AI по всему тесту | |
||||
| «Улучшить» | В шапке каждого вопроса | Заменяет текст вопроса улучшенной AI-формулировкой | |
||||
| «Дистракторы» | В шапке каждого вопроса | Добавляет 3 новых неправильных варианта к вопросу | |
||||
|
||||
--- |
||||
|
||||
## Технические детали |
||||
|
||||
- DeepSeek API совместим с OpenAI SDK: `AsyncOpenAI(base_url="https://api.deepseek.com")` |
||||
- Модель: `deepseek-chat` |
||||
- `response_format={"type": "json_object"}` для generate и distractors — гарантирует JSON-ответ |
||||
- API ключ хранится в таблице `settings` с ключом `deepseek_api_key`; фронт ключ не видит |
||||
- Шапка приложения: новый `Layout` с `AppHeader` — ссылка «Настройки» в правом углу |
||||
|
||||
--- |
||||
|
||||
## Следующие шаги |
||||
|
||||
- [x] Спринт 1: Инфраструктура + Создание тестов |
||||
- [x] Спринт 2: Прохождение теста + результат |
||||
- [x] Спринт 3: Редактирование + версионность |
||||
- [x] Спринт 4: AI-помощник (DeepSeek) |
||||
- [ ] Спринт 5: Трекер результатов |
||||
- [ ] Спринт 6: Авторизация и роли |
||||
- [ ] Спринт 7: Уведомления в MAX |
||||
@ -0,0 +1,78 @@
|
||||
# ШАГ 012 — Спринт 4: Доработки после тестирования |
||||
|
||||
**Дата:** 2026-03-21 |
||||
**Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники. |
||||
|
||||
--- |
||||
|
||||
## Запрос (серия правок после тестирования) |
||||
|
||||
> 1. «Сгенерировать с AI» не должен спрашивать тему — использовать название теста |
||||
> 2. «Улучшить» должен показывать сравнение старого и нового с галочками, а не затирать текст |
||||
> 3. «Проверить тест» → добавить кнопку «Предложить вариант» с полным сравнением всего теста |
||||
|
||||
--- |
||||
|
||||
## Доработки |
||||
|
||||
### 1. Кнопка «Сгенерировать с AI» |
||||
|
||||
**Было:** при нажатии открывался модал с полем ввода темы. |
||||
|
||||
**Стало:** |
||||
- Кнопка задизаблена, пока не заполнено поле «Название теста» (`shouldUpdate` на поле `title`) |
||||
- При нажатии сразу берёт название теста как тему и запускает генерацию |
||||
- Открывается модал с анимацией загрузки → превью вопросов → «Применить» / «Сгенерировать заново» |
||||
|
||||
### 2. Кнопка «Улучшить» в карточке вопроса |
||||
|
||||
**Было:** заменяла текст вопроса новой формулировкой без предупреждения. |
||||
|
||||
**Стало:** |
||||
- Открывается модал с двумя колонками: текущая формулировка и предложение AI |
||||
- Изменения разбиты на позиции: текст вопроса + каждый вариант ответа отдельно |
||||
- Чекбокс «Применить» у каждой позиции |
||||
- Кнопка «Применить выбранные» — применяет только отмеченные пункты |
||||
|
||||
**Изменения в бэкенде:** |
||||
- `improve_question(db, question, answers)` — теперь принимает список ответов и возвращает JSON `{question, answers[]}` |
||||
- `POST /api/llm/improve` — `ImproveRequest` добавлено поле `answers`, `ImproveResponse` теперь `{improved_question, improved_answers[]}` |
||||
|
||||
### 3. Кнопка «Предложить вариант» в модале «Проверить тест» |
||||
|
||||
**Новая кнопка** появляется после получения рекомендаций AI. |
||||
|
||||
**Поведение:** |
||||
- При нажатии вызывает новый `POST /api/llm/improve_all` |
||||
- Модал переключается в режим сравнения: весь тест постранично |
||||
- Для каждого вопроса: текущий vs AI-предложение + чекбокс |
||||
- Для каждого варианта ответа: текущий vs AI-предложение + чекбокс |
||||
- Правильные ответы помечены `(правильный ✓)` |
||||
- Кнопки: «Применить выбранные» / «← К рекомендациям» / «Закрыть» |
||||
|
||||
**Новые файлы/функции бэкенда:** |
||||
- `improve_all(db, title, questions)` в `services/llm.py` |
||||
- `POST /api/llm/improve_all` в `api/llm.py` |
||||
|
||||
--- |
||||
|
||||
## Изменённые файлы |
||||
|
||||
``` |
||||
backend/app/services/llm.py ← improve_question принимает answers; новая функция improve_all |
||||
backend/app/api/llm.py ← обновлён ImproveRequest/ImproveResponse; новый /improve_all |
||||
frontend/src/api/llm.ts ← обновлена сигнатура improve; новый метод improveAll |
||||
frontend/src/components/TestForm/ ← все три доработки UI |
||||
``` |
||||
|
||||
--- |
||||
|
||||
## Следующие шаги |
||||
|
||||
- [x] Спринт 1: Инфраструктура + Создание тестов |
||||
- [x] Спринт 2: Прохождение теста + результат |
||||
- [x] Спринт 3: Редактирование + версионность |
||||
- [x] Спринт 4: AI-помощник (DeepSeek) |
||||
- [ ] Спринт 5: Трекер результатов |
||||
- [ ] Спринт 6: Авторизация и роли |
||||
- [ ] Спринт 7: Уведомления в MAX |
||||
@ -0,0 +1,33 @@
|
||||
"""004_settings |
||||
|
||||
Revision ID: 004 |
||||
Revises: 003 |
||||
Create Date: 2026-03-21 |
||||
""" |
||||
from typing import Sequence, Union |
||||
|
||||
import sqlalchemy as sa |
||||
from alembic import op |
||||
|
||||
revision: str = "004" |
||||
down_revision: Union[str, None] = "003" |
||||
branch_labels: Union[str, Sequence[str], None] = None |
||||
depends_on: Union[str, Sequence[str], None] = None |
||||
|
||||
|
||||
def upgrade() -> None: |
||||
op.create_table( |
||||
"settings", |
||||
sa.Column("key", sa.String(100), primary_key=True), |
||||
sa.Column("value", sa.Text(), nullable=True), |
||||
sa.Column( |
||||
"updated_at", |
||||
sa.DateTime(timezone=True), |
||||
server_default=sa.func.now(), |
||||
nullable=False, |
||||
), |
||||
) |
||||
|
||||
|
||||
def downgrade() -> None: |
||||
op.drop_table("settings") |
||||
@ -0,0 +1,129 @@
|
||||
from fastapi import APIRouter, Depends, HTTPException |
||||
from pydantic import BaseModel |
||||
from sqlalchemy.ext.asyncio import AsyncSession |
||||
|
||||
from app.database import get_db |
||||
from app.services import llm as llm_service |
||||
|
||||
router = APIRouter(tags=["llm"]) |
||||
|
||||
|
||||
class CheckResponse(BaseModel): |
||||
ok: bool |
||||
message: str |
||||
|
||||
|
||||
class GenerateRequest(BaseModel): |
||||
topic: str |
||||
count: int = 7 |
||||
|
||||
|
||||
class GenerateResponse(BaseModel): |
||||
questions: list[dict] |
||||
|
||||
|
||||
class ImproveRequest(BaseModel): |
||||
question: str |
||||
answers: list[str] |
||||
|
||||
|
||||
class ImproveResponse(BaseModel): |
||||
improved_question: str |
||||
improved_answers: list[str] |
||||
|
||||
|
||||
class DistractorsRequest(BaseModel): |
||||
question: str |
||||
answers: list[str] |
||||
|
||||
|
||||
class DistractorsResponse(BaseModel): |
||||
distractors: list[str] |
||||
|
||||
|
||||
class ReviewRequest(BaseModel): |
||||
title: str |
||||
questions: list[dict] |
||||
|
||||
|
||||
class ReviewResponse(BaseModel): |
||||
review: str |
||||
|
||||
|
||||
class ImproveAllRequest(BaseModel): |
||||
title: str |
||||
questions: list[dict] |
||||
|
||||
|
||||
class ImproveAllResponse(BaseModel): |
||||
questions: list[dict] |
||||
|
||||
|
||||
@router.post("/api/llm/check", response_model=CheckResponse) |
||||
async def check_connection(db: AsyncSession = Depends(get_db)): |
||||
try: |
||||
result = await llm_service.check_connection(db) |
||||
return {"ok": True, "message": f"Подключение успешно: {result}"} |
||||
except ValueError as e: |
||||
return {"ok": False, "message": str(e)} |
||||
except Exception as e: |
||||
return {"ok": False, "message": f"Ошибка подключения: {str(e)}"} |
||||
|
||||
|
||||
@router.post("/api/llm/generate", response_model=GenerateResponse) |
||||
async def generate_questions(req: GenerateRequest, db: AsyncSession = Depends(get_db)): |
||||
try: |
||||
questions = await llm_service.generate_questions(db, req.topic, req.count) |
||||
return {"questions": questions} |
||||
except ValueError as e: |
||||
raise HTTPException(status_code=400, detail=str(e)) |
||||
except Exception as e: |
||||
raise HTTPException(status_code=500, detail=f"Ошибка AI: {str(e)}") |
||||
|
||||
|
||||
@router.post("/api/llm/improve", response_model=ImproveResponse) |
||||
async def improve_question(req: ImproveRequest, db: AsyncSession = Depends(get_db)): |
||||
try: |
||||
data = await llm_service.improve_question(db, req.question, req.answers) |
||||
return {"improved_question": data["question"], "improved_answers": data["answers"]} |
||||
except ValueError as e: |
||||
raise HTTPException(status_code=400, detail=str(e)) |
||||
except Exception as e: |
||||
raise HTTPException(status_code=500, detail=f"Ошибка AI: {str(e)}") |
||||
|
||||
|
||||
@router.post("/api/llm/distractors", response_model=DistractorsResponse) |
||||
async def generate_distractors( |
||||
req: DistractorsRequest, db: AsyncSession = Depends(get_db) |
||||
): |
||||
try: |
||||
distractors = await llm_service.generate_distractors( |
||||
db, req.question, req.answers |
||||
) |
||||
return {"distractors": distractors} |
||||
except ValueError as e: |
||||
raise HTTPException(status_code=400, detail=str(e)) |
||||
except Exception as e: |
||||
raise HTTPException(status_code=500, detail=f"Ошибка AI: {str(e)}") |
||||
|
||||
|
||||
@router.post("/api/llm/review", response_model=ReviewResponse) |
||||
async def review_test(req: ReviewRequest, db: AsyncSession = Depends(get_db)): |
||||
try: |
||||
review = await llm_service.review_test(db, req.title, req.questions) |
||||
return {"review": review} |
||||
except ValueError as e: |
||||
raise HTTPException(status_code=400, detail=str(e)) |
||||
except Exception as e: |
||||
raise HTTPException(status_code=500, detail=f"Ошибка AI: {str(e)}") |
||||
|
||||
|
||||
@router.post("/api/llm/improve_all", response_model=ImproveAllResponse) |
||||
async def improve_all(req: ImproveAllRequest, db: AsyncSession = Depends(get_db)): |
||||
try: |
||||
questions = await llm_service.improve_all(db, req.title, req.questions) |
||||
return {"questions": questions} |
||||
except ValueError as e: |
||||
raise HTTPException(status_code=400, detail=str(e)) |
||||
except Exception as e: |
||||
raise HTTPException(status_code=500, detail=f"Ошибка AI: {str(e)}") |
||||
@ -0,0 +1,34 @@
|
||||
from fastapi import APIRouter, Depends |
||||
from sqlalchemy import select |
||||
from sqlalchemy.ext.asyncio import AsyncSession |
||||
|
||||
from app.database import get_db |
||||
from app.models.setting import Setting |
||||
from app.schemas.setting import SettingOut, SettingUpdate |
||||
|
||||
router = APIRouter(tags=["settings"]) |
||||
|
||||
|
||||
@router.get("/api/settings/{key}", response_model=SettingOut) |
||||
async def get_setting(key: str, db: AsyncSession = Depends(get_db)): |
||||
result = await db.execute(select(Setting).where(Setting.key == key)) |
||||
setting = result.scalar_one_or_none() |
||||
if setting is None: |
||||
return SettingOut(key=key, value=None) |
||||
return setting |
||||
|
||||
|
||||
@router.put("/api/settings/{key}", response_model=SettingOut) |
||||
async def update_setting( |
||||
key: str, data: SettingUpdate, db: AsyncSession = Depends(get_db) |
||||
): |
||||
result = await db.execute(select(Setting).where(Setting.key == key)) |
||||
setting = result.scalar_one_or_none() |
||||
if setting is None: |
||||
setting = Setting(key=key, value=data.value) |
||||
db.add(setting) |
||||
else: |
||||
setting.value = data.value |
||||
await db.commit() |
||||
await db.refresh(setting) |
||||
return setting |
||||
@ -0,0 +1,17 @@
|
||||
from datetime import datetime |
||||
|
||||
from sqlalchemy import DateTime, String, Text |
||||
from sqlalchemy.orm import Mapped, mapped_column |
||||
from sqlalchemy.sql import func |
||||
|
||||
from app.database import Base |
||||
|
||||
|
||||
class Setting(Base): |
||||
__tablename__ = "settings" |
||||
|
||||
key: Mapped[str] = mapped_column(String(100), primary_key=True) |
||||
value: Mapped[str | None] = mapped_column(Text, nullable=True) |
||||
updated_at: Mapped[datetime] = mapped_column( |
||||
DateTime(timezone=True), server_default=func.now(), onupdate=func.now() |
||||
) |
||||
@ -0,0 +1,14 @@
|
||||
from typing import Optional |
||||
|
||||
from pydantic import BaseModel |
||||
|
||||
|
||||
class SettingOut(BaseModel): |
||||
key: str |
||||
value: Optional[str] |
||||
|
||||
model_config = {"from_attributes": True} |
||||
|
||||
|
||||
class SettingUpdate(BaseModel): |
||||
value: Optional[str] = None |
||||
@ -0,0 +1,203 @@
|
||||
import json |
||||
|
||||
from openai import AsyncOpenAI |
||||
from sqlalchemy import select |
||||
from sqlalchemy.ext.asyncio import AsyncSession |
||||
|
||||
from app.models.setting import Setting |
||||
|
||||
DEEPSEEK_BASE_URL = "https://api.deepseek.com" |
||||
DEEPSEEK_MODEL = "deepseek-chat" |
||||
|
||||
|
||||
async def _get_api_key(db: AsyncSession) -> str: |
||||
result = await db.execute(select(Setting).where(Setting.key == "deepseek_api_key")) |
||||
setting = result.scalar_one_or_none() |
||||
if not setting or not setting.value: |
||||
raise ValueError("API ключ DeepSeek не настроен. Перейдите в Настройки.") |
||||
return setting.value |
||||
|
||||
|
||||
def _client(api_key: str) -> AsyncOpenAI: |
||||
return AsyncOpenAI(api_key=api_key, base_url=DEEPSEEK_BASE_URL) |
||||
|
||||
|
||||
async def check_connection(db: AsyncSession) -> str: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": "Ответь одним словом: работает"}], |
||||
max_tokens=10, |
||||
) |
||||
return response.choices[0].message.content.strip() |
||||
|
||||
|
||||
async def generate_questions(db: AsyncSession, topic: str, count: int = 7) -> list[dict]: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
|
||||
prompt = f"""Сгенерируй {count} вопросов для теста по теме: "{topic}". |
||||
|
||||
Верни ТОЛЬКО JSON без пояснений в следующем формате: |
||||
{{ |
||||
"questions": [ |
||||
{{ |
||||
"text": "Текст вопроса", |
||||
"answers": [ |
||||
{{"text": "Вариант 1", "is_correct": true}}, |
||||
{{"text": "Вариант 2", "is_correct": false}}, |
||||
{{"text": "Вариант 3", "is_correct": false}} |
||||
] |
||||
}} |
||||
] |
||||
}} |
||||
|
||||
Требования: |
||||
- Минимум 3 варианта ответа на каждый вопрос |
||||
- Ровно один правильный ответ на каждый вопрос |
||||
- Вопросы должны проверять практические знания по теме |
||||
- Варианты ответов должны быть правдоподобными""" |
||||
|
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": prompt}], |
||||
response_format={"type": "json_object"}, |
||||
max_tokens=3000, |
||||
) |
||||
data = json.loads(response.choices[0].message.content) |
||||
return data["questions"] |
||||
|
||||
|
||||
async def improve_question( |
||||
db: AsyncSession, question: str, answers: list[str] |
||||
) -> dict: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
|
||||
answers_str = "\n".join(f"{i + 1}. {a}" for i, a in enumerate(answers)) |
||||
prompt = f"""Улучши формулировки вопроса и вариантов ответов для теста. Сделай их более чёткими, однозначными и профессиональными. |
||||
|
||||
Вопрос: {question} |
||||
|
||||
Варианты ответов (верни в том же порядке и том же количестве): |
||||
{answers_str} |
||||
|
||||
Верни ТОЛЬКО JSON без пояснений: |
||||
{{ |
||||
"question": "улучшенный текст вопроса", |
||||
"answers": ["улучшенный вариант 1", "улучшенный вариант 2", ...] |
||||
}}""" |
||||
|
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": prompt}], |
||||
response_format={"type": "json_object"}, |
||||
max_tokens=600, |
||||
) |
||||
return json.loads(response.choices[0].message.content) |
||||
|
||||
|
||||
async def generate_distractors( |
||||
db: AsyncSession, question: str, existing_answers: list[str] |
||||
) -> list[str]: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
|
||||
existing_str = "\n".join(f"- {a}" for a in existing_answers) |
||||
prompt = f"""Для вопроса теста сгенерируй 3 правдоподобных неправильных варианта ответа (дистракторы). |
||||
|
||||
Вопрос: {question} |
||||
|
||||
Уже существующие варианты ответов: |
||||
{existing_str} |
||||
|
||||
Верни ТОЛЬКО JSON без пояснений: |
||||
{{"distractors": ["Вариант 1", "Вариант 2", "Вариант 3"]}} |
||||
|
||||
Требования: |
||||
- Дистракторы должны быть правдоподобными, но неправильными |
||||
- Не повторяй уже существующие варианты |
||||
- Дистракторы должны быть сопоставимы по длине с существующими вариантами""" |
||||
|
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": prompt}], |
||||
response_format={"type": "json_object"}, |
||||
max_tokens=400, |
||||
) |
||||
data = json.loads(response.choices[0].message.content) |
||||
return data["distractors"] |
||||
|
||||
|
||||
async def review_test(db: AsyncSession, title: str, questions: list[dict]) -> str: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
|
||||
questions_str = "" |
||||
for i, q in enumerate(questions, 1): |
||||
questions_str += f"\nВопрос {i}: {q.get('text', '')}\n" |
||||
for a in q.get("answers", []): |
||||
marker = "✓" if a.get("is_correct") else "✗" |
||||
questions_str += f" {marker} {a.get('text', '')}\n" |
||||
|
||||
prompt = f"""Проанализируй тест и дай рекомендации по улучшению его качества. |
||||
|
||||
Название теста: {title} |
||||
|
||||
Вопросы: |
||||
{questions_str} |
||||
|
||||
Оцени по следующим критериям: |
||||
1. Качество и чёткость формулировок вопросов |
||||
2. Качество вариантов ответов (правдоподобность дистракторов) |
||||
3. Охват темы и разнообразие вопросов |
||||
4. Конкретные рекомендации по улучшению |
||||
|
||||
Отвечай на русском языке, структурированно.""" |
||||
|
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": prompt}], |
||||
max_tokens=1500, |
||||
) |
||||
return response.choices[0].message.content.strip() |
||||
|
||||
|
||||
async def improve_all( |
||||
db: AsyncSession, title: str, questions: list[dict] |
||||
) -> list[dict]: |
||||
api_key = await _get_api_key(db) |
||||
client = _client(api_key) |
||||
|
||||
questions_str = "" |
||||
for i, q in enumerate(questions, 1): |
||||
questions_str += f"\nВопрос {i}: {q.get('text', '')}\n" |
||||
for j, a in enumerate(q.get("answers", []), 1): |
||||
questions_str += f" {j}. {a.get('text', '') if isinstance(a, dict) else a}\n" |
||||
|
||||
prompt = f"""Улучши формулировки всех вопросов и вариантов ответов в тесте. Сделай их более чёткими, однозначными и профессиональными. |
||||
|
||||
Название теста: {title} |
||||
|
||||
Вопросы: |
||||
{questions_str} |
||||
|
||||
Верни ТОЛЬКО JSON. Для каждого вопроса — улучшенную формулировку и все варианты ответов в том же порядке и том же количестве: |
||||
{{ |
||||
"questions": [ |
||||
{{ |
||||
"question": "улучшенный текст вопроса 1", |
||||
"answers": ["улучшенный вариант 1", "улучшенный вариант 2", "..."] |
||||
}} |
||||
] |
||||
}}""" |
||||
|
||||
response = await client.chat.completions.create( |
||||
model=DEEPSEEK_MODEL, |
||||
messages=[{"role": "user", "content": prompt}], |
||||
response_format={"type": "json_object"}, |
||||
max_tokens=4000, |
||||
) |
||||
data = json.loads(response.choices[0].message.content) |
||||
return data["questions"] |
||||
@ -0,0 +1,44 @@
|
||||
import axios from 'axios' |
||||
|
||||
export interface LLMQuestion { |
||||
text: string |
||||
answers: { text: string; is_correct: boolean }[] |
||||
} |
||||
|
||||
const llmApi = { |
||||
check: () => |
||||
axios.post<{ ok: boolean; message: string }>('/api/llm/check').then((r) => r.data), |
||||
|
||||
generate: (topic: string, count = 7) => |
||||
axios |
||||
.post<{ questions: LLMQuestion[] }>('/api/llm/generate', { topic, count }) |
||||
.then((r) => r.data), |
||||
|
||||
improve: (question: string, answers: string[]) => |
||||
axios |
||||
.post<{ improved_question: string; improved_answers: string[] }>('/api/llm/improve', { |
||||
question, |
||||
answers, |
||||
}) |
||||
.then((r) => r.data), |
||||
|
||||
distractors: (question: string, answers: string[]) => |
||||
axios |
||||
.post<{ distractors: string[] }>('/api/llm/distractors', { question, answers }) |
||||
.then((r) => r.data), |
||||
|
||||
review: (title: string, questions: object[]) => |
||||
axios |
||||
.post<{ review: string }>('/api/llm/review', { title, questions }) |
||||
.then((r) => r.data), |
||||
|
||||
improveAll: (title: string, questions: object[]) => |
||||
axios |
||||
.post<{ questions: { question: string; answers: string[] }[] }>('/api/llm/improve_all', { |
||||
title, |
||||
questions, |
||||
}) |
||||
.then((r) => r.data), |
||||
} |
||||
|
||||
export default llmApi |
||||
@ -0,0 +1,14 @@
|
||||
import axios from 'axios' |
||||
|
||||
export interface Setting { |
||||
key: string |
||||
value: string | null |
||||
} |
||||
|
||||
const settingsApi = { |
||||
get: (key: string) => axios.get<Setting>(`/api/settings/${key}`).then((r) => r.data), |
||||
update: (key: string, value: string | null) => |
||||
axios.put<Setting>(`/api/settings/${key}`, { value }).then((r) => r.data), |
||||
} |
||||
|
||||
export default settingsApi |
||||
@ -0,0 +1,124 @@
|
||||
import { CheckCircleOutlined, CloseCircleOutlined } from '@ant-design/icons' |
||||
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query' |
||||
import { Alert, Button, Card, Form, Input, Space, Spin, Typography } from 'antd' |
||||
import { useState } from 'react' |
||||
import { useNavigate } from 'react-router-dom' |
||||
|
||||
import llmApi from '../../api/llm' |
||||
import settingsApi from '../../api/settings' |
||||
|
||||
const { Title, Text } = Typography |
||||
|
||||
const API_KEY = 'deepseek_api_key' |
||||
|
||||
export default function Settings() { |
||||
const navigate = useNavigate() |
||||
const queryClient = useQueryClient() |
||||
const [checkResult, setCheckResult] = useState<{ ok: boolean; message: string } | null>(null) |
||||
|
||||
const { data: setting, isLoading } = useQuery({ |
||||
queryKey: ['settings', API_KEY], |
||||
queryFn: () => settingsApi.get(API_KEY), |
||||
}) |
||||
|
||||
const saveMutation = useMutation({ |
||||
mutationFn: (value: string) => settingsApi.update(API_KEY, value || null), |
||||
onSuccess: () => { |
||||
queryClient.invalidateQueries({ queryKey: ['settings', API_KEY] }) |
||||
setCheckResult(null) |
||||
}, |
||||
}) |
||||
|
||||
const checkMutation = useMutation({ |
||||
mutationFn: () => llmApi.check(), |
||||
onSuccess: (data) => setCheckResult(data), |
||||
}) |
||||
|
||||
const handleSave = (values: { api_key: string }) => { |
||||
saveMutation.mutate(values.api_key) |
||||
} |
||||
|
||||
if (isLoading) { |
||||
return ( |
||||
<div style={{ display: 'flex', justifyContent: 'center', padding: 80 }}> |
||||
<Spin size="large" /> |
||||
</div> |
||||
) |
||||
} |
||||
|
||||
return ( |
||||
<div style={{ maxWidth: 600, margin: '40px auto', padding: '0 24px' }}> |
||||
<Title level={2}>Настройки</Title> |
||||
|
||||
<Card title="AI-помощник (DeepSeek)"> |
||||
<Text type="secondary" style={{ display: 'block', marginBottom: 16 }}> |
||||
Введите API ключ DeepSeek для активации AI-функций при создании и редактировании |
||||
тестов. Ключ хранится только на сервере. |
||||
</Text> |
||||
|
||||
<Form layout="vertical" onFinish={handleSave} initialValues={{ api_key: setting?.value ?? '' }}> |
||||
<Form.Item |
||||
name="api_key" |
||||
label="API ключ DeepSeek" |
||||
> |
||||
<Input.Password |
||||
placeholder="sk-..." |
||||
visibilityToggle |
||||
style={{ fontFamily: 'monospace' }} |
||||
/> |
||||
</Form.Item> |
||||
|
||||
<Form.Item style={{ marginBottom: 0 }}> |
||||
<Space wrap> |
||||
<Button |
||||
type="primary" |
||||
htmlType="submit" |
||||
loading={saveMutation.isPending} |
||||
> |
||||
Сохранить |
||||
</Button> |
||||
<Button |
||||
onClick={() => checkMutation.mutate()} |
||||
loading={checkMutation.isPending} |
||||
disabled={!setting?.value} |
||||
> |
||||
Проверить подключение |
||||
</Button> |
||||
<Button onClick={() => navigate('/')}> |
||||
На главную |
||||
</Button> |
||||
</Space> |
||||
</Form.Item> |
||||
</Form> |
||||
|
||||
{saveMutation.isSuccess && ( |
||||
<Alert |
||||
type="success" |
||||
message="Ключ сохранён" |
||||
showIcon |
||||
style={{ marginTop: 16 }} |
||||
closable |
||||
/> |
||||
)} |
||||
|
||||
{checkResult && ( |
||||
<Alert |
||||
type={checkResult.ok ? 'success' : 'error'} |
||||
message={checkResult.message} |
||||
icon={ |
||||
checkResult.ok ? ( |
||||
<CheckCircleOutlined /> |
||||
) : ( |
||||
<CloseCircleOutlined /> |
||||
) |
||||
} |
||||
showIcon |
||||
style={{ marginTop: 16 }} |
||||
closable |
||||
onClose={() => setCheckResult(null)} |
||||
/> |
||||
)} |
||||
</Card> |
||||
</div> |
||||
) |
||||
} |
||||
Loading…
Reference in new issue