Q-Table 협상 전략 데모 API

""" FastAPI 메인 애플리케이션 """ import uvicorn from fastapi import FastAPI from fastapi.middleware.cors import CORSMiddleware from fastapi.responses import HTMLResponse from app.core.config import settings from app.api.endpoints import router # FastAPI 앱 생성 app = FastAPI( title="Q-Table 협상 전략 데모 API", description="기업 간 협상 시뮬레이션을 위한 강화학습 Q-Table 데모 API", version="1.0.0", docs_url="/docs", redoc_url="/redoc" ) # CORS 설정 app.add_middleware( CORSMiddleware, allow_origins=settings.allowed_origins, allow_credentials=True, allow_methods=["*"], allow_headers=["*"], ) # API 라우터 등록 app.include_router(router, prefix="/api/v1") @app.get("/", response_class=HTMLResponse) async def root(): """루트 페이지""" html_content = """ Q-Table 협상 전략 데모 API

📋 API 문서

Swagger UI - 대화형 API 문서
ReDoc - 깔끔한 API 문서

🚀 주요 기능

보상 계산: POST /api/v1/reward/calculate
에피소드 생성: POST /api/v1/episodes/generate
Q-Learning 업데이트: POST /api/v1/learning/q-learning
FQI+CQL 학습: POST /api/v1/learning/fqi-cql
행동 추천: POST /api/v1/action/recommend
시스템 상태: GET /api/v1/status

📊 데이터 조회

Q-Table: GET /api/v1/qtable
경험 데이터: GET /api/v1/experiences
FQI+CQL 결과: GET /api/v1/fqi-cql
정책 비교: GET /api/v1/compare/{state}

🔧 유틸리티

헬스 체크: GET /api/v1/health
시스템 초기화: POST /api/v1/reset
설정 조회: GET /api/v1/config

🎮 프론트엔드

Streamlit 기반 대화형 인터페이스: http://localhost:8501

📝 보상함수

R(s,a) = W × (A/P) + (1-W) × End

W: 가중치 = (S_n + PZ_n) / 2
A: 앵커링 목표가
P: 상대방 제안가
End: 협상 종료 여부