Series · Folio
프로젝트 구조에서 API·테스트·배포까지 이어지는 초·중급 10편
Python Production RAG Agent를 model·vector DB·웹 framework에 묶이지 않게 설계합니다. Vertical Slice와 Port·Adapter, typed contract, composition root, fake 기반 첫 테스트를 연결합니다.
Python RAG Agent의 LLM SDK를 application에서 격리합니다. typed message, streaming event state machine, usage, provider 오류 번역과 취소 가능한 client를 구현합니다.
LLM API 장애를 재시도로 증폭하지 않도록 전체 deadline, attempt timeout, Retry-After, full jitter, 동시성 제한과 circuit breaker를 Python으로 설계합니다.
Python RAG Agent의 검색 계층을 typed port로 격리합니다. ACL·tenant filter, source span, 전체 deadline 전파, HTTPX timeout과 빈 결과·장애 분리를 구현합니다.
검색 Evidence를 결정적 context bundle로 조립합니다. token budget, 중복 제거, 원문 span, untrusted data 격리와 server-side citation ID 검증을 Python으로 구현합니다.
Python RAG Agent를 typed state machine으로 구현합니다. Tool registry, schema·권한 검증, step·tool·deadline budget, 종료 이유와 deterministic reducer를 연결합니다.
Agent session을 PostgreSQL versioned event로 저장합니다. optimistic concurrency, idempotency key·request hash·lease, Redis cache와 crash window를 Python·SQL로 구현합니다.
FastAPI RAG Agent를 SSE API로 엽니다. event contract, bounded queue, backpressure, disconnect 취소, terminal error와 Last-Event-ID 재연결을 구현합니다.
RAG Agent를 외부 API 없이 검증합니다. deterministic fake, 공통 contract suite, HTTPX transport, 비밀정보를 제거한 record/replay와 fault injection을 설계합니다.
Python RAG Agent를 release합니다. 재현 가능한 container, CI·offline eval gate, OpenTelemetry, probe, canary, schema migration과 digest rollback을 연결합니다.
