namerong 님의 블로그

냉파마스터 2차 프로젝트: AI 장보기 추천 Agent 연동과 LLM 사용량 관리 구현

이번 작업은 냉파마스터 2차 프로젝트의 리팩토링 및 확장 작업이다.1차 프로젝트에서는 냉장고 재료 관리, 장보기 목록 관리, 사전 재료 검색, 관리자 사전 재료 관리 기능을 중심으로 기본 CRUD 흐름을 구현했다.2차 프로젝트에서는 여기서 한 단계 확장해, 사용자의 냉장고와 장보기 상태를 기반으로 AI가 필요한 재료를 추천하고, 추천 결과를 사용자가 직접 승인해 장보기 목록에 추가할 수 있는 구조를 구현했다.이번 작업 범위는 다음과 같다.#238 AI 장보기 추천 MVP 구현#239 AI 대화 세션 및 메시지 기록 구현#240 LLM 사용량 로그 저장 구현#316 프론트 AI 장보기 추천 화면 연동#317 관리자 LLM 사용량 전체 조회 API 구현#318 관리자 LLM 사용량 로그 화면 구현1. 작업 ..

[TIL]CI/CD, GitHub Actions, Argo CD, Jenkins, Kubernetes, AWS 배포

1. 학습 주제애플리케이션을 개발한 뒤 서버에 배포하는 흐름과, 이를 자동화하는 CI/CD 개념을 학습했다.또한 AWS 환경에서 직접 배포를 진행하며 EC2와 Elastic Beanstalk 같은 배포 방식의 차이를 정리했다.핵심 내용은 다음과 같다.CI/CD 개념GitHub ActionsJenkinsArgo CDKubernetesAWS EC2 배포Elastic BeanstalkVPC 기본 개념2. CI/CD란?CI/CD는 개발한 코드를 자동으로 검사하고 배포하기 위한 개발 자동화 흐름이다.코드 작성-> Git push-> 빌드-> 테스트-> 이미지 생성-> 서버 배포CI와 CD는 역할이 조금 다르다.구분의미역할CIContinuous Integration코드 변경 사항을 자주 통합하고 빌드/테스트CDCo..

1차 프로젝트에서는 냉장고, 사전 재료, 장보기 기능의 기본 CRUD와 프론트 연동을 중심으로 구현했다.2차 프로젝트에서는 단순 기능 추가보다는 기존 기능을 더 안정적으로 다듬고, 이후 AI Agent 기능으로 확장할 수 있는 구조를 만드는 것을 목표로 잡았다.이번 작업 범위는 크게 세 가지였다.첫째, 장보기 항목 중복 등록 방지둘째, AI Agent가 사용할 Tool API 구조 정리셋째, 냉장고와 장보기 상태를 기반으로 한 장보기 추천 MVP 구현관련 이슈는 다음과 같다.이슈작업 내용#234장보기 항목 중복 등록 방지#235AI 장보기 자동화 Agent API 명세 작성#236Agent 냉장고/장보기 조회 Tool API 구현#237Agent 장보기 추가 Tool API 구현#238AI 장보기 추천 ..

1. 학습 주제Dockerfile로 애플리케이션 이미지를 만들고, Docker Compose로 여러 컨테이너를 함께 실행하는 흐름을 학습했다.추가로 AWS EC2 같은 클라우드 서버에 파일을 올리고, 서버에서 Docker 이미지로 실행하는 기본 배포 흐름도 정리했다.핵심 내용은 다음과 같다.DockerfileDocker 이미지와 컨테이너JRE와 JDK 차이Spring Boot JAR Docker 이미지 생성scp로 EC2 서버에 파일 전송EC2 방화벽 설정Docker ComposeDocker NetworkDocker VolumeCloud, IaaS, PaaS, SaaSAWS 주요 서비스2. Dockerfile이란?Dockerfile은 Docker 이미지를 만들기 위한 설명서이다.이미지를 만들 때 필요한 ..

1. 학습 주제Linux와 Ubuntu의 기본 개념, 터미널 명령어, 에디터 사용법, Docker의 이미지와 컨테이너 개념을 학습했다.서버 환경에서는 GUI보다 터미널을 많이 사용하기 때문에 기본 명령어와 파일 편집 도구에 익숙해지는 것이 중요하다.핵심 내용은 다음과 같다.Linux와 Ubuntu 개념Shell과 터미널Nano, vi, vim 차이절대경로와 상대경로기본 Linux 명령어리디렉션과 grepDocker 이미지와 컨테이너Docker 컨테이너 실행, 접속, 중지, 삭제2. Linux란?Linux는 운영체제의 핵심인 Kernel을 기반으로 만들어진 운영체제 계열이다.서버, 클라우드, Docker, 안드로이드 등 다양한 환경에서 많이 사용된다.Linux 자체는 하나의 완성된 제품이라기보다, 여러 배..

1. 학습 주제LangSmith를 사용해 AI Workflow 실행 과정을 추적하고, 실패 원인을 확인하며, 수정 전후 결과를 Dataset과 Experiment로 비교하는 흐름을 학습했다.핵심 내용은 다음과 같다.LangSmith 환경 설정 확인@traceable을 사용한 실행 추적Workflow 실행 Trace 기록실패 Workflow 추적baseline 버전과 fixed 버전 비교Dataset 생성Evaluator 작성Experiment 실행과 비교2. LangSmith란?LangSmith는 LangChain, LangGraph 기반 애플리케이션의 실행 과정을 관찰하고 평가할 수 있게 도와주는 도구이다.AI Workflow는 내부에서 여러 단계가 실행된다.Planner-> Executor-> Tas..

1. 학습 주제Agent가 Tool을 사용할 때 필요한 안전 제어와, 복잡한 작업을 계획 -> 실행 -> 검증 -> 재계획 흐름으로 처리하는 Workflow 구조를 학습했다.핵심 내용은 다음과 같다.Agent Memory 보완thread_id 기반 대화 기억 분리Agent Safety재시도, Fallback, Handoff 처리Graph의 종료 조건과 recursion_limitPlannerExecutorValidatorReplannerPydantic 기반 실행 계약 정의2. Agent Memory 보완Agent Memory는 이전 대화를 기억해 다음 요청에서 활용하는 구조이다.이번 실습에서는 Checkpointer를 사용해 같은 thread_id의 대화 메시지를 이어가도록 구성했다.checkpointe..

1. 학습 주제Agentic AI의 기본 구조를 학습했다.이전까지는 RAG, VectorStore, LangGraph처럼 정해진 흐름을 구성하는 데 집중했다면, 이번에는 모델이 상황에 따라 Tool을 선택하고 실행 결과를 보고 다음 행동을 결정하는 구조를 다뤘다.핵심 내용은 다음과 같다.Workflow와 Agent 차이Tool Contract와 SchemaLangChain create_agentTool Calling 메시지 흐름ReAct 구조Action, Observation, Final AnswerCheckpointer 기반 Agent Memorythread_id를 통한 대화 기억 분리2. Workflow와 Agent 차이Workflow는 개발자가 실행 순서를 미리 정해두는 방식이다.질문 분석-> 장소..

1. 학습 주제FastAPI와 Spring을 HTTP로 연결해 파일 업로드를 처리하는 구조와, LangGraph를 사용해 AI 작업 흐름을 Graph 형태로 구성하는 방법을 학습했다.핵심 내용은 다음과 같다.FastAPI 파일 업로드 API 구현Spring에서 MultipartFile을 받아 FastAPI로 전달RestClient를 사용한 서버 간 HTTP 통신LangChain Chain과 LangGraph Graph 차이LangGraph의 State, Node, EdgeReducer를 사용한 State 병합조건 분기 라우팅RAG 흐름을 Graph로 구성질문 의도에 따라 RAG 또는 일반 답변으로 분기2. FastAPI 파일 업로드 APIFastAPI에서는 파일과 일반 값을 함께 받기 위해 multipa..

1. 학습 주제FastAPI로 REST API를 구성하고, 기능별 Router 분리, 파일 입출력, 파일 업로드, Spring 서버와 FastAPI 서버를 HTTP로 연결하는 흐름을 학습했다.핵심 내용은 다음과 같다.REST CRUD API 구현GET, PUT, PATCH 차이 이해APIRouter로 기능별 API 분리Pydantic Schema 재사용Python Path를 활용한 파일 입출력multipart/form-data 기반 파일 업로드파일 확장자, Content-Type, 용량 검증Spring RestClient로 FastAPI 호출Spring 서버가 FastAPI 서버를 중간에서 연결하는 구조2. REST CRUD APIREST API는 URL과 HTTP Method를 조합해서 자원을 다루는 ..