52b46bc53e
Спринт 6c — терминология и сверка документации с реальным кодом:
- Словарь терминов в static/docs.html: «маршрутизатор» вместо «роутер»,
«защитное условие» вместо «guard», «пошаговая ветка» вместо «многошаговая».
Разделены концепты «намерение» (intent) и «ветка» (branch) с пометкой,
что в коде они хранятся как одна сущность 1:1.
- Песочница: «Решение маршрутизатора» виден всегда (зелёный/жёлтый),
счётчик переключений «N из 3» отдельной плашкой, бейджи под словарь.
- Настройки: «Условия перехода» → «Защитные условия (guards, JSON)».
- GRAPH_ARCHITECTURE_v4.md: имена полей thread_state и слоты приведены
к реальной БД (db/models/thread_state.py) и таксономии промптов шагов
(prompts/intents/new_booking/steps/). Ссылки на *_v2 примеры. На v3
поставлена шапка «устарело».
- 4 примера переписаны как *_v2: реальные current_intent_code/
current_step_code/slots_json, реальные allowed_next без двойных переходов,
реальная таксономия слотов name/reason/specialist/preferred_time/confirmed.
Удалены вымышленные CRM tool calls и слоты, которых нет в коде.
- static/example.html — параметризованная страница с навигацией между
4 примерами; роут GET /api/docs/examples/{name} в main.py отдаёт
markdown без дублирования файлов.
- Редактирование документов в Отладке: GET/PUT /documents/{id}/raw,
textarea с переразметкой и обновлением Chroma при сохранении.
Спринт 7, часть A — мульти-RAG через подписку ветка↔документы:
- Миграция: таблица intent_documents (M:N), модель IntentDocument,
индекс по document_id для обратного поиска.
- API: GET/PUT /intents/{code}/documents и GET/PUT /documents/{id}/intents
с PUT-семантикой «полный список», атомарно. Сервис
services/intent_document_service.py.
- Retrieval-фильтр в chat_service: подтягивает document_ids активной
ветки и передаёт в vectorstore.query(). Дефолт пустой подписки —
document_ids=[] (= 0 чанков), не «вся коллекция»: пустая подписка
означает «ветка не настроена», подмешивать случайное хуже, чем
ничего. vectorstore.query() различает None (нет фильтра) и [] (0).
- UI Настроек: блок «Документы базы знаний» в правом сайдбаре,
всегда видим независимо от вкладки, сортировка по имени, счётчик
«N из M», PUT при сохранении.
- UI Отладки: третья кнопка «привязка» рядом с «удалить» —
раскрывашка со списком веток (галочки), быстрая привязка прямо
на странице загрузки.
- Песочница: блок «Срез RAG» с подпиской/найдено, ворнинг при пустой
подписке. Поле rag_subscription в QueryResponse и ChatResponse.
- Системный промпт страницы Отладки переехал в обычную ветку _debug
(«Страница отладки»). Удалён prompts/system_prompt.md и логика
DEFAULT_SYSTEM_PROMPT в llm_client. routers/query.py подтягивает
активный конфиг ветки _debug и её подписки. Дефолт пустой подписки
для _debug — None (вся коллекция), не [] как для пациентских — чтобы
Отладка работала «из коробки». На странице Отладки info-bar показывает
активную версию и счётчик подписок, ссылка → Настройки.
- Тест-блок «Тест-вопрос» в центре Настроек: расширил /query
параметрами intent_code (default _debug), system_prompt (override
для теста черновика из textarea), disable_rag (для _router).
Редактор промпта обёрнут в <details open> — можно свернуть до
одной строки. Под ним — три колонки результата (RAG / промпт /
ответ). Для _router показывается подсказка про отсутствие RAG.
Документы:
- data/datasets/*.md — наработки по 6 веткам (рабочие материалы оператора).
- docs/BRANCH_MAP_AND_PROMPTS_v1.md, docs/OPTIMIZATION_CONVERSION_v1.md,
docs/guides/state_machine_and_slots.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
141 lines
5.1 KiB
Python
141 lines
5.1 KiB
Python
import logging
|
|
|
|
from fastapi import APIRouter, Depends, HTTPException
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from db.models import Intent, IntentStep
|
|
from db.session import get_session
|
|
from models.requests import (
|
|
IntentDocumentsUpdateRequest,
|
|
IntentStepUpdateRequest,
|
|
IntentToggleRequest,
|
|
)
|
|
from models.responses import (
|
|
IntentDocumentsResponse,
|
|
IntentInfo,
|
|
IntentListResponse,
|
|
IntentStepInfo,
|
|
IntentStepListResponse,
|
|
)
|
|
from services import config_service, intent_document_service, intent_service, intent_step_service
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
router = APIRouter(prefix="/intents", tags=["intents"])
|
|
|
|
|
|
async def _to_info(session: AsyncSession, intent: Intent) -> IntentInfo:
|
|
active_cfg = await config_service.get_active_config_for_intent(session, intent.id)
|
|
return IntentInfo(
|
|
id=intent.id,
|
|
code=intent.code,
|
|
name=intent.name,
|
|
description=intent.description or "",
|
|
is_enabled=intent.is_enabled,
|
|
order_index=intent.order_index,
|
|
active_config_id=active_cfg.id if active_cfg else None,
|
|
active_config_version=active_cfg.version if active_cfg else None,
|
|
)
|
|
|
|
|
|
@router.get("", response_model=IntentListResponse)
|
|
async def list_intents(session: AsyncSession = Depends(get_session)):
|
|
intents = await intent_service.list_intents(session)
|
|
infos = [await _to_info(session, i) for i in intents]
|
|
return IntentListResponse(intents=infos, total=len(infos))
|
|
|
|
|
|
@router.get("/{code}", response_model=IntentInfo)
|
|
async def get_intent(code: str, session: AsyncSession = Depends(get_session)):
|
|
intent = await intent_service.get_intent_by_code(session, code)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
return await _to_info(session, intent)
|
|
|
|
|
|
@router.patch("/{code}", response_model=IntentInfo)
|
|
async def toggle_intent(
|
|
code: str,
|
|
req: IntentToggleRequest,
|
|
session: AsyncSession = Depends(get_session),
|
|
):
|
|
intent = await intent_service.set_intent_enabled(session, code, req.is_enabled)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
return await _to_info(session, intent)
|
|
|
|
|
|
def _step_to_info(step: IntentStep, intent_code: str) -> IntentStepInfo:
|
|
return IntentStepInfo(
|
|
id=step.id,
|
|
intent_id=step.intent_id,
|
|
intent_code=intent_code,
|
|
code=step.code,
|
|
name=step.name,
|
|
order_index=step.order_index,
|
|
system_prompt=step.system_prompt or "",
|
|
allowed_next=intent_step_service.parse_allowed_next(step),
|
|
guards=intent_step_service.parse_guards(step),
|
|
updated_at=step.updated_at.isoformat(),
|
|
)
|
|
|
|
|
|
@router.get("/{code}/steps", response_model=IntentStepListResponse)
|
|
async def list_intent_steps(code: str, session: AsyncSession = Depends(get_session)):
|
|
intent = await intent_service.get_intent_by_code(session, code)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
steps = await intent_step_service.list_steps_for_intent(session, intent.id)
|
|
return IntentStepListResponse(
|
|
intent_code=intent.code,
|
|
steps=[_step_to_info(s, intent.code) for s in steps],
|
|
total=len(steps),
|
|
)
|
|
|
|
|
|
@router.patch("/{code}/steps/{step_code}", response_model=IntentStepInfo)
|
|
async def update_intent_step(
|
|
code: str,
|
|
step_code: str,
|
|
req: IntentStepUpdateRequest,
|
|
session: AsyncSession = Depends(get_session),
|
|
):
|
|
intent = await intent_service.get_intent_by_code(session, code)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
step = await intent_step_service.get_step_by_code(session, intent.id, step_code)
|
|
if step is None:
|
|
raise HTTPException(status_code=404, detail="Step not found")
|
|
updated = await intent_step_service.update_step(
|
|
session, step,
|
|
name=req.name,
|
|
system_prompt=req.system_prompt,
|
|
allowed_next=req.allowed_next,
|
|
guards=req.guards,
|
|
)
|
|
return _step_to_info(updated, intent.code)
|
|
|
|
|
|
@router.get("/{code}/documents", response_model=IntentDocumentsResponse)
|
|
async def list_intent_documents(code: str, session: AsyncSession = Depends(get_session)):
|
|
intent = await intent_service.get_intent_by_code(session, code)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
document_ids = await intent_document_service.list_documents_for_intent(session, intent.id)
|
|
return IntentDocumentsResponse(intent_code=intent.code, document_ids=document_ids)
|
|
|
|
|
|
@router.put("/{code}/documents", response_model=IntentDocumentsResponse)
|
|
async def set_intent_documents(
|
|
code: str,
|
|
req: IntentDocumentsUpdateRequest,
|
|
session: AsyncSession = Depends(get_session),
|
|
):
|
|
intent = await intent_service.get_intent_by_code(session, code)
|
|
if intent is None:
|
|
raise HTTPException(status_code=404, detail="Intent not found")
|
|
document_ids = await intent_document_service.set_documents_for_intent(
|
|
session, intent.id, req.document_ids,
|
|
)
|
|
return IntentDocumentsResponse(intent_code=intent.code, document_ids=document_ids)
|