9eef2dab3a
Заменили строковый тег [STATE: ...] из Спринта 5 на структурированный выход
ветки в виде JSON-блока в хвосте ответа: {state_after, slots_updated}, парсимый
балансировкой скобок. Шаги state machine вынесены из монолитного промпта в
таблицу intent_steps (intent_id FK, code, name, order_index, system_prompt,
allowed_next JSON, guards JSON) и редактируются через UI. Валидатор переходов
сверяет state_after с allowed_next и блокирует невалидные прыжки.
Базовый промпт new_booking разбит на base + 6 файлов шагов (intro/qualify/
present/offer_time/book/close), которые сидятся при старте через
ensure_seed_steps. В chat_service промпт собирается как base + step + блок
[ТЕКУЩЕЕ СОСТОЯНИЕ].
Попутно реализован мини-блок G (sticky state machine): когда диалог идёт по
sm-ветке и роутер на новой реплике предлагает другую — state НЕ сбрасывается,
в системный промпт ветки подаётся блок [ПОДСКАЗКА РОУТЕРА], LLM сама решает
(STATE_JSON или INTENT_CHANGE). Это сняло ключевую дыру Спринта 5: «Меня
зовут Алексей» / «болит ухо» внутри записи больше не сбрасывают сценарий.
Промпт ветки new_booking ужесточён: бытовые жалобы — это повод записи (слот
reason + сочувствие), не повод уводить в medical_question. Шаг present теперь
использует reason в формулировке. Промпт _router расширен живыми примерами
для всех 6 веток, особенно для reschedule («не смогу подойти», «перенесите»).
Надёжность внешнего LLM:
- ретрай в LLMClient с паузой 500 мс + новое исключение LLMUnavailableError;
- ретрай в RouterClient (DeepSeek периодически моргает);
- /chat при ошибке делает session.rollback() и возвращает 503 с понятным
сообщением — больше не остаётся «диалогов-призраков» с одной репликой;
- UI убирает свой пузырь и возвращает текст в поле ввода для повторной отправки.
UI «Настройки» — добавлена вкладка «Шаги» для веток с state machine: список
шагов chip-ами, редактор промпта/имени/allowed_next/guards, сохранение через
PATCH /intents/{code}/steps/{step_code} без версионирования. Иконка ⓘ возле
поля «Правила» открывает popover с пояснением, что туда писать.
UI «Песочница»:
- блок «Состояние диалога» показывает имя шага из intent_steps (а не сырое
число), для не-sm-веток пишется «без пошагового сценария»;
- подсветка illegal-переходов (валидатор отклонил state_after) и parse_error
для sm-веток;
- блок «Решение роутера» развёрнут в три исхода: «попал в ту же ветку» /
«удержались в ветке» / «ветка сама передала управление через INTENT_CHANGE»;
- секция «Найденные фрагменты» сворачивается, карточки чанков раскрываются
по клику — правый сайдбар стал компактнее.
Терминология (по договорённости — простой русский в UI):
- «тред» → «диалог» в текстах для оператора (в коде/API thread_id оставлен);
- «sticky state machine» → «удержались в ветке»;
- «state machine» → «пошаговый сценарий» в видимых местах.
SPRINTS.md: блок G в Спринте 6b сокращён — sticky-логика уже сделана здесь,
осталась только вторая линия (передача thread_state в системный промпт самого
роутера для ещё более точной первичной классификации).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
147 lines
5.9 KiB
Python
147 lines
5.9 KiB
Python
"""LLM-роутер: по последней реплике + короткой истории определяет ветку.
|
|
|
|
Отдельный класс от LLMClient сознательно — роутер зовётся часто (каждую реплику),
|
|
имеет смысл в будущем перевести на более дешёвую модель (gpt-4o-mini, локальная Qwen).
|
|
Сейчас оба используют DeepSeek.
|
|
|
|
Системный промпт роутера лежит в БД как активный конфиг ветки `_router`
|
|
(версионируется, редактируется из UI «Настройки»). Если БД недоступна или
|
|
ветки нет — используем fallback из prompts/intents/_router.md.
|
|
"""
|
|
import asyncio
|
|
import logging
|
|
import re
|
|
from pathlib import Path
|
|
|
|
import httpx
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from config import settings
|
|
from services import config_service, intent_service
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
_FALLBACK_PROMPT_PATH = Path(__file__).resolve().parent.parent / "prompts" / "intents" / "_router.md"
|
|
|
|
|
|
def _load_fallback_prompt() -> str:
|
|
try:
|
|
return _FALLBACK_PROMPT_PATH.read_text(encoding="utf-8").strip()
|
|
except FileNotFoundError:
|
|
logger.warning("Router fallback prompt not found at %s", _FALLBACK_PROMPT_PATH)
|
|
return ""
|
|
|
|
|
|
FALLBACK_SYSTEM_PROMPT = _load_fallback_prompt()
|
|
|
|
VALID_CODES = {
|
|
"new_booking",
|
|
"reschedule",
|
|
"price_question",
|
|
"medical_question",
|
|
"general_info",
|
|
"escalate_human",
|
|
}
|
|
|
|
CODE_RE = re.compile(r"\b(new_booking|reschedule|price_question|medical_question|general_info|escalate_human)\b")
|
|
|
|
|
|
class RouterClient:
|
|
def __init__(
|
|
self,
|
|
api_key: str | None = None,
|
|
model: str | None = None,
|
|
base_url: str | None = None,
|
|
):
|
|
self.api_key = api_key or settings.deepseek_api_key
|
|
self.model = model or settings.deepseek_model
|
|
self.base_url = (base_url or settings.deepseek_base_url).rstrip("/")
|
|
|
|
def _format_history(self, history: list[dict], last_n: int = 4) -> str:
|
|
"""Короткая история последних реплик — для контекста классификации."""
|
|
if not history:
|
|
return "(предыдущих реплик нет)"
|
|
tail = history[-last_n:]
|
|
lines = []
|
|
for m in tail:
|
|
role_ru = "Пациент" if m["role"] == "user" else "Ассистент"
|
|
content = m["content"].replace("\n", " ")[:300]
|
|
lines.append(f"{role_ru}: {content}")
|
|
return "\n".join(lines)
|
|
|
|
async def _get_system_prompt(self, session: AsyncSession) -> tuple[str, int | None]:
|
|
"""Активный промпт роутера из БД (ветка _router). Возвращает (prompt, version_or_None)."""
|
|
pair = await config_service.get_active_config_by_intent_code(
|
|
session, intent_service.ROUTER_INTENT_CODE
|
|
)
|
|
if pair is None:
|
|
return FALLBACK_SYSTEM_PROMPT, None
|
|
_, cfg = pair
|
|
return config_service.compose_full_system_prompt(cfg), cfg.version
|
|
|
|
async def classify(self, session: AsyncSession, history: list[dict], text: str) -> dict:
|
|
"""Классифицировать реплику. Возвращает {code, version} — версия роутера для отладки.
|
|
|
|
При сомнении или парсинг-ошибке — general_info (безопасный fallback).
|
|
"""
|
|
system_prompt, version = await self._get_system_prompt(session)
|
|
|
|
user_message = (
|
|
f"История последних реплик:\n{self._format_history(history)}\n\n"
|
|
f"Новая реплика пациента:\n{text}\n\n"
|
|
f"Код ветки:"
|
|
)
|
|
|
|
url = f"{self.base_url}/chat/completions"
|
|
payload = {
|
|
"model": self.model,
|
|
"messages": [
|
|
{"role": "system", "content": system_prompt},
|
|
{"role": "user", "content": user_message},
|
|
],
|
|
"temperature": 0.0,
|
|
"max_tokens": 20,
|
|
}
|
|
|
|
data: dict | None = None
|
|
last_error: Exception | None = None
|
|
# Один ретрай: DeepSeek иногда отвечает 5xx / пустым исключением.
|
|
for attempt in range(2):
|
|
try:
|
|
async with httpx.AsyncClient(timeout=30.0) as client:
|
|
response = await client.post(
|
|
url,
|
|
json=payload,
|
|
headers={
|
|
"Authorization": f"Bearer {self.api_key}",
|
|
"Content-Type": "application/json",
|
|
},
|
|
)
|
|
response.raise_for_status()
|
|
data = response.json()
|
|
break
|
|
except Exception as e:
|
|
last_error = e
|
|
logger.warning(
|
|
"Router LLM call failed (attempt %d, %s: %s)",
|
|
attempt + 1, type(e).__name__, e,
|
|
)
|
|
if attempt < 1:
|
|
await asyncio.sleep(0.5)
|
|
if data is None:
|
|
logger.warning(
|
|
"Router LLM failed after retries (%s), falling back to general_info",
|
|
last_error,
|
|
)
|
|
return {"code": "general_info", "version": version}
|
|
|
|
raw = (data["choices"][0]["message"]["content"] or "").strip()
|
|
match = CODE_RE.search(raw)
|
|
if match:
|
|
code = match.group(1)
|
|
logger.info("Router v%s: %r → %s", version, text[:80], code)
|
|
return {"code": code, "version": version}
|
|
|
|
logger.warning("Router returned unrecognized response %r, falling back to general_info", raw)
|
|
return {"code": "general_info", "version": version}
|