TRAVEL-Planner

多代理旅游与酒店系统

一个生产级的多智能体人工智能系统，可以计划、预订、管理和支持复杂的旅行路线——从最初的计划到主动的旅行支持再到旅行后的维护。

建筑

• 13个专业人工智能代理 （关系经理、合成器、物流、住宿、游览、预算、安全、地点情报、礼宾、实时重新路由、紧急情况、反馈/索赔、个人资料）
• 14台MCP工具服务器 （航班、住宿、航线、天气、货币、安全、地点、通知、航班状态、紧急情况、支付、消息、个人资料、RAG）
• RAG知识库 （ChromaDB，9个集合，OpenAI嵌入，Pahalgam领域知识预种子）
• Redis流 用于实时代理间通信的事件总线
• PostgreSQL 国营商店（Prisma ORM）
• Next.js 带有行程计划器、代理活动提要、行程视图的前端

快速开始

1.复制环境文件并启动Docker服务

cp .env.example .env
# Fill in API keys (system works without them in mock mode)
# Required for full functionality: ANTHROPIC_API_KEY

如果你更喜欢在Docker容器中而不是本地运行PostgreSQL、Redis和ChromaDB，现在就启动它们：

pnpm docker:up
# You can tear them down later with: pnpm docker:down

2.设置PostgreSQL数据库

该系统需要一个PostgreSQL数据库来存储状态（行程、分段、费用等）。 确保PostgreSQL在本地或远程运行，然后： \\\`bash

1.更新.env文件中的DATABASE_URL

2.运行初始Prisma迁移：

pnpm-db：迁移

3.生成Prisma客户端：

pnpm-db：生成

4.种子演示数据：

pnpm-db：种子 \\\`

3.安装依赖项

\\\bash pnpm 安装 \\\

3.构建所有包

pnpm build

4.种子RAG知识库（Python）

cd packages/rag-pipeline
pip install -r requirements.txt
python3 src/ingest.py --seed

5.运行CLI演示

pnpm cli
# Then type: "Plan a honeymoon trip to Pahalgam, Kashmir for 2 people, June 15-22, INR 150,000 budget"

6.运行验收测试

pnpm acceptance
# Requires ANTHROPIC_API_KEY for LLM-dependent tests

7.启动前端

pnpm --filter @travel/frontend dev
# Visit http://localhost:3000

包结构

packages/
  shared/              — TypeScript types, schemas, event bus, utilities
  orchestrator/        — 13 agent characters, Synthesizer, RM, CLI
  mcp-flights/         — Flight search (Amadeus + Duffel)
  mcp-accommodation/   — Hotel search (Booking.com + Google Hotels)
  mcp-routing/         — Directions + places (Google Maps)
  mcp-weather/         — Forecasts (OpenWeatherMap + Visual Crossing)
  mcp-currency/        — FX rates (Open Exchange Rates + Wise)
  mcp-safety/          — Travel advisories + hospitals
  mcp-places/          — Restaurants + attractions (Google + Foursquare)
  mcp-notifications/   — Push + SMS + email + WhatsApp (Twilio, SendGrid)
  mcp-flight-status/   — Real-time flight tracking (FlightAware)
  mcp-emergency/       — Crisis response (embassies, emergency numbers)
  mcp-payments/        — Payments + receipt scanning (Stripe, Mindee)
  mcp-messaging/       — WhatsApp + Telegram ingress
  mcp-profile/         — Traveler profile CRUD
  mcp-rag/             — RAG retrieval MCP bridge
  rag-pipeline/        — Python: ChromaDB setup, ingestion, FastAPI retrieval
  scheduler/           — node-cron workflows (pre-flight, briefing, scans)
  webhook-ingress/     — Express webhook receiver (FlightAware, Stripe, etc.)
  frontend/            — Next.js trip planner + active trip dashboard

测试用例

该系统已针对以下验收场景进行了验证：

{
  "destination": "Pahalgam, Jammu & Kashmir, India",
  "dates": { "start": "2026-06-15", "end": "2026-06-22" },
  "budget": { "amount": 150000, "currency": "INR" },
  "party_size": 2,
  "purpose": "honeymoon",
  "preferences": {
    "accommodation_style": "boutique",
    "activity_level": "moderate",
    "dietary": "vegetarian",
    "must_include": ["Betaab Valley", "shikara ride"],
    "avoid": ["overcrowded spots"]
  }
}

扩展测试场景（均在中验证 pnpm acceptance):

1. T-24小时飞行延迟注射→ 重新安排火灾路线✅
2. 第2天上午简报触发→ 每日推送✅
3. 礼宾部使用GPS“查找附近的素食餐厅”✅
4. Chandanwari的医疗紧急情况→ 医院路线+联系方式✅
5. 旅行后反馈收集→ RAG摄入✅
6. 护照到期扫描→ 如果在6个月内发出警报✅

API成本估算（测试阶段）