AI AGENT · BACKEND & INFRA
AI Org Simulation
PRD 분석·팀 추천·가상 회의·리포트 프로토타입
PROJECT OVERVIEW
6 imagesPRD 기반 팀 구성과 가상 회의를 소개하고, 바로 시작·사례 보기로 진입합니다.
데이터 조회·PDF·세션 API와 AI 실행 흐름을 연결하고, Cloud Run 배포와 메모리 문제 대응을 맡았습니다.
- 사용 맥락
- 프로젝트를 시작하기 전, PM이 PRD와 팀 후보를 바탕으로 역할 배분과 수행 리스크를 살펴보는 AI 서비스 프로토타입입니다.
- 팀과 내 범위
- 저는 데이터 스키마·DB 계층·조회 API, PDF·세션 API와 Agent 실행 연결·SSE, Cloud Run 배포를 맡았습니다. 프론트 주요 화면과 Agent 내부 분석·추천·역할극·보고서 로직은 팀원의 구현입니다.
CONTRIBUTION
내가 맡은 일
- 데이터: Pydantic 스키마·SQLAlchemy 모델·Alembic 마이그레이션, CSV 검증·시드와 조회 API 구현
- API·흐름: PDF 텍스트 추출·세션 생성·팀 선택·결과 조회와 팀의 Agent 연결
- AI 실행·배포: Vertex AI 인증·런타임·SSE, Docker·Artifact Registry·Cloud Run과 IAM·Secret 설정
- 문제 대응: 512MiB 메모리 초과를 로그로 확인하고 실행 환경을 조정한 뒤 전체 흐름 재실행
전체 흐름 보기
담당 범위를 중심으로 정리한 개념 흐름입니다.
데이터와 AI 실행을 연결한 방식
- FastAPI · PDF 업로드·텍스트 추출, 세션 생성·결과 조회와 SSE 진행 전달을 연결했습니다.
- Vertex AI · 팀의 Agent가 실제 모델 API를 호출할 인증·런타임을 구성했습니다. 모델 학습·파인튜닝은 수행하지 않았습니다.
- Cloud Run · Docker 이미지를 Artifact Registry에 올려 프론트·백엔드를 배포했습니다. IAM은 호출 권한, Secret은 실행 설정 공급, Logging은 실패·지연 관찰에 사용했습니다.
- 데이터 계층 · 직원·협업 활동의 Pydantic 스키마, SQLAlchemy 모델과 Alembic 마이그레이션을 구현했습니다. Repository를 두어 필터·페이지네이션과 직원별 활동 통합 조회를 API에서 분리했습니다.
- 시연 범위 · 최종 추천은 더미 CSV를 읽습니다. DB 조회 계층 개발과 별개로 Cloud Run smoke는 Cloud SQL 없이 실행했고, 세션은 인메모리입니다. 외부 GitHub·Slack·Jira·Calendar 데이터의 실시간 수집과 리포트 DB 저장은 구현 완료 범위가 아닙니다.
팀 발표 자료는 전체 서비스 설계를 설명합니다. 그중 프론트 주요 화면과 에이전트 내부 분석·추천·역할극·보고서 로직은 팀원 담당이고, 저는 데이터 계층·API·실행 연결과 배포를 맡았습니다.
문제를 확인하고 대응한 기록
문제·확인 · Cloud Logging에서 512MiB 제한 초과로 역할극 stream이 중단된 기록을 확인했습니다.
판단·조치 · 실행 환경의 자원과 시작 비용을 먼저 조정했습니다. 메모리를 1GiB로 올리고 시작 시 uv sync를 제거했으며 동시 실행 수를 줄였습니다.
검증·결과 · 설정 변경 후 PDF 입력→요구사항 분석→팀 선택→가상 회의→리포트 전체 흐름을 다시 완료했습니다. 시연을 이어갈 수 있는 실행 환경을 마련했으며, 오류 제거율·속도 개선율이나 장기 안정성을 검증한 결과로 확대하지 않습니다.
메모리 조정 · 시작 명령 수정 · 동시 실행 수 제한
OUTCOME
남긴 결과
PDF 입력부터 리포트까지 이어지는 팀 데모를 Cloud Run에 배포했습니다. 메모리 설정·시작 명령·동시 실행 수를 조정한 뒤 전체 흐름을 다시 완료했습니다.
확인한 방법
Cloud Logging으로 메모리 초과를 확인하고 실행 설정을 바꾼 뒤 PDF 입력→분석→팀 선택→가상 회의→리포트 전체 흐름을 다시 완료했습니다. 공개 코드·본인 커밋·배포 문서와 시연 화면을 함께 제공합니다.
남은 한계
더미 데이터로 검증한 시연용 프로토타입입니다. 외부 협업 도구의 실시간 수집은 미구현이며, 최종 추천 경로는 CSV를 사용합니다. 세션 영속화·비동기 작업·타임아웃·재시도는 후속 과제입니다. 장기 운영·모델 학습 경험으로 확대하지 않습니다.
PRESENTATION
AI Org Simulation 발표 자료
Figma · 16 slides · 팀 최종 제출 자료서비스 흐름과 에이전트·GCP 구조를 정리한 발표 자료입니다.
팀의 설계·기대 효과를 포함한 자료입니다. 실제 구현 범위와 제 기여는 본문에 구분했습니다.