Reference Project
Enterprise Agent Reference
FastAPI, Deep Agents, MCP, PostgreSQL과 OpenSearch로 구성한 governed workflow를 하나의 요청부터 승인된 쓰기까지 추적합니다.
GitHub 원본First Edition
구현에서 꺼낸 10개의 기록
설계 의도만 설명하지 않고 실제 코드, 테스트, 현재 한계를 함께 연결합니다.
Architecture
엔터프라이즈 AI 에이전트를 하나의 시스템으로 설계하기
모델 호출 하나를 제품으로 포장하는 대신 프런트엔드, API, 에이전트, MCP 서비스와 데이터 저장소의 경계를 나눈 이유를 설명합니다.
Architecture
AI 에이전트의 서비스 경계를 어디에 그어야 할까
Streamlit, FastAPI, 에이전트 런타임과 MCP 서비스가 서로 무엇을 알아야 하는지 실제 프로젝트의 의존성 경계로 설명합니다.
Agent Engineering
범용 도구 대신 좁고 타입이 있는 MCP 도구를 선택한 이유
에이전트에게 SQL, HTTP, 파일 시스템을 열어주지 않고 업무 동작 여섯 개만 제공한 설계와 그 효과를 살펴봅니다.
Security
멀티테넌트 격리를 프롬프트가 아닌 코드에서 강제하기
tenant ID가 요청 헤더에서 데이터베이스 조건과 검색 필터까지 어떻게 전달되고, 교차 tenant 조회가 어디서 차단되는지 추적합니다.
Security
민감한 쓰기 작업에 Human-in-the-Loop를 적용하는 방법
후속 작업 생성 직전에 실행을 멈추고 정확한 인자를 승인받은 뒤 동일한 상태에서 재개하는 전체 흐름을 설명합니다.
Agent Engineering
중단된 AI 에이전트를 안전하게 재개하는 체크포인트 설계
대화 기록, 승인 상태, LangGraph 실행 상태를 구분하고 동일한 thread에서 실행을 재개하는 구조를 살펴봅니다.
Operations
승인된 작업을 한 번만 실행하고 감사 기록으로 남기기
승인 UUID, 데이터베이스 unique constraint와 감사 이벤트를 결합해 중복 쓰기를 막고 실행 결과를 추적하는 방법을 설명합니다.
Evaluation
인용 가능한 RAG에서 검색 결과를 신뢰하지 않는 방법
tenant 필터, 허용된 검색 조건, 메타데이터 기반 인용과 hostile document 테스트를 결합한 지식 검색 경계를 설명합니다.
Operations
Chain-of-Thought 없이 에이전트 진행 상황을 SSE로 전달하기
긴 실행 동안 사용자를 기다리게 하지 않으면서도 내부 reasoning은 노출하지 않는 이벤트 계약과 SSE 선택 이유를 설명합니다.
Evaluation
LLM 자격 증명 없이 엔터프라이즈 에이전트의 경계를 테스트하기
모델 답변의 문체보다 tenant 격리, 도구 제한, 승인, 멱등성, 인용과 장애 처리를 자동 테스트하는 전략을 정리합니다.
Browse by topic
주제별 탐색
아키텍처
AI 에이전트를 하나의 모델 호출이 아니라 경계가 분명한 시스템으로 설계하는 방법을 다룹니다.
Security보안과 거버넌스
테넌트 격리, 사람의 승인, 감사 가능성을 프롬프트 밖의 코드에서 강제하는 방법을 살펴봅니다.
Agent Engineering에이전트 엔지니어링
도구 계약, 실행 상태, 전문 에이전트 구성을 실제 구현을 통해 설명합니다.
Evaluation평가와 테스트
에이전트의 말투보다 시스템 경계와 실패 조건을 검증하는 테스트 전략을 정리합니다.
Operations운영과 신뢰성
실시간 진행 전달, 멱등성, 감사 로그처럼 운영 환경에서 필요한 제어 장치를 다룹니다.