공통 역량 (1~9주차)
개발환경·LLM API·데이터·임베딩·RAG·FastAPI·UI — 모두가 함께 정렬하는 공통 기술 스택 실습
정렬: 최근 업데이트순
9주차 라이브 빌드 3: 대역을 걷어내고 v1.0을 찍다
라이브 빌드의 마지막 교안입니다. v0.7.0의 가계부에는 대역이 둘 남았고, AI가 한 일을 남기는 테이블은 처음부터 있었지만 비어 있습니다. 오늘은 다섯 가지를 합니다. 먼저 감사 로그를 기록하는 길을 깔고, 리포트의 '눈에 띈 것'을 Plan-and-Execute로, 채팅으로 기록하는 문장을 쓰기 도구와 확인 게이트로 바꿉니다. 그다음 이미 정의한 도구를 MCP로 밖에 읽기 전용으로 내놓고, 마지막으로 AI가 한 일을 모아 보는 화면을 붙입니다. 대부분 라이브 데모로 진행하고, 이 문서에는 순서와 지시 프롬프트, 확인할 것만 적었습니다.
9주차 라이브 빌드 2: 가계부에 도구와 RAG를 얹다
라이브 빌드의 두 번째 교안입니다. 지난 라이브 빌드에서 세운 가계부는 v0.5.0까지 왔고, AI 자리 넷 중 둘에 진짜 에이전트가 섰습니다. 그런데 그 에이전트는 아직 도구를 한 번도 고른 적이 없습니다. 오늘은 두 가지를 합니다. 앞 시간에는 tool calling을 짧게 복습하고 '저번 주에 카페 몇 번 갔어?'에 답하는 대화 통계를 세 회전으로 짓습니다. 모델은 마지막 회전에서만 들어옵니다. 뒤 시간에는 RAG를 복습하고 문서 Q&A를 v0.7.0까지 짓습니다. 자료는 가상 문서 대신 카드 소득공제·가맹점 의무·할부 철회를 다룬 실제 법령이고, 짓기 전에 열어 보고 계획부터 씁니다. 무엇을 정하고 무엇을 실험에 맡길지 가른 뒤, 모델 없는 키워드 검색에서 시작해 검색을 먼저 재고, 인용하는 답을 붙이고, 마지막에 그 검색을 채팅의 도구로 내놓아 두 기능을 잇습니다.
9주차 라이브 빌드: 빈 저장소에서 v0.5까지
라이브 시연 교안입니다. 9주 동안 우리는 늘 v0.1이 준비된 저장소에서 시작했고, 그 v0.1을 누가 어떤 순서로 만들었는지는 한 번도 보지 않았습니다. 다음 주부터 각자가 마주하는 것이 정확히 그 빈 저장소입니다. 이번 주는 저장소 개설에서 시작해 문서를 먼저 세우고, AI를 뺀 채 도는 제품을 만든 뒤, 마지막에 에이전트를 하나씩 얹습니다. git flow 세 회전과 v0.1·v0.2·v0.5 세 태그로 진행하고, 소재는 현장에서 고릅니다.
9주차: 화면 안의 에이전트, 그리고 스택의 완성
9주차와 함께 공개하는 레퍼런스 구현 해부입니다. 이번 주 본편은 라이브 빌드이고, 이 문서는 다 자란 제품 하나를 층별로 여는 자습용 교안입니다. 공통 역량 구간의 마지막 회차이고, 10주차부터 베껴 쓸 레퍼런스 구현입니다. 화면 옆에 챗 위젯을 붙이는 흔한 구조가 지시대명사 하나에 무너지는 장면에서 출발해, 화면의 상태와 에이전트의 상태를 하나로 만드는 AG-UI를 봅니다. 그 위에 승인 카드와 생성 UI를 얹고, 요청마다 다른 루프가 도는 그래프와 하네스를 해부한 뒤, 한 줄이 아홉 층을 관통하는 트레이스로 9주를 닫습니다.
8주차: 서비스 경계, 두 개의 문과 자동화
라이브 세션의 상세 교안입니다. 이번 주는 새 에이전트를 만들지 않습니다. 6주차 여행 플래너를 코어에 그대로 두고 껍데기만 얹어, 사람이 부르는 문(HTTP)과 다른 AI가 부르는 문(MCP)을 열고, 이벤트가 부르는 세 번째 문(n8n)까지 답니다. 3주차의 헤드리스 구조와 5주차의 LiteLLM, 6주차의 하네스와 MCP가 이번 주에 각자 제자리를 찾습니다.
7주차: 멀티 에이전트 패턴
라이브 세션의 상세 교안입니다. 6주차에 완성한 루프 여럿을 엮습니다. 나누지 않는 것이 기본이라는 원칙에서 출발해, 같은 질문을 단일 에이전트와 supervisor 구조에 던져 숫자로 비교하고, 제어권이 넘어가고 돌아오지 않는 handoff의 사고를 재현해 규칙으로 묶고, 계획이 태스크를 만들어 병렬로 던지는 코딩 에이전트에서 5·6주차의 개념이 전부 제자리를 찾는 것을 봅니다.
6주차: 에이전트 루프와 하네스
라이브 세션의 상세 교안입니다. 5주차에서 도구를 든 에이전트에 루프를 달아 처음으로 동작시킵니다. 트레이스를 읽고, 스텝 한도가 무한 루프를 막는 것을 재현하고, 컨텍스트가 스텝마다 부푸는 것을 실측합니다. 그 비용 구조를 공격하는 루프들을 견준 뒤, 인젝션 사고를 재현하고 데이터 경계·권한 게이트·budget guard로 막아 에이전트를 완성합니다. 마지막으로 도구를 표준 프로토콜로 주고받는 MCP를 맛봅니다.
5주차: API 해부와 tool calling
라이브 세션의 상세 교안입니다. 1~4주차에 프레임워크와 라이브러리 뒤에 가려 있던 것을 이번 주에 바닥부터 헤칩니다. 먼저 AI 모델(뇌)과 AI 서비스(도구·루프를 둘러 붙인 제품)를 가르고, 같은 질문을 도구 없이·도구를 쥐여주고 두 번 물어 그 차이를 실측으로 봅니다. 이어서 최소 호출의 요청·응답 JSON 원문에서 출발해 역할·토큰·무상태·비용을 잡고, 통합 레이어 위에서 교체·폴백·캐싱·라우팅을 쓰고, 도구 호출 왕복을 JSON 원문으로 해부합니다. 예제 32종을 전부 실행하며, 세션 끝에서 여행 플래너 에이전트가 처음으로 도구를 듭니다.
4주차: 데이터 수집·정제와 RAG 검색
라이브 세션의 상세 교안입니다. 3주차의 깨끗한 foods.json이 어떻게 만들어졌는지, 치우기 전의 원본을 직접 만나며 알게 됩니다. 식약처 가공식품 DB 187MB·306,307건을 인코딩 정리·결측 정책·컬럼 슬림으로 정제하고, 자유 텍스트로 보이는 섭취참고량을 고유값으로 접어 파싱하며, 정제 데이터셋을 PostgreSQL에 적재해 검색 서비스로 소비합니다. 그 위에 구글 임베딩으로 벡터 인덱스를 세워 의미 검색을 열고, 검색이 추린 몇 건만 컨텍스트로 LLM을 불러 RAG 질의응답의 비용 구조를 보입니다. 정제는 코드가 아니라 리포트로 검증합니다.
3주차: LLM API와 프롬프트
라이브 세션의 상세 교안입니다. 이번 주는 일부러 에이전트가 아닌 것, 곧 코드가 제어하는 파이프라인을 만듭니다. 식약처 영양DB 실데이터로 '한 주 밥상' 식단 플래너 API를 지으며, 계획자와 검증자를 다른 회사 모델로 교차시키고, 나쁜 프롬프트의 실패를 컨텍스트 주입·스키마·few-shot으로 단계별 교정하며, 폴백 체인으로 안전 검사의 가용성을 지킵니다.
2주차: 컨테이너 개발환경과 팀 워크플로
라이브 세션의 상세 교안입니다. DB가 붙으며 개발 환경이 컨테이너 무리가 되는 지점에서 docker compose를 익히고, 이미 동작하는 회의실 예약 서비스(검색·예약·취소) 위에 도구를 감싸 AI 에이전트를 얹습니다. feature 브랜치 3회전을 지시 → 검증 → 커밋 → PR → CI → 머지 사이클로 관찰하며, 권한 코드 강제·폴백·루프 가드로 단단하게 만듭니다.
1주차: AI 서비스 전주기 이해와 첫 에이전트
라이브 세션의 상세 교안입니다. AI 서비스가 도는 5레이어 스택과 엔지니어링 사다리를 조망하고, 분식집 주문 에이전트를 지시 → 생성 → 검증 → 수정 사이클로 완성하는 라이브 빌드를 관찰하며, 개인 repo를 개설합니다.