본문으로 이동
DLDevelopment Lab책을 읽고, 직접 만드는 실험실
19AI가 내 유튜브 댓글을 읽고 답글을 준비합니다20허용한 댓글에만 자동으로 답하게 합니다21내 주식서비스의 챗봇을 기획합니다22기획한 챗봇을 내 주식서비스에 구현합니다
PART 6 · 만든 서비스에 AI를 붙이고, 반복 업무를 맡깁니다21장

내 주식서비스의 챗봇을 기획합니다

docs/ch21-chat-design.md에 기능 범위·답변 구분·사용 흐름·화면 설계·재사용 연결표·22장 구현 순서와 완료 조건을 확정합니다.

이어갈 프로젝트 · ai-stock-briefing

9~12장의 ai-stock-briefing으로 돌아옵니다. 기존 실행 방법과 설정을 재사용하며 14~15장 앱과 기존 작업을 보존합니다. 19~20장 완료는 선행 조건이 아닙니다.

커맨드준비막혔을 때완료 확인소스·검증
이번 장의 준비와 서비스

필요한 도구 · 기존 주식서비스 코드와 실행 방법 읽기 · Markdown 기획서 · 필요한 SDK 공식 문서 확인

이미 준비한 계정과 기능은 그대로 이어갑니다.

투자 추천·매매·목표가·미래 가격 예측·공시 본문 수집·자유 웹 검색·RAG·벡터 DB·장기 대화 저장·새 회원/결제 시스템·별도 모바일 앱 수정은 제외합니다. 제품 코드·Test·컴포넌트·작동하는 목업은 만들거나 수정하지 않습니다. 챗봇 공개 운영 확장 실습·분산 사용량 저장소는 만들지 않습니다. 기존 브리핑 Cache는 유지합니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01주식서비스로 돌아옵니다

Claude Code·Codex에 입력튜터 요청

현재 장을 시작하거나 다시 이어갈 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

21장 시작해.

02어떤 질문을 해결할지 정합니다

Claude Code·Codex에 입력실습

주식서비스 챗봇 기획 시작

먼저 확인 · 9~12장 자기 ai-stock-briefing 선택과 기존 서비스 확인. 19~20장 완료는 선행 조건 아님.

ai-stock-briefing의 기존 화면과 기능을 읽고 챗봇 기획을 시작해줘.
기존 브리핑은 전체 요약, 챗봇은 개별 질문을 담당하게 할 거야.
일반 개념, 가격·기준일, 가격 흐름, 최근 공시와 원문 질문을 대표 사례로 정리해줘.
관련 경제·기업·데이터·AI 개념도 허용하되,
특정 기업의 현재 상황·최근 사건·주가 원인을 사전지식으로 채우지 않게 해.
투자 추천·매매·목표가·미래 가격 예측·공시 본문 수집·자유 웹 검색은 제외해.

기능과 제외 범위, 질문별 기대 답변을 docs/ch21-chat-design.md에 작성해줘.
기존 기능·화면·제품 코드·Test는 바꾸지 마. 이 장은 기획만 할 거야.
이후 결정도 같은 기획서에 누적하고 이미 정한 내용을 이유 없이 다시 기획하지 마.

03메인에서 질문부터 시작하게 합니다

Claude Code·Codex에 입력실습

답변 구분·사용 흐름 기획

먼저 확인 · 같은 기획서의 기능·질문 결정 확인.

기획서에 답변 구분과 사용 흐름을 추가해줘.
'확인된 자료'는 서버 수치·날짜·공시·출처로 표시하고,
'AI 일반 설명'에는 '최신 확인 자료가 아닙니다'를 붙여줘.
일반 질문에는 빈 사실 카드를 만들지 않고 종목 자료 질문은 관련 항목부터 보여줘.
형식 검사만으로 문장 의미가 모두 정확해진다고 설명하지 마.

메인에서 종목 선택 없이 질문하고, 회사명·코드는 실제 검색 결과로 확인해.
모호하면 실제 후보 최대 5개를 보여주고 선택 전 가격·공시 조회는 하지 않아.
질문은 보관하고 선택 뒤 이어가. 취소·검색 실패 시에도 질문을 잃지 않게 해.
상세의 현재 종목은 최초 기본값이고, 다른 회사를 물으면 대화 대상만 바꿔.
후속 질문은 바뀐 대화 대상을 우선하고, 실제 페이지 이동 때는 새로 시작해.
최근 3회 왕복은 언어 문맥으로만 사용하고 종목 변경 때 이전 근거와 대화를 지워.
전환을 요청한 새 질문은 보관하고 이전 종목의 늦은 응답은 붙이지 않아.
이 흐름과 실패 시 다음 행동을 기획서에 표와 도식으로 정리해줘. 제품 구현은 하지 마.

04버튼의 위치와 대화창의 모양을 정합니다

Claude Code·Codex에 입력실습

기존 화면 기반 디자인 계획

먼저 확인 · 기존 실제 화면과 앞선 사용 흐름 확인.

기존 서비스의 실제 색·글꼴·카드·여백과 하단 조작 위치를 조사하고 화면을 설계해줘.
우하단 플로팅 버튼, 데스크톱 오른쪽 레이어, 모바일 웹 큰 레이어를 계획해.
현재 대상·질문·전송 상태·두 답변 영역·출처·지우기·닫기를 배치해.
관련 자료를 먼저 읽고 추가 자료를 펼치는 순서도 정해줘.
닫기·포커스 복귀·키보드·스크롤·하단 안전 여백의 검사 항목을 적어줘.

메인·상세의 기존 화면을 보존하고 별도 모바일 앱은 바꾸지 마.
기획서에 화면 설계도를 추가하되 실제 실행 화면처럼 표시하지 마.
필요한 화면 상태와 이용자가 다음에 할 행동이 빠졌는지 확인해줘.
제품 컴포넌트나 작동하는 목업은 아직 만들지 마.

05기존 기능으로 효율적으로 구현할 방법을 찾습니다

Claude Code·Codex에 입력실습

기존 함수 연결 조사

먼저 확인 · 기획서 세 기능과 현재 코드 확인.

기획한 세 조회 기능을 실제 코드에 연결할 방법을 조사해줘.
종목 찾기·기간별 가격 요약·공시 목록 조회의 기존 함수 위치·입력·결과·실패·Cache를 표로 적어줘.
최근 공시는 최근 1년 안 최신순 최대 5건과 서버가 만든 DART 원문 링크야.
전체 브리핑 근거·대표 공시·전체 시장 조회를 챗봇에 통째로 재사용하지 마.
기존 검색·가격·공시 하위 함수와 데이터 Cache를 재사용하고,
브리핑 Redis 결과 Cache를 대화 저장소로 전용하지 마.

최근 1년 일봉만 있으면 1개월·3개월을 자르는 작은 Adapter를 계획해.
같은 가격 조회 기능에서 최근 확인 종가·기준일만 묻는 질문도 처리하도록 계획해.
기간별 흐름을 묻는 질문과 구분하고, 종가만 물었을 때 기간 선택을 요구하지 마.
서울 날짜의 달력 월/연, 월말 처리, 요청 기간과 실제 거래일, 등락률 계산 기준을 정해.
1개월·3개월은 고정 거래일 수가 아니라 달력 기간으로 계산해.
자료가 충분한지도 요청한 기간을 기준으로 판단하고 실제 거래일 범위를 보여줘.
연결표 뒤에 AI용 세 함수의 이름과 입력·결과 형식을 확정해줘.
현재 Gemini SDK·모델의 함수 호출 지원은 코드와 공식 문서로 확인해.
미확인·추가 구현·그대로 재사용을 구분해 기획서에 적고 제품 코드는 바꾸지 마.

06구현 순서와 완료 조건까지 기획합니다

Claude Code·Codex에 입력실습

기획서 구현 순서 확정

먼저 확인 · 범위·사용 흐름·화면·연결표와 독자 결정 확인.

기획서를 22장에서 실행할 계획으로 마무리해줘.
대화창·일반 설명 → 종목 찾기·공시 → 답변과 출처 → 가격 기간·후속 대화
→ 제한·실패·회귀·모바일 검수 순서로 구현 단계와 완료 기준을 적어줘.
각 단계의 대표 질문, 화면에서 볼 결과, 실패 시 돌아갈 지점을 연결해줘.

질문은 1,000자, 최근 대화는 3회 왕복으로 제한해.
초기 실행 상한은 모델 3회·조회 4회·전체 30초로 두고,
공시·가격+공시·후보 선택 재개를 제한 안에서 검사한 뒤 확정할 계획을 세워줘.
동일 요청의 동일 조회 재사용, 중복 제출 방지, 자동 재시도 금지를 포함해.
공시 질문의 가격 조회 없음, 일반 질문의 조회 없음, 악성 입력·늦은 응답도 검사해.

실제 API·시험 응답·브라우저 크기 시험·실기기 검증을 구분해.
완료 기준은 실제 자료 검증과 챗봇 활성 상태 확인으로 두고 대화는 기본 켜짐으로 계획해.
CHAT_ENABLED를 설정하지 않아도 활성화하고, 명시적으로 false일 때만 끄게 해.
기획서에 결정·미확인·다음 장에서 검증할 항목을 구분해줘.
완료 선언 전 기능·사용 흐름·디자인·연결표·구현 계획이 서로 맞는지 대조해.
제품 코드와 Test가 바뀌지 않았는지도 확인해줘.

07구현 순서와 완료 조건까지 기획합니다

Claude Code·Codex에 입력튜터 요청

이번 장 완료 조건을 확인할 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

장 완료 확인해줘.
이 장에서 막혔을 때

21장. 내 주식서비스의 챗봇을 기획합니다 — 단계별 힌트

한 번에 한 단계만 전달합니다.

H21-PLAN · 기획서가 길어졌는데 무엇을 만들지 모르겠습니다.

힌트 1

대표 질문 하나와 이용자가 볼 결과를 먼저 연결해보세요.

힌트 2

기능 범위·사용 흐름·화면 배치에서 같은 질문을 따라가 보세요.

힌트 3

docs/ch21-chat-design.md에서 공시 질문의 종목 확인·후보 선택·답변·원문 링크·실패 시 행동이 연결되는지 확인합니다.

명시적으로 정답을 요청했을 때

기획서를 기능 목록으로 늘리지 말고 질문→흐름→화면 결과→기존 함수→22장 검증의 연결표로 정리합니다. 제품 구현은 22장에서 합니다.

H21-REUSE · 기존 기능을 어디까지 재사용할지 모르겠습니다.

힌트 1

브리핑 전체보다 검색·가격·공시 하위 기능을 찾아보세요.

힌트 2

함수 위치와 입력·결과·실패·Cache를 한 줄씩 비교합니다.

힌트 3

1년 일봉 재사용과 1·3개월 계산 Adapter, 짧은 기간의 자료 부족 기준을 구분합니다.

명시적으로 정답을 요청했을 때

실제 코드를 확인한 부분과 추가 구현할 부분을 나누고 AI용 세 기능 이름은 연결표 뒤에 정합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →
이번 장의 완료 체크리스트
  • 기존 상태기존 주식서비스·실행 방법·화면과 검색·차트·공시·브리핑·Database·Cache의 재사용 대상을 기획서에서 확인합니다.
  • 기능과 경계대표 질문·지원/제외 범위·확인된 자료와 AI 일반 설명을 정합니다. 일반 설명 표시만으로 특정 기업의 최신 사실을 허용하지 않습니다.
  • 사용 흐름메인 질문 시작·실제 종목 확인·후보 최대 5개·선택 전 조회 금지·원래 질문 보관·상세 기본 대상과 대화 전환·최근 3회 왕복·늦은 응답 차단을 설계합니다.
  • 화면과 모바일플로팅 위치·데스크톱 오른쪽 레이어·모바일 웹 큰 레이어·현재 대상·답변 순서·키보드·안전 여백·닫기·포커스 복귀를 기존 디자인과 대조합니다. 설계도를 실행 화면으로 표시하지 않습니다.
  • 기존 함수 연결세 조회 기능의 실제 함수·입력·결과·실패·Cache를 조사한 뒤 AI용 이름을 정합니다. 서울 날짜의 달력 1·3·12개월, 월말·실제 거래일·자료 부족을 정의하고 브리핑 Cache를 대화 저장소로 전용하지 않습니다.
  • 구현 계획22장 단계·대표 질문·완료 기준·실패 시 다음 행동을 연결합니다. 질문 1,000자·최근 3회·초기 모델 3회/조회 4회/30초·중복 재사용·자동 재시도 금지·기본 활성화·명시적 false만 비활성화와 실제 자료·활성 상태 확인까지의 완료 범위를 계획합니다.
  • 기획서 확정docs/ch21-chat-design.md의 기능·흐름·화면·연결표·구현 계획이 일치하고 결정·미확인·다음 검증을 구분하는지 확인합니다. 시작 상태와 비교해 제품 코드·Test가 바뀌지 않았는지 확인합니다.
장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록
21장 완성 소스 ↗21장 시작 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213
이 장의 개발 용어
API
프로그램이 다른 서비스와 정해진 방식으로 요청·응답을 주고받는 연결 방법.
Test
정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.
Cache
같은 조건에서 계산·생성한 결과를 일정 조건 동안 재사용하는 저장 방식.
함수 호출
AI가 사용할 기능과 입력을 제안하고 서버가 검사해 실행하는 방식. 모델의 말만으로 실행됐다고 보지 않습니다.
튜터 사용 안내실습 자료 업데이트
← 이전 장20장. 허용한 댓글에만 자동으로 답하게 합니다다음 장 →22장. 기획한 챗봇을 내 주식서비스에 구현합니다
Development Lab아이디어를 AI와 함께 나만의 결과물로 만듭니다.

책에서 배운 개발 원칙을 AI와 직접 만들며 확인하는 실험실입니다. 아이디어를 서비스로, 서비스를 나만의 결과물로. AI와 함께 만들고, 직접 확인하며, 내 손으로 완성합니다.

자료실튜터 안내업데이트
SAStudy AI LabILInvestment LabDLDevelopment Lab

© 2026 Study AI Lab. All rights reserved.