플러스프로젝트 배경
1) 문제점 개발자 포트폴리오는 대부분 정적인 페이지 나열 방식으로 구성되어, 방문자가 원하는 정보를 직접 찾아야 하는 불편함이 있습니다. 프로젝트 목록, 기술 스택, 개발 철학 등 여러 항목이 분산되어 있어 방문자가 짧은 시간 안에 핵심을 파악하기 어렵습니다. 또한 단순 나열 방식으로는 개발자의 사고방식이나 문제 해결 접근법 같은 맥락적인 정보를 전달하기 어렵고, 방문자 입장에서 궁금한 것을 즉시 물
프로젝트 성과
RAG 기반 AI 에이전트 포트폴리오 구현
정적 페이지 나열 방식의 한계를 벗어나, Markdown 문서를 청킹·임베딩하여 벡터 인덱스를 구축하고 AI 에이전트와 대화하며 포트폴리오를 탐색할 수 있는 인터랙티브한 환경을 구현했습니다.
의미 기반 검색으로 자연스러운 질의응답 실현
질문 단어와 문서 단어가 달라도 의미적으로 관련된 내용을 찾아 답변할 수 있도록 구현하여, 방문자가 별도의 키워드를 외우지 않아도 원하는 정보를 빠르게 얻을 수 있는 탐색 경험을 제공했습니다.
환각 억제 설계로 신뢰성 있는 답변 품질 확보
문서에 근거가 없는 질문에는 명확히 답변 불가를 안내하도록 설계하여, 잘못된 정보를 그럴듯하게 제공하는 환각 문제를 구조적으로 억제하고 서비스 신뢰도를 높였습니다.
멀티턴 대화 지원으로 자연스러운 탐색 흐름 제공
Thread 단위 인메모리 체크포인터를 적용하여 이전 질문의 맥락이 유지된 상태에서 후속 질문을 이어갈 수 있도록 구현했으며, 단발성 응답이 아닌 대화 흐름 기반의 탐색 경험을 제공했습니다.
클린 아키텍처 기반의 유지보수 가능한 백엔드 구조 설계
LLM, 임베더, 벡터 스토어 등 각 구성 요소를 Port-Adapter 구조로 분리하여, 특정 기술에 종속되지 않고 기능 추가나 기술 교체에도 유연하게 대응할 수 있는 백엔드 구조를 구축했습니다.
핵심 기능
AI 에이전트 대화 탐색
방문자가 궁금한 내용을 자연어로 질문하면, AI 에이전트가 포트폴리오 문서를 기반으로 근거 있는 답변을 스트리밍으로 제공합니다.
진행 단계
기획 및 문제 정의
2025.12.
정적 포트폴리오의 한계를 분석하고, AI 에이전트와 대화하며 탐색하는 인터랙티브 포트폴리오의 방향성과 핵심 기능 정의
프로젝트 상세
1) 포트폴리오 소개 개발자 박해원의 포트폴리오 사이트로, RAG 기반 AI 에이전트와 대화하며 포트폴리오를 탐색할 수 있는 인터랙티브 웹 서비스입니다. 단순한 정적 소개 페이지가 아니라, 방문자가 질문을 던지면 AI가 포트폴리오 문서를 검색·분석하여 근거 있는 답변을 스트리밍으로 제공합니다. 개발 철학, 경험, 프로젝트를 대화 형태로 자연스럽게 탐색할 수 있도록 설계된 서비스입니다. 2) 작업 범
