카드 카탈로그(negodata)가 Q-table action space 를 정의하는 정본이 되고, 카드 변경이
config 수정·학습 손실 없이 agent 에 자동 반영되는 고리를 완성.
- action space 정리: 카탈로그 전체(NGC-001~011, 11장) 고정, 견적별 선택은 축소가 아니라
available_mask(_selection_mask) 로 처리 — action_id↔카드 대응을 견적마다 일정하게 유지해
Q-table 학습 일관성 보장. 구 인덱스 방식(selected[action_id]) 폐기.
- ① 카탈로그 DB 정본화: action_mapping.type=db 면 registry 가 card.nego_cards(user_id NULL,
number 순) 조회로 action_to_card 동적 구성(파일은 폴백). port/adapter(card_catalog_*).
_base=type:db. → negodata 카드 추가/삭제 시 config 수정 불필요.
- ② 차원 변경 학습 보존 마이그레이션: migrate_active_version_dim — 겹치는 셀 복사
(append/truncate 안전) + 새 카드 fresh. model_store.load 가 차원 불일치 시 호출.
- ③ reload 엔드포인트: /v1/catalog-refresh(테넌트) · /v1/catalog-refresh-all(전역, 화이트리스트).
- ④ 브랜드: company_profile_repo — 자동 온보딩 고객사(company_id UUID)는
company.companies.name 으로 {company_name} 채움. 데모 테넌트는 파일 유지.
- 크로스서비스: negodata card_service 가 공용 nego 카드 변경 시 agent_notify 로 전역 리로드 알림
(best-effort, is_test skip). config 에 agent_base_url.
- 하니스 episodes 400→600(action 11 수렴). 테스트 갱신·추가로 agent 98/98.
알려진 갭(후속): per-company 카탈로그 스코프(회사 카드도 action space 포함), 카탈로그 중간
삭제 시 카드번호 기반 마이그레이션.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
71 lines
3.1 KiB
Python
71 lines
3.1 KiB
Python
"""AGENT_INTEGRATION.md 규약 검증 (backend ↔ agent).
|
||
|
||
4-1 session_id honoring: backend 가 보낸 session_id(=negotiation.sessions.session_id)를
|
||
새 uuid 발급 없이 그대로 세션 키로 사용.
|
||
4-4 tenant 키 = company_id(uuid): 미등록 company_id 는 _base 자동 온보딩(cold-start) 으로 수용.
|
||
"""
|
||
|
||
import os
|
||
|
||
import pytest
|
||
|
||
from router.v1.chat.protocol import Req_Chat
|
||
from services.chat_service import ChatService, reset_sessions
|
||
from negotiation.chat.service.chat_session_repository import ChatSessionRepository
|
||
from tenancy.config_loader import TenantConfigLoader
|
||
from tenancy.registry import TenantEngineRegistry
|
||
|
||
_TENANTS_DIR = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "tenants")
|
||
|
||
# backend 가 보내는 값 형식: session_id = negotiation.sessions.session_id(uuid), X-Tenant-ID = company_id(uuid)
|
||
BACKEND_SESSION_ID = "11111111-1111-1111-1111-111111111111"
|
||
COMPANY_ID = "00000000-0000-0000-0000-000000000099"
|
||
|
||
|
||
def _reg():
|
||
return TenantEngineRegistry(loader=TenantConfigLoader(tenants_dir=_TENANTS_DIR, cache_ttl_seconds=0))
|
||
|
||
|
||
@pytest.mark.asyncio
|
||
async def test_4_1_honors_backend_session_id(db_engine):
|
||
reset_sessions()
|
||
eng = await _reg().get_engine("ktcommerce")
|
||
svc = ChatService()
|
||
|
||
# 첫 턴: backend 의 session_id 를 그대로 키로 써야 함 (새 uuid 발급 X)
|
||
# 컨텍스트는 DB 조회(행 없음 → 기본값 폴백: target=10000, anchor=9900)
|
||
r = await svc.chat(eng, Req_Chat(session_id=BACKEND_SESSION_ID))
|
||
assert r.session_id == BACKEND_SESSION_ID
|
||
assert r.step == "서비스안내"
|
||
|
||
# 같은 session_id 로 이어가면 그 세션이 DB 에서 복원됨
|
||
r2 = await svc.chat(eng, Req_Chat(session_id=BACKEND_SESSION_ID, user_input="확인"))
|
||
assert r2.session_id == BACKEND_SESSION_ID and r2.step == "담당자확인"
|
||
|
||
# learning.chat_sessions 에 backend 의 session_id 그대로 저장됨
|
||
saved = await ChatSessionRepository(eng.company_id).get(BACKEND_SESSION_ID)
|
||
assert saved is not None and saved.session_id == BACKEND_SESSION_ID
|
||
|
||
|
||
@pytest.mark.asyncio
|
||
async def test_4_4_company_id_auto_onboard():
|
||
# 미등록 company_id → _base 자동 온보딩 (전용 tenant.yaml 없이도 엔진 생성)
|
||
eng = await _reg().get_engine(COMPANY_ID)
|
||
assert eng.tenant_id == COMPANY_ID
|
||
assert eng.company_id == COMPANY_ID # 학습/세션이 이 company_id 로 격리
|
||
assert eng.action_space_size == 11 # base 기본 카드(162×11 정합)
|
||
assert eng.state_space_size == 162
|
||
|
||
|
||
@pytest.mark.asyncio
|
||
async def test_4_4_company_id_chat_end_to_end(db_engine):
|
||
reset_sessions()
|
||
eng = await _reg().get_engine(COMPANY_ID) # 자동 온보딩 테넌트
|
||
svc = ChatService()
|
||
r = await svc.chat(eng, Req_Chat(session_id=BACKEND_SESSION_ID))
|
||
assert r.session_id == BACKEND_SESSION_ID and r.step == "서비스안내"
|
||
# 카드선택 턴까지 진행 → company_id 스코프로 학습 기록
|
||
for ui in ["확인", "예", "확인", "11000", "예"]:
|
||
r = await svc.chat(eng, Req_Chat(session_id=BACKEND_SESSION_ID, user_input=ui))
|
||
assert r.step == "가격협상" and r.card_id is not None
|