feat(sprint6a): блоки A2, B, C — exit_conditions, handoff_count, suspended/resume

Блок A2: вынос условий выхода из основного промпта в отдельное поле
agent_configs.exit_conditions_text. compose_full_system_prompt склеивает
system_prompt + rules_text + exit_conditions_text перед отправкой в модель.
Одноразовая миграция данных при старте: пытаемся выделить блок «Условия
выхода» из хвоста существующих system_prompt-ов и перенести в новое поле
(поддерживаются три формы заголовка: «## Условия выхода», «**Условия
выхода**», просто «Условия выхода:»). В UI «Настройки» — третья textarea
с подсказкой ⓘ на отдельной кнопке.

Блок B: защита от петель маршрутизации (v2 §4.3). В thread_state добавлена
колонка handoff_count, инкрементируется на каждом hard-handoff: либо когда
роутер переключает не-sm-ветку (state reset), либо когда sm-ветка сама
выдаёт [INTENT_CHANGE: …] (bouncing). При превышении HANDOFF_CAP=3 диалог
автоматически уводится в escalate_human с шаблонным ответом «Уточню детали
с администратором клиники, свяжемся с вами в течение ближайшего часа», LLM
не вызывается, handoff_count сбрасывается. В Песочнице видны счётчик
«переключений ветки в диалоге» и красная плашка при срабатывании защиты.
Также пофикшен баг: для не-sm-веток snapshot.current_intent_code теперь
финализируется на served_code, иначе на следующей реплике prev_intent_code
терялся и handoff_count не считался.

Блок C: suspended_intent / resumable_step_code / resumable_slots_json в
thread_state (v2 §4.4). При hard-handoff из sm-ветки через [INTENT_CHANGE]
текущий сценарий запоминается (если suspended ещё не занят). Когда роутер
на следующих репликах возвращает intent = suspended_intent — RESUME:
восстанавливаем current_intent_code, current_step_code, slots; suspended_*
очищается, handoff_count=0. Возврат имеет приоритет над sticky-логикой.
В Песочнице — синяя плашка «📌 отложен сценарий X (шаг Y)» во время detour'а
и зелёная «↩️ возврат к отложенному сценарию» в момент resume. Routing-loop
guard и роутер-driven handoff не теряют suspended (только при authoritative
сценариях вроде эскалации он сбрасывается).

Прогон вручную: detour из new_booking/qualify в price_question и обратно
восстанавливает name=Алексей, reason=болит ухо на исходном шаге.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
AR 15 M4
2026-04-25 12:46:10 +05:00
parent 9eef2dab3a
commit 932b488bcb
16 changed files with 547 additions and 106 deletions
@@ -0,0 +1,30 @@
"""add exit_conditions_text to agent_configs (Спринт 6a, блок A2)
Revision ID: c7f3d18a45e2
Revises: b5e91c2d07f1
Create Date: 2026-04-25 11:30:00.000000
Условия выхода (`[INTENT_CHANGE: ...]`) выделены из основного промпта в отдельное
поле, чтобы оператор мог править их без риска зацепить каркас. Перенос данных
старых конфигов из system_prompt — в `services/config_service.migrate_exit_conditions_to_field`.
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
revision: str = 'c7f3d18a45e2'
down_revision: Union[str, None] = 'b5e91c2d07f1'
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
with op.batch_alter_table('agent_configs', recreate='always') as batch:
batch.add_column(sa.Column('exit_conditions_text', sa.Text(), nullable=True))
def downgrade() -> None:
with op.batch_alter_table('agent_configs', recreate='always') as batch:
batch.drop_column('exit_conditions_text')
@@ -0,0 +1,30 @@
"""add handoff_count to thread_state (Спринт 6a, блок B)
Revision ID: d9b612a04e75
Revises: c7f3d18a45e2
Create Date: 2026-04-25 12:00:00.000000
Счётчик жёстких handoff'ов в рамках одного диалога. По достижении cap (=3 в коде)
оркестратор автоматически уводит диалог в `escalate_human` с reason=routing_loop —
защита от петель маршрутизации (v2 §4.3).
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
revision: str = 'd9b612a04e75'
down_revision: Union[str, None] = 'c7f3d18a45e2'
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
with op.batch_alter_table('thread_state', recreate='always') as batch:
batch.add_column(sa.Column('handoff_count', sa.Integer(), nullable=False, server_default='0'))
def downgrade() -> None:
with op.batch_alter_table('thread_state', recreate='always') as batch:
batch.drop_column('handoff_count')
@@ -0,0 +1,35 @@
"""add suspended_intent / resumable_step_code / resumable_slots_json (Спринт 6a, блок C)
Revision ID: e1a4f7c83b29
Revises: d9b612a04e75
Create Date: 2026-04-25 12:30:00.000000
При hard-handoff из ветки со state machine (через `[INTENT_CHANGE: ...]`) текущий
сценарий запоминается в `suspended_intent` + `resumable_step_code` + `resumable_slots_json`.
Если на следующих репликах роутер возвращает intent = suspended_intent — восстанавливаем
state и очищаем эти поля. v2 §4.4.
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
revision: str = 'e1a4f7c83b29'
down_revision: Union[str, None] = 'd9b612a04e75'
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
with op.batch_alter_table('thread_state', recreate='always') as batch:
batch.add_column(sa.Column('suspended_intent', sa.String(length=50), nullable=True))
batch.add_column(sa.Column('resumable_step_code', sa.String(length=50), nullable=True))
batch.add_column(sa.Column('resumable_slots_json', sa.Text(), nullable=True))
def downgrade() -> None:
with op.batch_alter_table('thread_state', recreate='always') as batch:
batch.drop_column('resumable_slots_json')
batch.drop_column('resumable_step_code')
batch.drop_column('suspended_intent')