1sdv/TripStar

TripStar – AI 기반 여행 계획 어시스턴트

기능 소개

• TripStar는 사용자가 지정한 여행(도시, 날짜, 선호도)에 대한 완전한 여행 일정을 구축하는 웹 애플리케이션입니다. 실제 소스(샤오홍슈 여행 게시물, 날씨 서비스, 호텔 목록, 지도 API)에서 데이터를 가져오고 대규모 언어 모델(LLM)과 전문 에이전트 세트를 사용하여 원시 데이터를 구조화된 여행 계획으로 변환합니다.

작동 방식

1. 프론트엔드(Vue 3) – 양식을 통해 사용자는 목적지, 여행 날짜, 개인 선호도(교통 수단, 숙박 스타일, 관심사 등)를 입력할 수 있습니다. UI는 WebSocket 업데이트를 통해 진행 상황을 표시하며, 계획이 준비되면 다음을 표시합니다:
   • 명소, 이동 경로, 호텔 추천, 식사, 날씨 예보가 포함된 일별 일정.
   • 예산 내역(입장권, 식비, 교통비, 숙박비).
   • 지점 간 경로가 그려진 대화형 지도(해외는 Google Maps, 중국은 AMap).
   • 일정의 지식 그래프 시각화.
   • 전체 일정을 컨텍스트로 사용하여 후속 질문에 답변할 수 있는 플로팅 AI 채팅 창.
2. 백엔드(FastAPI, Python 3.10+) – /api/trip/plan 요청은 비동기 작업을 시작하고 task_id를 반환합니다. 백그라운드 작업자가 멀티 에이전트 워크플로우를 실행합니다:
   • 샤오홍슈 에이전트는 샤오홍슈(중국 소셜 플랫폼)에서 여행 게시물을 검색하고 콘텐츠를 스크래핑한 후 LLM에 명소 목록, 각 명소의 일반적인 방문 시간, 사전 예약 필요 여부를 JSON으로 추출하도록 요청합니다.
   • 날씨 에이전트는 Google 또는 AMap 날씨 API를 통해 예보 데이터를 가져옵니다.
   • 호텔 에이전트는 예산과 스타일에 맞는 호텔을 POI 서비스에 쿼리합니다.
   • 플래너 에이전트는 모든 요소를 결합하고 최적의 경로(되돌아가기 방지)를 구축한 후 LLM에 엄격한 JSON 형식으로 상세 일정과 예산을 출력하도록 요청합니다.
   • 결과는 파싱, 정리되어 지식 그래프 서비스에 공급되어 도시, 날짜, 명소, 비용에 대한 노드/엣지를 생성합니다.
3. 데이터 강화 – 일정이 생성된 후 프론트엔드는 각 명소의 사진을 요청합니다. 백엔드는 다시 샤오홍슈를 호출하여 최근 게시물에서 첫 번째 이미지를 가져오고 직접 URL을 반환하므로 UI에 실제 사진이 표시됩니다.

주요 기술 하이라이트

• 멀티 에이전트 아키텍처는 HelloAgents 프레임워크를 기반으로 구축되었으며 명확한 역할 분리(명소 추출, 날씨, 호텔, 경로)가 있습니다.
• LLM 기반 추출: 길고 비구조화된 여행 노트는 모델에 프롬프트를 보내 깔끔한 JSON으로 정제됩니다.
• 듀얼 맵 엔진: 지오코딩, 경로, 지도 렌더링을 위해 Google Maps(중국 외)와 AMap(중국 내) 간 자동 폴백.
• 비동기 작업 큐 + WebSocket 진행 상황 업데이트로 긴 LLM 호출 중 504 게이트웨이 시간 초과를 방지합니다.
• 국제화: UI와 LLM 프롬프트는 중국어, 영어, 일본어를 지원하며 생성된 일정은 자동 번역됩니다.
• 예산 패널 및 지식 그래프 시각화는 사용자에게 재정 개요와 여행의 네트워크 뷰를 제공합니다.
• Docker-compose 배포로 LLM API 키, 지도 서비스 키, 샤오홍슈 쿠키를 환경 변수로 구성할 수 있습니다.

사용 대상

• 여러 사이트를 수동으로 탐색하지 않고 개인화된 종단 간 일정을 원하는 여행자.
• 웹 스크래핑, 구조화된 데이터 추출, 실시간 UI 업데이트를 결합한 멀티 에이전트 LLM 애플리케이션 구축에 관심이 있는 개발자.

시작하기

1. Python 3.10+, Node 18+, Docker(선택 사항)를 설치합니다.
2. OpenAI 호환 LLM, Google Maps, AMap용 API 키와 로그인된 샤오홍슈 쿠키를 제공합니다.
3. 백엔드(uvicorn app.api.main:app)와 Vue 프론트엔드(npm run dev)를 실행하거나 docker-compose up으로 둘 다 시작합니다.
4. 웹 UI를 열고 여행 세부 정보를 입력한 후 시스템이 완전한 계획을 생성하는 것을 확인합니다.

---

결론: TripStar는 원시 여행 데이터를 지도, 사진, 대화형 AI 어시스턴트가 포함된 세련되고 예산 인식 일정으로 변환하는 풀스택 멀티 에이전트 AI 시스템입니다.