1sdv/TripStar

TripStar – AI 搭載の旅行計画アシスタント

機能概要

• TripStar は、ユーザーが指定した旅行（都市、日付、好み）の完全な旅程を構築する Web アプリケーションです。実世界のソース（小紅書の旅行投稿、天気サービス、ホテルリスト、地図 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 キー、地図サービスキー、小紅書クッキーの環境変数設定が可能。

対象ユーザー

• 複数のサイトを手動で閲覧せずに、パーソナライズされたエンドツーエンドの旅程を希望する旅行者。
• Web スクレイピング、構造化データ抽出、リアルタイム 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. Web UI を開き、旅行の詳細を入力し、システムが完全な計画を生成するのを確認します。

---

結論：TripStar は、生の旅行データを、地図、写真、インタラクティブな AI アシスタントを備えた、洗練された予算対応の旅程に変換するフルスタックのマルチエージェント AI システムです。