feat(sprint4): фундамент графа — intents + роутер + переключение веток
Первый шаг графовой архитектуры из GRAPH_ARCHITECTURE.md. Заменили
«один активный промпт на всё» на «свой промпт на каждую ветку +
роутер выбирает ветку на каждой реплике».
Данные:
- Новая таблица intents (code, name, description, is_enabled,
order_index). Коды с префиксом `_` — системные (не responder).
- В agent_configs добавлен intent_id (nullable, FK SET NULL); убрана
глобальная уникальность version, вместо неё UniqueConstraint
(intent_id, version) — у каждой ветки свой счётчик версий.
- В messages добавлен intent_id (nullable, FK) — фиксируем, какую
ветку выбрал роутер для каждой реплики.
- Миграция cd0a88ef9080 в batch-режиме (SQLite не умеет ALTER для
constraints напрямую).
Сид:
- Стартовые 7 веток: new_booking, reschedule, price_question,
medical_question, general_info, escalate_human + `_router` как
системная ветка для промпта классификатора.
- Для каждой ветки — свой v1-промпт из prompts/intents/{code}.md.
- migrate_legacy_config_to_general_info: старый v1 из Спринта 3
(без intent_id) переносится на general_info с сохранением версии.
- ensure_seed_intents досиживает недостающие коды, существующие не
трогает — безопасно при добавлении новых веток.
Оркестрация и роутер:
- services/router_client.RouterClient — отдельный класс от LLMClient
(под будущую смену модели на более дешёвую). Метод classify(session,
history, text) возвращает {code, version}. Промпт классификатора
подтягивается из активного конфига ветки `_router`, fallback —
prompts/intents/_router.md. При сомнении/ошибке возвращает
general_info.
- services/chat_service.send_message теперь идёт через router.classify
→ берёт активный конфиг выбранной ветки → llm.chat. В сообщения
пишется intent_id, в треде фиксируется начальный agent_config_id.
В ответе — intent_code, intent_name, config_version, router_version.
API:
- GET /intents, GET /intents/{code}, PATCH /intents/{code} —
список веток со счётчиком версий, получение и переключение
is_enabled.
- /configs теперь требует intent_code как Query-параметр
(GET /configs, GET /configs/active) — выборка версий в рамках
ветки. POST /configs принимает intent_id.
- get_thread_detail JOIN-ит Intent — каждая реплика возвращает
intent_code + intent_name.
UI:
- settings.html переработан в 3-колоночный макет: слева список веток
с подгруппой «Системные» для `_router` (пометка «система» вместо
свитча), в центре редактор промпта/правил активной версии выбранной
ветки, справа список версий с активировать/удалить/загрузить.
Каждая ветка редактируется независимо — своя история версий,
своя активная.
- sandbox.html: у каждой реплики бейдж с intent_code, в отладке новый
блок «Решение роутера» (подсвеченный зелёным) с названием ветки,
версией её активного конфига и версией промпта роутера. Старый
«активная: v1» индикатор убран — он больше не имеет смысла (активная
у каждой ветки своя).
E2E проверено: разные реплики уходят в корректные ветки, каждая
отвечает по своему узкому промпту, промпт роутера редактируется в UI
как v2/v3 и откатывается — классификация сразу использует новую
версию.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
+51
-14
@@ -1,6 +1,6 @@
|
||||
import logging
|
||||
|
||||
from fastapi import APIRouter, Depends, HTTPException
|
||||
from fastapi import APIRouter, Depends, HTTPException, Query
|
||||
from sqlalchemy.ext.asyncio import AsyncSession
|
||||
|
||||
from db.models import AgentConfig
|
||||
@@ -11,16 +11,19 @@ from models.responses import (
|
||||
AgentConfigInfo,
|
||||
AgentConfigListResponse,
|
||||
)
|
||||
from services import config_service
|
||||
from services import config_service, intent_service
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
router = APIRouter(prefix="/configs", tags=["configs"])
|
||||
|
||||
|
||||
def _to_info(cfg: AgentConfig) -> AgentConfigInfo:
|
||||
def _to_info(cfg: AgentConfig, intent_code: str = "", intent_name: str = "") -> AgentConfigInfo:
|
||||
return AgentConfigInfo(
|
||||
id=cfg.id,
|
||||
intent_id=cfg.intent_id,
|
||||
intent_code=intent_code,
|
||||
intent_name=intent_name,
|
||||
version=cfg.version,
|
||||
name=cfg.name,
|
||||
system_prompt=cfg.system_prompt,
|
||||
@@ -30,18 +33,44 @@ def _to_info(cfg: AgentConfig) -> AgentConfigInfo:
|
||||
)
|
||||
|
||||
|
||||
async def _resolve_intent_meta(session: AsyncSession, intent_id: int | None) -> tuple[str, str]:
|
||||
if intent_id is None:
|
||||
return "", ""
|
||||
from db.models import Intent
|
||||
intent = await session.get(Intent, intent_id)
|
||||
if intent is None:
|
||||
return "", ""
|
||||
return intent.code, intent.name
|
||||
|
||||
|
||||
@router.get("", response_model=AgentConfigListResponse)
|
||||
async def list_configs(session: AsyncSession = Depends(get_session)):
|
||||
configs = await config_service.list_configs(session)
|
||||
return AgentConfigListResponse(configs=[_to_info(c) for c in configs], total=len(configs))
|
||||
async def list_configs(
|
||||
intent_code: str = Query(..., description="Код ветки (обязателен): фильтр версий по ветке"),
|
||||
session: AsyncSession = Depends(get_session),
|
||||
):
|
||||
intent = await intent_service.get_intent_by_code(session, intent_code)
|
||||
if intent is None:
|
||||
raise HTTPException(status_code=404, detail=f"Intent {intent_code!r} not found")
|
||||
|
||||
configs = await config_service.list_configs_for_intent(session, intent.id)
|
||||
return AgentConfigListResponse(
|
||||
configs=[_to_info(c, intent.code, intent.name) for c in configs],
|
||||
total=len(configs),
|
||||
)
|
||||
|
||||
|
||||
@router.get("/active", response_model=AgentConfigInfo)
|
||||
async def get_active(session: AsyncSession = Depends(get_session)):
|
||||
cfg = await config_service.get_active_config(session)
|
||||
async def get_active(
|
||||
intent_code: str = Query(..., description="Код ветки"),
|
||||
session: AsyncSession = Depends(get_session),
|
||||
):
|
||||
intent = await intent_service.get_intent_by_code(session, intent_code)
|
||||
if intent is None:
|
||||
raise HTTPException(status_code=404, detail=f"Intent {intent_code!r} not found")
|
||||
cfg = await config_service.get_active_config_for_intent(session, intent.id)
|
||||
if cfg is None:
|
||||
raise HTTPException(status_code=404, detail="No active config")
|
||||
return _to_info(cfg)
|
||||
raise HTTPException(status_code=404, detail=f"No active config for intent {intent_code!r}")
|
||||
return _to_info(cfg, intent.code, intent.name)
|
||||
|
||||
|
||||
@router.get("/{config_id}", response_model=AgentConfigInfo)
|
||||
@@ -49,7 +78,8 @@ async def get_config(config_id: int, session: AsyncSession = Depends(get_session
|
||||
cfg = await config_service.get_config(session, config_id)
|
||||
if cfg is None:
|
||||
raise HTTPException(status_code=404, detail="Config not found")
|
||||
return _to_info(cfg)
|
||||
code, name = await _resolve_intent_meta(session, cfg.intent_id)
|
||||
return _to_info(cfg, code, name)
|
||||
|
||||
|
||||
@router.post("", response_model=AgentConfigInfo)
|
||||
@@ -57,22 +87,29 @@ async def create_config(
|
||||
req: AgentConfigCreateRequest,
|
||||
session: AsyncSession = Depends(get_session),
|
||||
):
|
||||
from db.models import Intent
|
||||
intent = await session.get(Intent, req.intent_id)
|
||||
if intent is None:
|
||||
raise HTTPException(status_code=404, detail=f"Intent {req.intent_id} not found")
|
||||
|
||||
cfg = await config_service.create_config(
|
||||
session=session,
|
||||
intent_id=req.intent_id,
|
||||
system_prompt=req.system_prompt,
|
||||
rules_text=req.rules_text,
|
||||
name=req.name,
|
||||
activate=req.activate,
|
||||
)
|
||||
return _to_info(cfg)
|
||||
return _to_info(cfg, intent.code, intent.name)
|
||||
|
||||
|
||||
@router.post("/{config_id}/activate", response_model=AgentConfigInfo)
|
||||
async def activate_config(config_id: int, session: AsyncSession = Depends(get_session)):
|
||||
cfg = await config_service.activate_config(session, config_id)
|
||||
if cfg is None:
|
||||
raise HTTPException(status_code=404, detail="Config not found")
|
||||
return _to_info(cfg)
|
||||
raise HTTPException(status_code=404, detail="Config not found or has no intent")
|
||||
code, name = await _resolve_intent_meta(session, cfg.intent_id)
|
||||
return _to_info(cfg, code, name)
|
||||
|
||||
|
||||
@router.delete("/{config_id}", response_model=AgentConfigDeleteResponse)
|
||||
|
||||
Reference in New Issue
Block a user