🏆[관광 프롬프톤 수상] 현장체험학습 플래너 제작기

안녕하세요! 최근 한국관광공사가 주관하고 Wanted가 후원한 '생성형 AI를 활용한 관광프롬프톤'에서 제가 개발한 '현장체험학습 플래너' 서비스로 서비스 비전 우수상을 받게 되어 기쁜 마음으로 그 개발 과정과 수정 버전을 공유하고자 합니다.

현장체험학습 플래너 체험 바로가기!

1. 프로젝트 개요: 학생들을 위한 맞춤형 현장체험학습

'현장체험학습 플래너'는 사용자가 특정 지역을 입력하면, AI가 교육적이고 흥미로운 현장체험학습 코스를 추천해주는 웹 애플리케이션입니다. 단순히 장소를 나열하는 것을 넘어, 각 장소에 대한 상세 설명, 최적화된 이동 경로, 그리고 가장 중요한 RAG(Retrieval-Augmented Generation) 기반의 AI 추천사까지 제공하여 선생님과 학생들에게 실질적인 도움을 주고자 했습니다. 완성된 계획은 이메일로도 받아볼 수 있습니다.

핵심 기능 요약:

• 코스 추천: LLM API와 한국관광공사 TourAPI 연동을 통한 5개 추천 코스 생성.
• 상세 정보: TourAPI 연동으로 장소별 상세 설명, 홈페이지, 무장애 시설 정보 제공.
• 최적 경로: OSRM 및 Naver Maps API를 활용한 최단 경로 및 소요 시간/거리 계산.
• AI 추천사: Zilliz Cloud 벡터 DB에 저장된 교과서 내용을 기반으로 LLM API가 교육적 맥락의 추천사 생성.
• 이메일 전송: 생성된 여행 계획을 이메일로 발송.

2. 왜 'Wanted LaaS' 대신 직접 구현했는가?

이번 프롬프톤에서는 Wanted의 LaaS(LLM as a Service)를 활용하여 LLM 모델 교체, 펑션콜링, RAG 구현을 손쉽게 진행할 수 있었습니다. 하지만 이러한 구현을 LaaS를 사용하지 않고, 각 LLM 모델들을 API로 직접 가져다 쓰고, 펑션콜링도 직접 구현하며, RAG 또한 Zilliz를 이용해서 바닥부터 구현해봄으로써, 편안한 서비스 뒤에 숨겨진 과정을 확인하여 실력을 높이고 싶었습니다.

그리고 교육자로서 더 깊은 질문에 부딪혔습니다. "이 편리한 AI 서비스의 블랙박스 너머에서 내 데이터는 어디로 가고, AI는 어떤 기준으로 학습하고 추론하는 걸까?"
이 고민은 최근 IT 업계의 가장 큰 화두인 '소버린 AI(Sovereign AI)' 와 맞닿아 있다고 생각합니다. 소버린 AI는 단순히 '국산 AI'를 쓰자는 구호를 넘어, 한 국가의 데이터와 기술 주권을 지키고, 그 나라의 언어·문화·사회적 맥락에 최적화된 AI를 만들자는 기술 철학입니다.

생각해보니 학생들과 학부모님이 쓸 제 '현장체험학습 플래너'야말로 소버린 AI가 가장 필요한 영역이었습니다.

• 데이터 주권: 제 서비스는 '한국사 교과서', '한국지리 교과서' 등 민감할 수 있는 교육 데이터를 다룹니다. 이 데이터가 해외의 빅테크 기업 서버를 거쳐 어떻게 활용될지 모른다는 것은 교육자로서 큰 찜찜함이었습니다.

• 문화적 맥락: "이순신 장군의 명량해전"을 추천할 때, 단순한 역사적 사실 나열을 넘어 그 비장함과 의미를 한국인의 정서로 전달해야 합니다. "슬로시티"의 개념 또한 서구의 그것과는 다른 한국적 '느림의 미학'이 담겨야 합니다. 대한민국의 역사와 문화를 가장 깊이 이해하는 AI는, 당연히 대한민국의 데이터로 학습한 AI일 수밖에 없을 것입니다.

이러한 생각 속에서, 네이버클라우드의 새로운 추론 모델 HCX-007이 등장하였다는 소식에 헐레벌떡 서비스를 재구성 해보았습니다.

3. 시스템 아키텍처

저희 '현장체험학습 플래너'는 다음과 같은 시스템 아키텍처를 기반으로 구축되었습니다.

3.1. 전략 패턴 기반 LLM 통합 아키텍처 및 HCX 모델 활용 구조

다양한 LLM을 유연하게 교체하고 테스트할 수 있도록 전략 패턴(Strategy Pattern)을 적용했습니다.

• 중앙 관리자 (llm_manager.js): 모든 LLM 호출의 단일 진입점입니다. chat.completions.create라는 표준화된 인터페이스를 제공하여, server.js와 같은 비즈니스 로직에서는 어떤 LLM이 사용되는지 알 필요가 없습니다.
• 프로바이더 (llm_providers/): 각 LLM API(Google, Naver, OpenAI, Upstage) 연동 로직을 독립적인 모듈로 캡슐화합니다. 각 프로바이더는 llm_manager가 요구하는 표준 입력을 받아 각자의 API 명세에 맞게 변환하여 호출하고, 그 결과를 다시 표준 형식으로 변환하여 반환합니다.
• HCX 모델 활용 구조:
  • LLM 호출이 아래와 같이 여러 번 일어납니다.
    1. 맨 처음 사용자가 입력한 자연어에서 TourAPI의 키워드 요청을 위한 키워드 추출
    2. 장소별 상세 설명 요약
    3. 상세 설명 요약 + RAG 내용을 바탕으로 한 추천사 작성
  • 그 쓰임새에 따라 LLM 모델을 다르게 사용하게 했는데, 아래와 같이 구성해보았습니다.
    1. 키워드 추출과 상세 설명 요약: "HCX-DASH-002"
    2. 추천사 작성: "HCX-005"/ "HCX-007"(Thinking Effort = Mid)

3.2. RAG(Retrieval-Augmented Generation) 아키텍처

서비스의 핵심인 AI 추천사는 RAG 아키텍처를 통해 구현되었습니다.

• 인덱싱: textbooks 폴더의 PDF 교과서 3종을 process_pdfs.py를 통해 텍스트로 변환하고 의미 단위로 분할한 뒤, OpenAI의 임베딩 모델을 통해 벡터로 만들어 Zilliz Cloud 벡터 DB에 저장했습니다.
• 검색 및 생성: 사용자 요청이 들어오면, 관련 관광지 정보를 쿼리 벡터로 변환하여 Zilliz DB에서 가장 유사한 교과서 내용을 검색(Retrieve)합니다. 검색된 내용을 관광지 정보와 함께 LLM 프롬프트에 포함하여(Augment) 각 LLM API가 더욱 풍부하고 교육적인 추천사를 생성(Generate)하도록 했습니다.
• 프롬프트 엔지니어링: LLM이 '선생님'의 역할을 수행하고, 지정된 형식(FORMAT)에 맞춰 교과서 내용을 명확하게 인용하도록 유도하는 고도화된 프롬프트를 사용하여 답변의 일관성과 품질을 높였습니다.

3.3. 경로 최적화: OSRM과 Naver Maps API의 시너지

저희 서비스는 단순히 교육적인 장소를 추천하는 데 그치지 않고, 그 장소들을 가장 효율적으로 둘러볼 수 있는 '동선'까지 제공하는 것을 목표로 했습니다. 키워드 검색을 통해 찾은 중심 관광지 하나와, TourAPI의 연관 관광지 기능을 활용해 찾은 주변 관광지 10개를 묶어 하나의 코스를 구성했는데요, 여기서 예상치 못한 난관에 부딪혔습니다.

저희 손에 있는 것은 각 장소의 위경도 좌표 목록뿐이었습니다. 이 11개의 점을 어떤 순서로 방문해야 가장 효율적인지 알아내야 했죠. 처음에는 Naver Maps API에 모든 목적지를 한 번에 전달하면 최적 경로를 짜주지 않을까 기대했습니다. 하지만 Naver Maps API는 여러 목적지를 입력했을 때 자동으로 최적 경로 조합을 짜주는 기능은 없더군요. 그저 API에 입력된 순서대로 경로를 탐색하고, 그에 대한 소요 시간과 거리를 알려줄 뿐이었습니다.

결국, API에 경로 정보를 요청하기 전에 '최적의 방문 순서 조합'을 알아내는 과정이 반드시 필요하다는 결론에 이르렀습니다.

그래서 저희는 두 기술의 역할을 명확히 나누는 방식으로 이 문제를 해결했습니다.

• 1단계 (최적 순서 계산): 먼저 OSRM(Open Source Routing Machine)과 같은 라우팅 엔진을 활용합니다. 11개 관광지의 좌표 목록을 OSRM에 전달하여, 모든 지점을 최단 거리로 방문할 수 있는 '최적의 방문 순서'를 계산해냅니다.
• 2단계 (실시간 정보 조회 및 시각화): OSRM을 통해 얻어낸 이 '최적의 방문 순서'를 Naver Maps API에 그대로 전달합니다. 그러면 비로소 실제 교통 상황이 반영된 정확한 총 소요 시간과 이동 거리를 얻을 수 있습니다. 마지막으로, 이 정보를 지도 위에 시각화하여 사용자가 한눈에 전체 동선을 파악할 수 있도록 구현했습니다.
  

네이버 Maps API 설명 문서 보러가기

LLM이 '무엇을' 볼지 추천한다면, OSRM은 '어떤 순서로' 방문할지를 계산하고, Naver Maps API는 '실제로 얼마나 걸리는지'를 알려주고 보여주는 역할을 하는 셈입니다. 이 기술들의 유기적인 조합을 통해, 저희 '현장체험학습 플래너'는 단순 정보 제공을 넘어 실용적인 여행 계획서로서의 가치를 갖추게 되었습니다.

4. CLOVA STUDIO 사용법

API 연동을 준비하는 과정에서 약간의 시행착오가 있었는데요, 다른 분들은 헤매지 않으시길 바라는 마음으로 정리해 봅니다.

4.1. 이용 신청하기

먼저 네이버 클라우드 플랫폼(NCP)에 접속하여 AI Services 메뉴의 CLOVA Studio를 찾아 이용 신청을 해야 합니다. 저희 프로젝트의 핵심 모델 중 하나를 사용하기 위한 첫 단계였죠.
CLOVA Studio 이용 신청 바로가기

4.2. API 키 발급받기

서비스 이용 신청이 승인되면, CLOVA Studio 콘솔의 '바로가기'를 통해 테스트용 API 키를 발급받을 수 있습니다. 이 키가 있어야 외부에서 API를 호출할 수 있습니다.
API 키 발급 바로가기

4.3. REQUEST-ID는 뭐지? 초보를 위한 꿀팁!

그런데 API를 호출하려면 API 키 외에 REQUEST-ID 라는 값이 추가로 필요했습니다. 공식 가이드를 여러 번 읽어봤지만 이 값에 대한 설명이 명확하게 나와 있지 않아 한참을 헤맸습니다. 저희가 HCX 모델 연동 시 가장 애를 먹었던 부분입니다.
CLOVA Studio 개요 페이지

REQUEST-ID는 UUID를 이용해야 하는데, UUID는 Universally Unique Identifier의 약자로, 전 세계적으로 고유한(겹치지 않는) 식별자를 의미합니다. uuid 라이브러리를 통해 해결했는데, Perflexity에 안 물어 봤으면 해결 못했을 것 같아요.

const { v4: uuidv4 } = require('uuid');
// ...호출 시 Headers에 'X-NCP-APIGW-REQUEST-ID': uuidv4() 추가

5. [모델 성능 비교] HCX-005 vs HCX-007, 어떤 모델이 적절할까?

5.1. 결과 요약

결론부터 말하면, HCX-005의 경우 RAG 문서의 정보를 바탕으로 내용을 만들어 내기보다 주로 상세정보 요약을 토대로 말을 만들었음을 알 수 있었습니다. 그리고 출력 토큰이 얼마 되지 않아 내용이 조금 빈약했습니다. 그래도 선생님이 추천해주는 것 같은 자연스러운 말투를 일관되게 유지했습니다.

HCX-007의 경우 추론 모델이라서 그런지 확실히 RAG 문서의 정보를 바탕으로 구체적인 내용까지 인용하며 내용을 구성한 것을 볼 수 있었습니다. 마크다운으로 강조 표시도 많이 쓰이고 구분선과 이모티콘도 적절하게 추가하여 읽기 좋은 레이아웃을 구성했습니다. 비용도 되게 저렴한게 한 번 호출에 30원 정도 들었습니다.

5.2. HCX-005 생성 결과물

5.2.1. HCX-005 결과 캡쳐 화면

5.2.2. HCX-005 결과 전문

선생님의 추천 이유
이 장소들을 선생님이 추천하는 이유:
경남 하동 악양면은 '슬로시티'로 지정되어 있습니다. 가족과 함께하는 현장 체험학습은 학생들이 일상에서 벗어나 자연과 문화를 천천히 경험하며 삶의 여유를 찾을 수 있는 기회를 제공합니다. 또한, 교과서에 나오는 다양한 지형과 문화유산들을 실제로 체험함으로써 학습 효과를 높일 수 있습니다.
추천 장소들
중심 관광지
경남 하동 악양면 [슬로시티]: 경상남도 하동군 악양면 악양서로 357
추천 이유: 슬로시티는 '느리게 살기 미학'을 추구하는 도시입니다. 학생들은 이곳에서 자연과 전통을 느끼며, 바쁜 일상 속에서 잊고 있던 삶의 소중함을 배울 수 있습니다. 또한, 대봉감축제와 같은 지역 축제에 참여해 다양한 체험 프로그램을 즐기며 자연스럽게 학습할 수 있습니다.
주변 가족 관광지들
지리산국립공원(하동): 경상남도 하동군 화개면 화개로 541-9
추천 이유: 지리산은 우리나라 제1호 국립공원으로, 학생들에게 다양한 생태계를 관찰하고 자연의 아름다움을 느끼게 해줍니다. 또한, 교과서에서 배운 지질학적 지식을 현장에서 확인하고 체험할 수 있는 기회가 됩니다.
국사암(하동): 경상남도 하동군 화개면 목압길 104
추천 이유: 국사암은 신라 시대부터 이어져 온 역사적 가치가 높은 곳입니다. 학생들은 이곳에서 우리나라의 불교 역사와 문화를 배우며, 오래된 건축물과 예술 작품을 감상할 수 있습니다. 이는 역사 교과서에서 배운 내용을 생생하게 이해할 수 있는 기회가 될 것입니다.
취간림: 경상남도 하동군 악양면 정동리
추천 이유: 취간림은 아름다운 숲과 함께 일제강점기 독립운동가들의 정신을 기리는 장소입니다. 학생들은 이곳에서 자연의 아름다움과 함께 우리의 역사를 배울 수 있습니다. 특히, 위안부 문제를 기억하는 평화의 탑을 보며 인권과 평화의 중요성을 생각해볼 수 있습니다.
노량마을(노량어촌체험마을): 경상남도 하동군 금남면 쇠끝길 3
추천 이유: 노량마을은 전통적인 어촌 생활을 체험할 수 있는 곳입니다. 학생들은 이곳에서 어촌 문화와 전통을 배우며, 자연 친화적인 활동을 통해 환경 보호의 중요성도 깨닫게 될 것입니다.
대봉감마을(악양대봉감마을): 경상남도 하동군 악양면 대축길 26
추천 이유: 대봉감마을은 지역의 특산물인 대봉감을 활용한 다양한 체험을 제공합니다. 학생들은 농업과 관련된 지식을 쌓고, 건강한 식습관의 중요성을 배울 수 있습니다. 또한, 전통 시장의 모습을 보며 경제와 사회 과목에서 배운 내용을 실생활과 연결 지어 이해할 수 있습니다.
하동포구공원: 경상남도 하동군 하동읍 목도리
추천 이유: 하동포구공원은 섬진강의 아름다운 경치를 배경으로 조성된 공원입니다. 학생들은 이곳에서 자연환경의 가치를 배우고, 강 주변의 생태계를 탐험하며 과학 수업에서 배운 내용을 확인할 수 있습니다.
술상 전어마을: 경상남도 하동군 진교면 술상길 186-1
추천 이유: 술상 전어마을은 전어를 주제로 한 다양한 체험이 가능한 곳입니다. 학생들은 지역의 해양 생태계를 이해하고, 전어의 생태와 영양가에 대해 배울 수 있습니다. 또한, 전어 축제 기간에 방문하면 다양한 문화 행사를 통해 지역 사회의 전통과 문화를 경험할 수 있습니다.
불일암: 경상남도 하동군 화개면 쌍계사길 59
추천 이유: 불일암은 지리산 자락에 위치한 작은 사찰로, 불일폭포와 함께 아름다운 경치를 자랑합니다. 학생들은 이곳에서 마음의 평화를 찾고, 명상과 참선을 통해 자기 성찰의 시간을 가질 수 있습니다. 또한, 불교 문화와 역사에 대해 배우는 기회가 됩니다.
구재봉자연휴양림: 경상남도 하동군 적량면 중서길 60-81
추천 이유: 구재봉자연휴양림은 다양한 편의시설과 레저시설을 갖추고 있어 가족 단위 방문객에게 인기가 많습니다. 학생들은 이곳에서 자연 속에서 다양한 야외 활동을 하며 신체 건강을 증진시키고, 팀워크와 협동심을 배울 수 있습니다. 또한, 자연 생태계의 중요성과 환경 보호의 필요성을 몸소 체험할 수 있습니다.
이러한 장소들을 방문하며 학생들은 교과서에서 배운 내용을 현장에서 직접 체험하고, 가족과 함께하는 시간을 통해 더욱 의미 있는 학습 경험을 쌓을 수 있을 것입니다. 자연과 역사, 문화를 동시에 체험하며 폭넓은 시각을 기를 수 있는 이번 기회를 놓치지 않기를 바랍니다.

5.3. HCX-007

5.3.1. HCX-007 결과 캡쳐 화면

5.3.2. HCX-007 결과 전문

선생님의 추천 이유
이 장소들을 선생님이 추천하는 이유
가족과 떠나는 현장 체험학습은 단순한 여행을 넘어 지역의 역사, 문화, 자연환경을 직접 경험하며 교과서 지식을 생생하게 이해할 수 있는 기회입니다. 특히 한국지리와 여행지리 교과서에서 강조하는 "지역성"과 "슬로시티 운동", "지역 축제" 개념을 현장에서 탐구한다면 더욱 의미 있는 학습이 될 것입니다.
중심 관광지
경남 하동 악양면 [슬로시티], 경상남도 하동군 악양면 악양서로 357
슬로시티는 "느리게 살기 미학을 추구하는 도시"로, 현대인의 바쁜 삶에서 벗어나 자연과 조화를 이루는 삶의 방식을 배우는 공간입니다. 교과서에서도 "슬로시티는 지역의 고유한 문화와 생태계를 보존하며 지속 가능한 발전을 추구한다"(한국지리 교과서)고 설명합니다. 악양면은 대봉감 축제, 야생차 체험, 평화로운 시골 풍경 속에서 느린 삶의 가치를 체감할 수 있습니다. 특히 대봉감은 조선 시대부터 임금님께 진상되던 특산물로, 지역 농업의 역사를 엿볼 수 있으며, 녹차 제조 과정(덖음, 유념, 발효)을 관찰하며 교과서에서 배운 식품 가공 과정을 실감 나게 학습할 수 있습니다.
주변 가족 관광지들
1. 지리산국립공원(하동), 경상남도 하동군 화개면 화개로 541-9
지리산은 우리나라 최초의 국립공원이자 금강산, 한라산과 함께 삼신산으로 불리는 영산입니다. 교과서에서 "지리산은 다양한 생태계와 문화유산을 보유한 복합 관광지"(한국지리)로 소개되며, 쌍계사, 칠불사, 불일폭포 등에서 불교 문화유산과 자연 경관을 동시에 탐방할 수 있습니다. 특히 불일암 근처의 폭포는 "지리산 10경 중 최고의 절경"으로 꼽히며, 교과서에서 강조하는 자연 경관의 교육적 가치(여행지리)를 몸소 체험하기에 적합합니다.
2. 취간림, 경상남도 하동군 악양면 정동리
조선 시대부터 이어져 온 마을 숲인 취간림은 교과서가 말하는 "전통 마을의 생태적 기능"(한국지리)을 보여주는 사례입니다. 숲 속에 설치된 위안부 피해자 추모비와 항일운동 기념탑은 역사의 현장을 직접 보며 근현대사의 아픔을 공감하는 계기가 됩니다. 또한 인근 악양천의 생태계를 관찰하며 하동의 수자원 관리 방식을 탐구할 수도 있습니다.
3. 술상 전어마을, 경상남도 하동군 진교면 술상길 186-1
매년 열리는 술상 전어축제는 교과서에서 강조하는 "지역 축제의 사회적 의미"(여행지리)를 실현하는 대표 사례입니다. "오염되지 않은 사천만과 강진만의 깨끗한 해역에서 잡힌 전어"라는 지역적 특성을 활용해 지역 경제 활성화와 문화 교류를 이끌어내는 모습은, 학생들이 "장소의 정체성"을 이해하는 데 도움을 줍니다. 축제 기간 동안 전어 잡기 체험이나 전통 어업 방식 관찰을 통해 해양 생태계의 중요성을 배울 수 있습니다.
4. 구재봉자연휴양림, 경상남도 하동군 적량면 중서길 60-81
휴양림 내 에코어드벤처와 모노레일은 교과서에서 제안하는 "산림 교육의 실천적 접근"(한국지리)과 일치합니다. 울창한 숲과 계곡을 걸으며 생물 다양성을 관찰하고, 지리산과 섬진강의 지형적 관계를 탐구할 수 있습니다. 또한 인근 야생녹차밭에서는 교과서에서 배운 농업 기술의 발달 과정을 눈으로 확인할 수 있습니다.
종합 평가
이 장소들은 단순히 "보는" 관광지가 아니라 참여하고 배우며 느끼는 체험학습의 장입니다. 슬로시티에서의 여유로운 시간, 지리산의 웅장한 자연, 역사 유적지의 깊은 이야기, 지역 축제의 활기는 교과서 속 지식을 현실 세계에 접목시킵니다. 가족과 함께라면 세대 간의 대화도 풍성해질 것이며, 이는 교과서가 강조하는 "문화적 교류를 통한 공동체 의식 함양"과도 연결됩니다. 현장 체험 후에는 반드시 탐구 보고서를 작성해 경험을 체계적으로 정리하길 권장합니다! 🌿📚

6. 후기

서비스를 구현하기 위해 다양한 NCP 서비스들을 이용해 볼 수 있는, 저에게는 다소 힘겨운 과제였습니다. 배포를 위한 서버, 포트 설정, Clova Studio API, Maps API...

이 서비스를 NCP의 서버를 통해 배포했었는데, OSRM만 메모리를 1GB 이상 사용해서 서버 비용의 부담이 있었습니다. 최소 s2-g3 서버는 사용해야하는데, 월 요금제가 82,240이었죠. 들어오는 수익도 없이 계속 이용 가능하게 서버에서 배포하기에는 부담이 너무 커서, 기존의 서버를 중단했습니다. 그러고는 기존에 썼던 Micro-g3 Server에서 경로 최적화는 구현하지 않은 채로 서비스를 제공하고 있습니다.

Micro-g3의 경우 네이버 클라우드 플랫폼 체험용 서버이며, 결제 정보 최초 등록 월부터 1년간 무료로 사용할 수 있습니다. 메모리 1GB 성능에, 기본 디스크도 10GB를 주니까, 클라우드 서비스를 한글 설명으로 처음 이용해보고자 하는 분들에게는 Naver Cloud가 좋은 선택이 될 것 같습니다.
NCP Micro-g3 server 구경가기

애초에 OSRM 같은 것을 사용하지 않게 Naver Maps API에서 이런 기능도 지원해줬으면 좋겠다고 생각했습니다. NaverMapsAPI를 사용하는 다양한 사례가 사례 페이지에 나와있는데요. 제가 말한 기능은 안 보이더라구요. 제가 못 찾는 것일지도 모르니 혹시 아시는 분은 댓글로 알려주시길 부탁드립니다.

그리고 이 기능은 특히 네이버 지도앱에서도 기능을 구현해주면 좋겠더라구요. 저 같은 길치에겐 어떤 순서대로 장소들을 방문해야 하는지 짜는 것도 머리가 아프니까요.

언젠가 구현해주겠죠??

여기까지 프롬프톤이지만 프롬프톤이 아니었던... 12팀 중 10팀이 개발자면서 심지어 '우아한 형제들 백엔드 개발자'도 있었던, 2025 관광 프롬프톤에 참여하여 수상한 '현장체험학습 플래너' 서비스의 재구성 삽질기였습니다.