diff --git a/02-use-cases/travel_planner/README.md b/02-use-cases/travel_planner/README.md deleted file mode 100644 index 141659fc..00000000 --- a/02-use-cases/travel_planner/README.md +++ /dev/null @@ -1,295 +0,0 @@ -# 智能旅行助手 - -## 概述 - -这是一个基于火山引擎VeADK&AgentKit构建的智能旅行规划智能体。本智能体集成第三方 MCP（高德）服务以获取 LBS 地理位置信息并规划行程路线；内置由 VikingDB 构建的知识库，可提供通用旅行安全建议及小众景点推荐；接入 Web Search 基础联网搜索工具，增强智能体实时信息搜索能力；通过记忆库记录用户偏好，为用户提供个性化服务体验。 - -## 核心功能 - -本项目提供以下核心功能： - -- 行程规划：调用三方MCP Tool(高德) 生成详细行程安排，包括交通、餐饮、住宿推荐及景点游览。 -- 实时信息查询：调用web search联网搜索，查询实时信息（如天气、景点开发时段、票务预订），确保用户行程顺利。 -- 旅行知识库：内置旅行相关的知识库，提供小众景点推荐及实用旅行建议。 -- 个性化推荐：基于记忆库记录的用户历史偏好和旅行习惯，为用户提供个性化推荐。 - -## Agent 能力 - -![Travel Planner Agent with AgentKit Runtime](img/arch.jpg) - -```text -用户消息 - ↓ -AgentKit 运行时 - ↓ -旅行助手智能体 - ├── 旅行知识库 - ├── 长期记忆库 - ├── MCP Tool（高德） - └── web search 工具 -``` - -主要的火山引擎产品或 Agent 组件： - -- 方舟大模型： - - deepseek-v3-2-251201 -- VikingDB 知识库 -- VikingDB 记忆库 -- TOS 存储服务 -- Web Search 联网搜索 -- AgentKit -- Identity -- APMPlus - -## 目录结构说明 - -```bash -├── README.md # 项目说明 -├── __init__.py # 初始化文件 -├── agent.py # Agent应用入口 -├── client.py # Agent客户端 -├── knowledgebase_docs # 知识库文档 -│ ├── tourists_recommend.md -│ └── general_safety_guide.md -└── requirements.txt # 依赖包列表 -``` - -## 本地运行 - -### 前置准备 - -**Python版本：** - -- Python 3.12 或更高版本 - -**1. 开通火山方舟模型服务：** - -- 访问 [火山方舟控制台](https://exp.volcengine.com/ark?mode=chat) -- 开通模型服务 - -**2. 获取火山引擎访问凭证：** - -- 参考 [用户指南](https://www.volcengine.com/docs/6291/65568?lang=zh) 获取 AK/SK - -**3. 获取高德 MCP 服务访问凭证：** - -- 注册并登录 [高德开放平台](https://lbs.amap.com/) -- 参考 [创建应用并获取 Key](https://amap.apifox.cn/doc-537183) 获取高德MCP服务的 Key，在后续环境变量 `GAODE_MCP_API_KEY`中填入该 Key。 - -> 注意：绑定的服务为“web服务API” - -**4. 获取 VikingDB 知识库名称：** - -> 您只需创建一个知识库，在环境变量 `DATABASE_VIKING_COLLECTION`中填入该知识库名称，智能体会自动将知识库文档导入至您的知识库中。 -> 知识库文档位于knowledgebase_docs/目录下。 - -- 访问 [VikingDB 知识库控制台](https://console.volcengine.com/vikingdb/knowledge) -- 如需新建知识库，参考[创建指南](https://www.volcengine.com/docs/84313/1254463) 完成知识库创建，获取知识库名称 -- 如需复用已有知识库，参考[查看指南](https://www.volcengine.com/docs/84313/1254468) 获取知识库名称 - -**5. 获取 VikingDB 记忆库名称：** - -> 您只需创建一个记忆库，在环境变量 `DATABASE_VIKINGMEM_COLLECTION`中填入该记忆库名称，记忆数据由智能体自动写入。 - -- 访问 [VikingDB 记忆库控制台](https://console.volcengine.com/vikingdb/memory) -- 如需新建记忆库，参考[创建指南](https://www.volcengine.com/docs/84313/1817506) 完成记忆库创建，获取记忆库名称 -- 如需复用已有记忆库，参考[查看指南](https://www.volcengine.com/docs/84313/1827249) 获取记忆库名称 - -### 依赖安装 - -#### 1. 安装 uv 包管理器 - -```bash -# macOS / Linux（官方安装脚本） -curl -LsSf https://astral.sh/uv/install.sh | sh - -# 或使用 Homebrew（macOS） -brew install uv -``` - -#### 2. 初始化项目依赖 - -```bash -# 进入项目目录 -cd 02-use-cases/travel_planner -``` - -您可以通过 `pip` 工具来安装本项目依赖： - -```bash -pip install -r requirements.txt -``` - -或者使用 `uv` 工具来安装本项目依赖(推荐)： - -```bash -# 如果没有 `uv` 虚拟环境，可以使用命令先创建一个虚拟环境 -uv venv --python 3.12 - -# 使用 `pyproject.toml` 管理依赖 -uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple - -# 使用 `requirements.txt` 管理依赖 -uv pip install -r requirements.txt - -# 激活虚拟环境 -source .venv/bin/activate -``` - -### 环境准备 - -设置以下环境变量: - -```bash -# 火山方舟模型名称 (可选，默认使用 deepseek-v3-2-251201) -export MODEL_AGENT_NAME= - -# 火山引擎访问凭证（必需） -export VOLCENGINE_ACCESS_KEY= -export VOLCENGINE_SECRET_KEY= - -# 高德MCP服务访问凭证（必需） -export GAODE_MCP_API_KEY= - -# 火山VikingDB知识库名称（必需） -export DATABASE_VIKING_COLLECTION= - -# 火山VikingDB记忆库名称（必需） -export DATABASE_VIKINGMEM_COLLECTION= - -# TOS桶名称（必需，知识库初始化时使用） -export DATABASE_TOS_BUCKET= -export DATABASE_TOS_REGION= -``` - -### 调试方法 - -使用 `veadk web` 进行本地调试: - -```bash -# 进入 02-use-cases 目录 -cd agentkit-samples/02-use-cases - -# 启动 VeADK Web 界面 -veadk web --port 8080 - -# 在浏览器访问：http://127.0.0.1:8080 -``` - -Web 界面提供图形化对话测试环境，支持实时查看消息流和调试信息。 - -### 示例提示词 - -```text -寒假去三亚旅行 5 天，想避开人挤人的热门海滩，同时体验蜈支洲岛的水上项目和南山文化旅游区的祈福活动，帮我规划行程 -清明假期去杭州旅行 3 天，除了西湖、灵隐寺这些必去景点，还想加 1 天西溪国家湿地公园的徒步，，该怎么规划每日行程才不赶？ -五一假期去成都玩 3 天，想打卡宽窄巷子、大熊猫繁育研究基地，还想安排 1 天周边游（比如都江堰或青城山），行程该怎么合理分配？ -重阳节带父母去北京旅行 6 天，想参观故宫、天坛等适合长辈的文化景点，还想安排颐和园的休闲漫步，如何规划节奏舒缓的行程？ -元旦去哈尔滨旅行，帮我规划下5天4晚的行程，既能兼顾冰雪大世界、中央大街等热门景点，又能体验东北特色美食 -``` - -### 效果展示 - -![Travel Planner VeADK Demo](img/veadk_snapshot.png) - -## AgentKit 部署 - -### 前置准备 - -**重要提示**：在运行本示例之前，请先访问 [AgentKit 控制台授权页面](https://console.volcengine.com/agentkit/region:agentkit+cn-beijing/auth?projectName=default) 对所有依赖服务进行授权，确保案例能够正常执行。 - -参考 本地运行 部分的 前置准备。 - -### 依赖安装 - -> 如果您本地已经安装了该依赖，跳过此步骤。 - -使用 `pip` 安装 AgentKit 命令行工具： - -```bash -pip install agentkit-sdk-python==0.3.2 -``` - -或者使用 `uv` 安装 AgentKit 命令行工具： - -```bash -uv pip install agentkit-sdk-python==0.3.2 -``` - -### 设置环境变量 - -```bash -# 火山引擎访问凭证（必需） -export VOLCENGINE_ACCESS_KEY= -export VOLCENGINE_SECRET_KEY= -``` - -### AgentKit 云上部署 - -```bash -# 1. 进入项目目录 -cd 02-use-cases/travel_planner - -# 2. 配置 Agentkit 部署配置 -agentkit config \ ---agent_name travel_planner_advanced \ ---entry_point 'agent.py' \ ---launch_type cloud - -# 3. 配置 AgentKit Runtime 环境变量（应用级） -# 以下环境变量均为必填项，参考 前置准备 部分获取相应的值 -agentkit config \ --e GAODE_MCP_API_KEY= \ --e DATABASE_VIKING_COLLECTION= \ --e DATABASE_VIKINGMEM_COLLECTION= \ --e DATABASE_TOS_BUCKET= \ --e DATABASE_TOS_REGION= - -# 4. 启动云端服务 -agentkit launch - -# 5. 测试部署的 Agent -agentkit invoke "你好" - -``` - -### 测试已部署的智能体 - -在AgentKit控制台 智能体运行时 页面找到已部署的智能体 `travel_planner_advanced`，点击在线测评，输入提示词进行测试。 -![AgentKit Runtime Invoke](img/agentkit_test.png) - -或者使用 client.py 连接云端服务进行测试： - -```bash -# 需要编辑 client.py，将其中的第 15 行和第 16 行的 base_url 和 api_key 修改为 agentkit.yaml 中生成的 runtime_endpoint 和 runtime_apikey 字段 -python client.py -``` - -## 示例提示词 - -```text -寒假去三亚旅行 5 天，想避开人挤人的热门海滩，同时体验蜈支洲岛的水上项目和南山文化旅游区的祈福活动，帮我规划行程 -清明假期去杭州旅行 3 天，除了西湖、灵隐寺这些必去景点，还想加 1 天西溪国家湿地公园的徒步，，该怎么规划每日行程才不赶？ -五一假期去成都玩 3 天，想打卡宽窄巷子、大熊猫繁育研究基地，还想安排 1 天周边游（比如都江堰或青城山），行程该怎么合理分配？ -重阳节带父母去北京旅行 6 天，想参观故宫、天坛等适合长辈的文化景点，还想安排颐和园的休闲漫步，如何规划节奏舒缓的行程？ -我计划去哈尔滨旅行，帮我规划下5天4晚的行程，既能兼顾冰雪大世界、中央大街等热门景点，又能体验东北特色美食 -``` - -## 效果展示 - -![Travel Planner AgentKit Demo Result 1](img/agentkit_demo01.png) -![Travel Planner AgentKit Demo Result 2](img/agentkit_demo02.png) - -## 常见问题 - -无 - -## 参考资料 - -- [VeADK 官方文档](https://volcengine.github.io/veadk-python/) -- [AgentKit 开发指南](https://volcengine.github.io/agentkit-sdk-python/) -- [火山方舟模型服务](https://console.volcengine.com/ark/region:ark+cn-beijing/overview?briefPage=0&briefType=introduce&type=new&projectName=default) - -## 代码许可 - -本工程遵循 Apache 2.0 License diff --git a/02-use-cases/travel_planner/__init__.py b/02-use-cases/travel_planner/__init__.py deleted file mode 100644 index e69de29b..00000000 diff --git a/02-use-cases/travel_planner/agent.py b/02-use-cases/travel_planner/agent.py deleted file mode 100644 index 64a84baf..00000000 --- a/02-use-cases/travel_planner/agent.py +++ /dev/null @@ -1,187 +0,0 @@ -# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -import logging -import os -import sys -from pathlib import Path - -from agentkit.apps import AgentkitAgentServerApp -from google.adk.tools.mcp_tool.mcp_toolset import ( - MCPToolset, - StreamableHTTPConnectionParams, -) - -from veadk import Agent -from veadk.knowledgebase.knowledgebase import KnowledgeBase -from veadk.memory.long_term_memory import LongTermMemory -from veadk.memory.short_term_memory import ShortTermMemory -from veadk.tools.builtin_tools.web_search import web_search - -# 当前目录 -sys.path.append(str(Path(__file__).resolve().parent)) -# 上层目录 -sys.path.append(str(Path(__file__).resolve().parent.parent)) - -logging.basicConfig(level=logging.INFO) -logger = logging.getLogger(__name__) - -app_name = "travel_planner_app" - -# 1. 配置短期记忆 -short_term_memory = ShortTermMemory(backend="local") - -# 2. 配置知识库： Viking 向量数据库 -knowledge_collection_name = os.getenv("DATABASE_VIKING_COLLECTION", "") -if knowledge_collection_name != "": - # 使用用户指定的知识库 - knowledge = KnowledgeBase(backend="viking", index=knowledge_collection_name) -else: - raise ValueError("DATABASE_VIKING_COLLECTION environment variable is not set") -# 依赖tos桶加载知识库内容 -tos_bucket_name = os.getenv("DATABASE_TOS_BUCKET", "") -tos_region = os.getenv("DATABASE_TOS_REGION", "") -if tos_bucket_name == "" or tos_region == "": - raise ValueError("DATABASE_TOS_BUCKET environment variable is not set") -# 从预构建目录加载知识库 -try: - success = knowledge.add_from_directory( - str(Path(__file__).resolve().parent) + "/knowledgebase_docs", - tos_bucket_name=tos_bucket_name, - ) - if success: - logger.info("Knowledgebase loaded successfully.") - else: - logger.info("Failed to load knowledgebase.") -except Exception as e: - logger.error(f"Failed to load knowledgebase: {e}") - -# 3. 配置长期记忆： Viking 向量数据库 -memory_collection_name = os.getenv("DATABASE_VIKINGMEM_COLLECTION", "") -if memory_collection_name != "": - # 使用用户指定的长期记忆库 - long_term_memory = LongTermMemory( - backend="viking", - top_k=3, - index=memory_collection_name, - ) -else: - raise ValueError("DATABASE_VIKINGMEM_COLLECTION environment variable is not set") - - -# 4. 配置 Gaode MCP Server -gaode_mcp_api_key = os.getenv("GAODE_MCP_API_KEY", "") - -if gaode_mcp_api_key == "": - raise ValueError("GAODE_MCP_API_KEY environment variable is not set") - -url = "https://mcp.amap.com/mcp?key={}".format(os.getenv("GAODE_MCP_API_KEY")) -amap_tool = MCPToolset( - connection_params=StreamableHTTPConnectionParams( - timeout=30, - url=url, - # headers={"Authorization": f"Bearer {apikey}"} - ), -) - -# 5. 配置智能体 -travel_planner_prompt = """ - 你是一个基于高级规划与反应（Plan-ReAct）架构的智能体，能够动态规划和执行复杂任务，灵活调用工具，并根据环境反馈调整策略。 - 你的任务是根据用户的需求，制定详细的旅行计划，推荐景点、美食、住宿，并提供实时的交通和天气信息。 - - ## 工具使用规范与优先级 - 你拥有以下工具，请按此策略调用： - 1. **知识库 (knowledgebase)**：你的知识库包含了通用旅行安全建议，以及小众景点推荐。处理用户问题时，必须先检索知识库。 - 2. **记忆库 (long_term_memory)**：在对话开始时，自动读取用户档案；在对话结束时，如有新偏好，询问用户后存入记忆。 - 3. **LBS地理信息服务 (amap_tool)**：**所有**涉及地理位置、路线、距离、实时交通、周边搜索的需求，**必须首先调用此工具**。这是位置信息的权威来源。 - 4. **联网搜索 (web_search)**：当需要查询**最新、实时**信息时调用此工具（如近期活动、临时闭馆通知、网红新店、最新攻略）。历史或常识性知识优先使用自身知识。 - - ## 工作流程 - 1. 检索知识库，获取相关旅行建议和小众景点推荐。 - 2. 读取长期记忆，了解用户偏好（如预算、兴趣、过敏等）。 - 3. 使用amap_tool搜索规划旅行行程、途径景点、美食推荐、酒店推荐。 - 4. 使用web_search搜索步骤3中推荐酒店的以下信息，且**必须返回搜索的酒店预订链接**： - - 实时价格 - - 用户评分 - - 可用优惠 - - 搜索该酒店的预订链接，如：艺龙旅行网（https://www.elong.com/）、去哪儿网（https://www.qunar.com/）、携程（https://www.ctrip.com/）、飞猪酒店（https://www.fliggy.com/?tab=hotel） - 5. 使用web_search获取实时信息，包括景点闭馆通知、网红新店、近期活动等。 - 6. 将以上信息进行整合，输出完整行程规划，其中每日行程**必须**包含以下几大部分：**上午**、**午餐**、**下午**、**晚餐**、**晚上**、**当日酒店**（并且餐馆和酒店都必须提供具体名称和评价情况，不可以模糊推荐），示例格式如下： - ``` - 第1天：抵达哈尔滨 + 中央大街初体验 - 上午：抵达哈尔滨，入住中央大街附近酒店 - 午餐：午餐：张包铺 - 排骨包子老字号 - 人均：20-30元 - 特色：现包现蒸，一咬爆汁 - 下午：漫步中央大街，欣赏百年欧式建筑 - 必尝：马迭尔冰棍（原味奶香最经典） - 推荐：秋林红肠、冰糖葫芦 - 晚餐：老厨家(中央大街店) - 锅包肉发源地 - 人均：60元 - 特色：琥珀色锅包肉、蓝莓酱配搭 - 晚上：欣赏中央大街夜景，灯光下的欧式建筑别具风情 - 当日酒店：哈尔滨中央大街智选假日酒店 - 评分：8.6/10（33条点评） - 价格：约450-600元/晚（双人间，约US$63.79起） - 优势：国际连锁品牌，早餐丰富，位置优越 - 预订链接：去哪儿网（https://www.qunar.com/）、携程（https://www.ctrip.com/） - -第2天：冰雪大世界 + 俄式西餐 - 上午：酒店早餐后前往哈尔滨冰雪大世界 - 开放时间：10:00-21:30（20:30停止售票） - 建议：下午3点前入园，一次看遍日光晶莹与灯光璀璨 - 必玩：超级冰滑梯、雪花摩天轮 - 午餐：景区内简餐或返回市区 - 下午：继续游览冰雪大世界，体验冰雪项目 - 晚餐：华梅西餐厅（百年俄式西餐） - 人均：60-80元 - 必点：罐焖牛肉、红菜汤、大列巴配果酱 - 晚上：可选择观看冰雪大世界夜间演出 - 当日酒店：汉庭酒店(哈尔滨松北万象汇冰雪大世界店) - 评分：4.8/5（718条点评） - 价格：约300-450元/晚（双人间） - 优势：距冰雪大世界近，地铁2号线世茂大道站旁，免费早餐 - 预订链接：携程携程（https://www.ctrip.com/） / 去哪儿（https://www.qunar.com/）搜索"汉庭酒店哈尔滨松北万象汇冰雪大世界店" - - ``` - 7. 在对话结束时，询问用户是否保存新的偏好到长期记忆。如果用户同意，保存新的偏好到长期记忆。 - 8. 始终遵循核心行为准则，确保输出内容专业、可靠、安全。 - - ## 核心行为准则 - 1. **主动全面**：除非用户明确指定，否则规划应涵盖景点、餐饮、交通、住宿、贴士等全要素。 - 2. **安全可靠**：所有地理位置信息（如景点、酒店）必须通过高德地图工具amap_tool验证。涉及安全（如天气预警、交通管制）必须明确提醒。 - 3. **诚实透明**：如果信息不确定或工具未返回结果，如实告知用户，不要编造。 - 4. **记忆与个性**：积极利用记忆工具，记住用户的关键偏好（如预算、喜好、厌恶），使推荐越用越懂。 - 5. **沟通要求**： 禁止直接将 工具的结果直接输出给用户，你需要结合用户的问题，进行必要的润色，使回复内容更加的清晰、准确、简洁。 -""" -# 支持用户在runtime修改模型 -model_name = os.getenv("MODEL_AGENT_NAME", "deepseek-v3-2-251201") -agent = Agent( - name="travel_planner_advanced", - model_name=model_name, - instruction=travel_planner_prompt, - tools=[amap_tool, web_search], - long_term_memory=long_term_memory, - knowledgebase=knowledge, -) - -root_agent = agent - -agent_server_app = AgentkitAgentServerApp( - agent=agent, - short_term_memory=short_term_memory, -) - -if __name__ == "__main__": - logger.info("Starting Travel Planner Agent Server...") - agent_server_app.run(host="0.0.0.0", port=8000) diff --git a/02-use-cases/travel_planner/client.py b/02-use-cases/travel_planner/client.py deleted file mode 100644 index 19124eeb..00000000 --- a/02-use-cases/travel_planner/client.py +++ /dev/null @@ -1,70 +0,0 @@ -import requests -import httpx -import random - -from google.adk.cli.adk_web_server import CreateSessionRequest, RunAgentRequest -from google.genai.types import Content, Part -import asyncio - - -if __name__ == "__main__": - # Step 0: setup running configs - app_name = "travel_planner_advanced" - user_id = "agentkit_user" - session_id = "agentkit_sample_session" - base_url = "http://127.0.0.1:8000" - api_key = "test key" - - task_num = 1 - - # Step 1: create a session - def create_session(): - create_session_request = CreateSessionRequest( - session_id=session_id + f"_{random.randint(1, 9999)}", - ) - - response = requests.post( - url=f"{base_url}/apps/{app_name}/users/{user_id}/sessions/{create_session_request.session_id}", - headers={"Authorization": f"Bearer {api_key}"}, - ) - - print(f"[create session] Response from server: {response.json()}") - - return create_session_request.session_id - - # Step 2: run agent with SSE - run_agent_request = RunAgentRequest( - app_name=app_name, - user_id=user_id, - session_id=create_session(), - new_message=Content(parts=[Part(text="北京到上海的自驾路线规划")], role="user"), - stream=True, - ) - - print("[run agent] Event from server:") - - # 3. Handle streaming events - async def send_request(message: str): - run_agent_request = RunAgentRequest( - app_name=app_name, - user_id=user_id, - session_id=create_session(), - new_message=Content(parts=[Part(text=message)], role="user"), - stream=True, - ) - - with httpx.stream( - "POST", - f"{base_url}/run_sse", - json=run_agent_request.model_dump(exclude_none=True), - timeout=120, - headers={"Authorization": f"Bearer {api_key}"}, - ) as r: - for line in r.iter_lines(): - print(line) - - async def send_request_parallel(): - tasks = [send_request("查询北京到上海的自驾路线规划") for _ in range(task_num)] - await asyncio.gather(*tasks) - - asyncio.run(send_request_parallel()) diff --git a/02-use-cases/travel_planner/img/agentkit_demo01.png b/02-use-cases/travel_planner/img/agentkit_demo01.png deleted file mode 100644 index 99e1e3bf..00000000 Binary files a/02-use-cases/travel_planner/img/agentkit_demo01.png and /dev/null differ diff --git a/02-use-cases/travel_planner/img/agentkit_demo02.png b/02-use-cases/travel_planner/img/agentkit_demo02.png deleted file mode 100644 index fa908b15..00000000 Binary files a/02-use-cases/travel_planner/img/agentkit_demo02.png and /dev/null differ diff --git a/02-use-cases/travel_planner/img/agentkit_test.png b/02-use-cases/travel_planner/img/agentkit_test.png deleted file mode 100644 index 5758a40b..00000000 Binary files a/02-use-cases/travel_planner/img/agentkit_test.png and /dev/null differ diff --git a/02-use-cases/travel_planner/img/arch.jpg b/02-use-cases/travel_planner/img/arch.jpg deleted file mode 100644 index 905684fa..00000000 Binary files a/02-use-cases/travel_planner/img/arch.jpg and /dev/null differ diff --git a/02-use-cases/travel_planner/img/veadk_snapshot.png b/02-use-cases/travel_planner/img/veadk_snapshot.png deleted file mode 100644 index 6bfab1b4..00000000 Binary files a/02-use-cases/travel_planner/img/veadk_snapshot.png and /dev/null differ diff --git a/02-use-cases/travel_planner/knowledgebase_docs/general_safety_guide.md b/02-use-cases/travel_planner/knowledgebase_docs/general_safety_guide.md deleted file mode 100644 index 0549b47a..00000000 --- a/02-use-cases/travel_planner/knowledgebase_docs/general_safety_guide.md +++ /dev/null @@ -1,31 +0,0 @@ -以下是国内和国际旅行的注意事项 - -# 国内与国际旅行安全注意事项 - -## 一、 旅行安全通用注意事项 - -### 1. 证件与财物安全 - -- **证件保管**：护照、签证、身份证、信用卡等重要证件务必随身携带并妥善保管。建议提前将上述证件复印或拍照备份，一份留在家中，一份随身携带，并与原件分开放置。 -- **财物保管**：尽量避免携带大量现金，贵重物品不要放在托运行李中或外衣口袋。在转机、转车或人群拥挤处需特别注意清点行李，防止遗失。 - -### 2. 人身安全与交通安全 - -- **人身安全**：尊重当地风俗习惯与宗教信仰，避免前往未开发或缺乏安全保障的区域。谨慎接受陌生人的搭讪或馈赠的食品饮料。 -- **交通安全**：乘坐交通工具时系好安全带。水上活动务必穿戴救生衣。若在国外租车自驾，应提前熟悉当地交通规则与路况，避免疲劳驾驶和超速行驶。 - -### 3. 饮食与住宿安全 - -- **饮食安全**：选择卫生条件良好的餐厅就餐，避免光顾无证照摊贩。注意饮食卫生，饭前便后洗手，不喝生水，不生食不洁食物。牢记个人饮食禁忌。 -- **住宿安全**：进出酒店房间应随时关门锁门，熟悉酒店安全通道和紧急出口位置。不要让陌生人进入房间，接到不明电话应立即挂断。 - -### 4. 游览与购物安全 - -- **游览安全**：服从导游或领队安排，紧跟团队，避免擅自脱团。在拍照、摄像时注意周边环境与安全警示标志。慎重参加高风险旅游项目。 -- **购物安全**：购物时保管好随身物品，不到人多拥挤的地方。试衣试鞋时请同伴陪同看管物品。付款时不要当众清点大量现金。 - -## 二、 国际旅行特别注意事项 - -- **行前准备**：出行前通过中国领事服务网、驻目的地国使领馆官网等渠道了解当地安全形势、法律法规、出入境要求及文化禁忌。建议购买国际旅行保险。 -- **防范电信诈骗**：警惕冒充使领馆或国内公检法机关的诈骗电话。不轻信任何涉及转账汇款的不明来电、短信或邮件。 -- **紧急情况应对**：掌握当地报警、急救电话及中国驻外使领馆的联系方式。遇突发事件时保持冷静，及时报警并可联系使领馆寻求协助。外交部全球领事保护与服务应急热线为+86-10-12308。 diff --git a/02-use-cases/travel_planner/knowledgebase_docs/tourists_recommend.md b/02-use-cases/travel_planner/knowledgebase_docs/tourists_recommend.md deleted file mode 100644 index 441e1734..00000000 --- a/02-use-cases/travel_planner/knowledgebase_docs/tourists_recommend.md +++ /dev/null @@ -1,225 +0,0 @@ -国内旅游热门路线特色景点及玩法推荐 - -## 1. 敦煌小众路线推荐 - -敦煌的经典景点确实有更多样的玩法。为了帮你避开人群、获得更独特的体验，我为你整理了这几个景点值得尝试的小众路线和特别体验。 - -下面这个表格汇总了每个景点的核心小众亮点和建议，方便你快速了解。 - -### 敦煌特色景点小众玩法推荐 - -| **景点** | **小众核心亮点** | **关键体验/玩法** | **特别提示** | -| ---------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -| **雅丹魔鬼城** | **乘坐越野车深入腹地** | 景区提供越野车服务，可以带你前往普通观光车不到的、更原始震撼的区域。 | **最佳时间**：下午5:30后进入，**顺光光线**让雅丹地貌立体感最强。 | -| **莫高窟** | **数字与复制洞窟深度体验** | 参观**"寻境敦煌"数字展厅**，用VR眼镜沉浸式探索特窟；在**敦煌石窟文物保护研究陈列中心**观看8个1:1复制洞窟。 | **门票区别**：A类票含数字电影+8实体洞窟，B类票参观4个实体洞窟。旺季A类票紧张，可选B类票保底。 | -| **鸣沙山月牙泉** | **错峰与深度沙漠体验** | **黄昏时分入园**，玩到日落后（可待至晚8点），光线柔和且可看星空。**沙漠越野车**选"深度穿越路线"，前往无人的沙漠腹地。 | 门票**3天内有效**。下午5点后游玩更舒适，越野车价格可能小幅下调。 | -| **玉门关遗址** | **沉浸式历史场景体验** | 在**汉长城遗址**拍日落大片；将**小方盘城**、**汉长城**、**河仓城**三处遗迹串联理解。 | 景区内**景点分散**，必须乘坐观光车。与阳关组合包车一日游更高效。 | - -### 💡 如何串联与优化行程 - -基于上述信息，你可以这样优化行程： - -1. **精选交通方式**：前往**雅丹魔鬼城**和**玉门关**的西线，**包车**是必须的，能保证游览自由。拼车游通常行程固定，可能无法满足越野车深入、等日落等灵活需求。 -2. **锁定黄金时间**： - -* 将**雅丹魔鬼城**安排在一天的最后一站，确保在**下午5:30至日落**这个光线最好的时段进行深度游览。 -* **鸣沙山月牙泉**安排在另一天的**下午4点后**进入，体验项目和观赏日落。 - -3. **提前锁定核心体验**： - -* 尽早预订**莫高窟门票**，并根据票务情况决定参观重点。 -* 抵达敦煌后，立即与包车司机确认**雅丹越野车**的预订事宜。 - -### 📝 行前关键提醒 - -* **旺季提前预订**：暑假是超级旺季，**莫高窟门票**（尤其A类票）、住宿、包车都需尽早预定。 -* **应对炎热气候**：戈壁地区夏季极端炎热，务必做好最强级别的**防晒**（防晒霜、帽子、墨镜、头巾），并携带充足的饮用水。 -* **穿着建议**：选择**轻薄透气的长袖衣裤**，既防晒又能防止沙尘刺激皮肤。鞋子建议选**封闭式运动鞋或登山鞋**，避免沙子进入。 - -## 2. 北京故宫天坛等节奏舒缓的文化景点推荐 - -北京作为中国的文化中心，拥有众多文化景点。针对节奏舒缓、体验小众的需求，为你整理了这几个核心景点的人少玩法，关键在于精选区域、善用代步工具、巧用开放政策。适合带父母旅行，以下是具体推荐。 - -以下是为你梳理的具体方案和舒适安排： - -| 景点 | 推荐的小众 / 舒适区域 | 核心舒缓要点与游玩建议 | -| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **故宫** | **1. 宁寿宫（乾隆花园）** ：新开放区域，皇家园林精华，人少清静。 **2. 武英殿、文华殿** ：常设精品展览，可避开中轴线人流。 | **节奏舒缓的关键** ：• **路线** ：避免走遍三大殿，重点参观 **宁寿宫区** ，欣赏园林与建筑。• **休息** ：区域内有较多座椅，可随时休息。 | -| **颐和园** | **1. 谐趣园** ：精巧的园中园，可坐在廊下观鱼。 **2. 西堤及景明楼** ：仿西湖苏堤，视野开阔，游客较少。 **3. 后溪河（后湖）** ：幽静"绿野仙踪"，可乘船游览。 | **节奏舒缓的关键** ：• **交通** ：从**新建宫门**进，**乘船**到对岸，能节省大量步行体力。• **路线** ：重点玩**谐趣园**和 **西堤** ，放弃爬万寿山。 | -| **天坛** | **1. 斋宫与神乐署** ：需单独购票，团队游客少，环境清幽。 **2. 双环万寿亭** ：西门外的小众亭阁，本地人晨练处。 **3. 公园西部松林** ：本地人活动区，偶遇小松鼠。 | **节奏舒缓的关键** ：• **路线** ：核心区参观后，转到西侧**松林**或**双环万寿亭**区域休息。• **时间** ：傍晚游览，避开白天旅行团，**祈年殿夜景**也很美。 | -| **长城** | **1. 金山岭长城** ：相对小众，外国人居多，风景壮丽且设施完善。 **2. 居庸关长城** ：距离市区近，"居庸叠翠"景色优美。 | **节奏舒缓的关键** ：• **工具** ：**务必乘坐缆车/索道**上下，避免攀爬消耗。• **政策** ：**金山岭**门票 **次日有效** ，可安排两天轻松游玩。• **时间** ：早（8:30前）或傍晚前往，避开人流与暴晒。 | - -### 💡 行程规划与舒缓节奏建议 - -结合以上信息，你可以遵循以下原则规划6天行程： - -1. **穿插安排，劳逸结合** ： - -* **长城日**前后，安排 **市内公园漫步日** （如天坛+胡同）作为缓冲。 -* **故宫日**和**颐和园日**不要连在一起，两者步行量都较大。 - -2. **每日安排"午休"** ：这是带父母旅行最重要的技巧。可将每天上午的游览结束时间定在 **11:30左右** ，午餐后返回酒店休息，下午 **3点后再进行下一个轻松活动** （如逛胡同、公园散步）。 -3. **交通舒缓要点** ： - -* 北京市内优先选择 **出租车或网约车** ，点对点减少步行和地铁换乘的折腾。 -* 去长城 **务必包车** ，时间灵活，父母累了可随时返回。 - -### 📝 行前关键准备提醒 - -* **门票预约** ：故宫、天坛、颐和园都需提前在线实名预约。**故宫门票（尤其是包含宁寿宫区的）** 最为紧俏，一定要提前抢票。 -* **证件与优惠** ：带上父母身份证，**60周岁以上老人**可享受故宫、颐和园、天坛等市属公园 **免票或优惠票价** （具体以各景区最新政策为准）。 -* **装备准备** ：为父母准备 **轻便的折叠凳** （排队或园中休息用）、 **保暖外套** （山区和早晚温差大）、 **舒适防滑的鞋** 。 - -## 3. 三亚小众海滩与特色玩法推荐 - -避开人挤人的热门海滩，同时体验蜈支洲岛水上项目和南山祈福活动的精华玩法，错峰游玩核心景点，并将热门景点与周边小众渔村串联（如蜈支洲岛搭配后海村），以获得更深入、更舒适的体验。以下表格为你提炼出5个最符合你需求的景点及其特色玩法。 - -### 🏝️ 推荐的5个核心景点及特色玩法 - -| 推荐景点 | 特色玩法与体验亮点 | 如何避开人群/舒缓节奏 | -| --------------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| **1. 蜈支洲岛** | **海陆空立体玩海** ：体验**滑翔伞**高空俯瞰全岛、潜水、动感飞艇等水上项目。 | **核心策略是"早到早离"** ：乘坐第一班船上岛，下午4点前离开，完美避开上下岛的人流高峰。 | -| **2. 后海村** | **自由多元的渔村生活** ：在专业冲浪店学习冲浪；傍晚感受沙滩派对氛围；品尝地道疍家海鲜。 | 这里是渔村而非传统景区，生活节奏自然悠闲。建议安排在蜈支洲岛游玩之后，无缝衔接。 | -| **3. 西岛渔村** | **沉浸式渔村文化** ：探索用珊瑚垒砌的百年老屋、海上书房；体验赶海；在牛王岛看日落。 | **在岛上过夜**是避开一日游团队、感受宁静的最佳方式。白天可避开主沙滩，深入渔村小巷。 | -| **4. 南山文化旅游区** | **山海之间的祈福静心** ：瞻仰108米海上观音并绕佛祈福；游览南山寺；在园林步道静心漫步。 | **下午抵达** ：旅行团一般在上午聚集，下午前往相对清静。 **务必购买观光车票** ，可节省大量步行体力。 | -| **5. 梅联社区** | **原生态的渔民生活** ：退潮时在广阔的滩涂上漫步、拍照；在村里的特色书屋或咖啡馆闲坐，等待一场壮丽的滩涂日落。 | 这是一个非常小众、未商业化的原始渔村。可以将它与南山安排在一天，作为祈福后的放松。 | - -### 💡 旅行实用贴士 - -1. **交通建议** ：此行景点较为分散（蜈支洲岛在东，南山和梅联在西），强烈推荐 **租车自驾** ，自由且舒适。若仅在市区及海棠湾活动，打车结合租电瓶车（如在岛上）也可行。 -2. **住宿策略** ：可按“西岛/天涯镇—海棠湾/后海—市区”的顺序切换住宿，减少折返奔波。西岛和后海村的特色民宿能极大提升体验。 -3. **预订提醒** ：冬季是核心旺季，尤其春节前后最高，酒店 / 机票溢价显著，热门房型 “一房难求”，需尽早预订。**蜈支洲岛门票、水上项目套餐**也建议提前在线购买，常比现场优惠。 -4. **气候与装备** ：冬季的三亚温暖，但早晚有海风，需备薄外套。同时是全年紫外线最强的季节，务必做好高强度防晒。建议携带**防水袋、防晒霜、帽子、墨镜**和舒适的凉鞋。 - -## 4. 暑假亲子游青岛特色景点玩法推荐 - -下面表格推荐的6个景点和玩法，覆盖了玩海、文化、科普和经典地标，能很好地满足亲子家庭的需求。 - -### 🏖️ 核心景点亲子特色玩法推荐 - -| 推荐景点 | 特色玩法与亲子体验亮点 | 如何实现“亲子友好”与“舒缓节奏” | -| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| **1. 石老人海水浴场** | **综合性沙滩玩海** ：沙质平缓，可踏浪、堆沙堡。浴场官方会举办 **“沙滩风筝季”** 等活动。 | 可作为独立半天行程，玩完后直接返程，衔接顺畅。关注官方信息，偶遇节庆活动会更有趣。 | -| **2. 金沙滩/银沙滩 (黄岛)** | **“一动一静”玩沙组合** ：**金沙滩**沙细热闹；**银沙滩**人少清静，可按需选择。 | 建议安排在抵达日或次日，让孩子先过足“沙滩瘾”。两沙滩相距不远，打车即可切换。 | -| **3. 中国人民解放军海军博物馆** | **海陆空装备沉浸体验** ：可登上真正的军舰，还能预约进入 **“长征1号”核潜艇**内部参观（名额紧俏，需单独预约）。 | **务必提前预约** 。利用 **“免预约时段”** （早5:00-8:00）进入，可避开人流参观户外展区。 | -| **4. 八大关景区** | **人文与自然结合** ：在万国建筑群中散步，参加 **“亲子赶海”** 活动（需提前联系专业团队），在专业指导下寻找海星、螃蟹。 | 赶海活动需根据潮汐安排，通常傍晚进行。这是孩子会非常喜欢的体验型项目。 | -| **5. 海信科学探索中心** | **互动科普乐园** ：这里不是传统博物馆，孩子可以亲手操作数百个互动项目，在玩耍中学习物理、科技知识。 | 如遇阴雨天，这里是绝佳的室内备选方案，能让孩子尽情探索大半天。 | -| **6. 小鱼山/信号山公园** | **轻松登高观景** ：两座山都不高，步行约10分钟即可登顶。能将栈桥、老城区、海岸线尽收眼底，是快速建立青岛印象的最佳观景点。 | 建议作为下午活动，趁光线好时登顶拍照，之后便可结束当天的行程，非常轻松。 | - -### 暑期亲子游关键贴士 - -1. **预约！预约！预约！** ：这是暑期出行的重中之重。 - -* **海军博物馆** ：门票和核潜艇参观 **必须提前在官方渠道预约** 。核潜艇名额极少，建议提前演练抢票流程)。 -* **热门场馆** ：如啤酒博物馆、极地海洋世界（若计划前往）也建议提前购票。 - -2. **住宿与交通** ： - -* **住宿** ：前两晚可住**黄岛区**方便玩沙；后几晚推荐住 **市南区** （如五四广场、中山路附近），靠近地铁和景点，出行方便。 -* **交通** ：市区景点集中，**地铁+短途打车**是最高效舒适的组合。青岛老城部分路段坡多，不建议推笨重婴儿车。 - -3. **防晒与安全** ：暑期紫外线强，务必为孩子做好 **“防晒霜+帽子+防晒衣”** 的全套防护。玩沙踏浪时，家长要时刻看护，注意潮水变化。 - -## 5. 哈尔滨冰雪节及周边小众景点推荐 - -行程将经典景点、特色体验和美食探索相结合，并特别针对元旦/春节假期人流较多的情况，安排了错峰游览的建议。核心思路是“先市内经典，后郊外深玩”，先轻松游览市区地标，再深入体验冰雪项目。以下表格为你梳理出5个最符合你需求的景点及其特色玩法。 - -### 🏰 核心景点及特色玩法推荐 - -这5个景点涵盖了城市地标、冰雪奇观和特色文化，具体玩法如下： - -| 推荐景点 | 特色玩法与体验亮点 | 游玩温馨贴士 | -| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | -| **1. 冰雪大世界** | **冰雕王国的日与夜** ：下午入园，一次看遍日光下的晶莹与灯光后的璀璨。体验 **超级冰滑梯** （通常需排队）、乘坐**雪花摩天轮**。 | **保暖是重中之重** ：景区内比市区更冷。可提前贴好暖宝宝，穿防滑雪地靴。 | -| **2. 中央大街** | **万国建筑博览与美食巡礼** ：脚踩百年面包石，欣赏欧式建筑。沿街品尝**马迭尔冰棍**、**烤红肠**、**秋林格瓦斯**。 | **错峰游览** ：清晨或夜晚人流相对较少，建筑在灯光下别有风情。 | -| **3. 圣索菲亚教堂** | **穿越百年的建筑美学** ：白天拍摄绿穹顶与蓝天白雪的经典画面，夜晚欣赏灯光下的浪漫景致。可入内参观博物馆，聆听音乐钟声。 | **内部参观** ：门票不贵，内部空间不大但精美，适合对历史建筑感兴趣的朋友。 | -| **4. 太阳岛风景区** | **雪雕艺术与冬日休闲** ：核心是参观**太阳岛国际雪雕艺术博览会**。还可前往室内冰雪场馆（如冰雪艺术馆）感受“反季冰雪”。 | **交通方式** ：可步行、打车，或体验从江边乘坐 **松花江缆车** （俯瞰冰封江面）。 | -| **5. 近郊滑雪场**(如阿城玉泉) | **新手友好的冰雪运动初体验** ：比去亚布力更节省时间。雪场通常提供雪具租赁和教练服务，适合初学者体验。 | **提前预订** ：建议通过正规平台提前购买包含雪具、雪票的套餐。穿着防水保暖的衣物。 | - -### 💡 行前关键准备与美食地图 - -为确保旅途顺利舒适，请注意以下几点 - -1. **极致保暖是头等大事** ：1月哈尔滨极端气温可达-30℃以下。务必准备加厚羽绒服、加绒防水雪地靴、帽子、围巾、防水手套等。手机和相机需注意 **低温防冻** （可贴暖宝宝）。 -2. **不可错过的哈尔滨美食** ：除了行程中提到的，你还可以尝试： - * **东北硬菜** ：**杀猪菜**、江鱼宴、得莫利炖鱼。 - * **小吃与烟火气** ：去**师大夜市**或餐馆尝尝**麻辣烫、烧烤**、张包铺的排骨包子。 - * **特色体验** ：在室内吃**冻梨、冻柿子**，用冷水“缓”开再吃。 -3. **旺季出行特别提醒** ： - * **提前预订** ：冬季是核心旺季（12月-次年2月），机票、酒店、热门景点门票（尤其是冰雪大世界）建议 **尽早预订** 。 - * **关注官方信息** ：出行前，关注“哈尔滨冰雪大世界”等官方公众号，获取最新的开闭园时间、演出活动及门票政策。 - * **灵活调整** ：如遇极端天气或景区人流过大，请灵活调整行程，安全第一。 - -## 6. 十一黄金周大理景点及特色玩法推荐 - -平衡热门景点与小众目的地，避开人流高峰，深入体验大理的自然与文化魅力。 - -### 🌄 大理核心景点及特色玩法推荐 - -| 类型 | 景点名称 | 区域 | 核心看点与氛围 | 特色体验/玩法参考 | -| ---------------------- | ------------------ | ------------ | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **必打卡经典** | 洱海 | 环海区域 | 高原湖泊的辽阔与宁静，大理风光的核心。 | **生态廊道骑行** ：在洱海西岸的生态廊道骑行，串联龙龛码头、S湾等。`` **环海自驾/包车** ：一天游览海东的风光，如双廊、文笔村等。 | -| | 苍山 | 大理古城西侧 | 苍山雪顶的壮丽和山间林泉的幽静。 | **乘坐大索道** ：登上洗马潭，俯瞰洱海全景。`` **轻徒步** ：沿玉带云游路（玉带路）平缓步行，欣赏苍洱风光。 | -| | 大理古城 | 古城区域 | 南诏与大理国的历史底蕴与悠闲的文艺生活。 | **漫步夜游** ：避开白天人流，夜晚漫步人民路、登城墙看夜景。`` **体验非遗** ：寻找乳扇制作、甲马版画等手工艺体验。 | -| | 崇圣寺三塔 | 古城西北 | 大理的标志性建筑，背靠苍山，面朝洱海。 | **摄影打卡** ：在三塔倒影公园拍摄经典倒影。了解南诏、大理国时期的佛教文化。 | -| | 喜洲古镇 | 洱海西岸 | 保存完好的白族民居和恬静的田园风光。 | **看田园风光** ：打卡“夫妻树”、漫步稻田。`` **体验手工艺** ：在“匠志集”体验甲马版画或扎染，在“瓦猫小院”制作瓦猫。`` **品尝美食** ：一定要吃喜洲粑粑。 | -| **深度小众之选** | 沙溪古镇 | 剑川县 | 茶马古道上唯一幸存的古集市，时间停滞般的静谧。 | **古镇漫游** ：探索寺登街、古戏台、兴教寺、玉津桥。`` **先锋书局** ：在由粮仓改造的书局阅读发呆。`` **品尝私房菜** ：在“喜宝赏饭”、“柿意”等餐厅品尝融合当地食材的佳肴。 | -| | 洱海生态廊道小众段 | 洱海西岸 | 避开S湾等人流，享受更原始的洱海风光。 | **富美邑** ：冬季有红杉林和海鸥，景美人少。`` **海舌公园** ：半岛形态，三面环海，景色开阔。 | -| | 苍山小众寺院/溪谷 | 苍山山麓 | 避开索道人群，感受苍山的幽静与文化。 | **寂照庵** ：以多肉和精美斋饭闻名的尼姑庵。`` **无为寺** ：历史悠久，更为清静的皇家寺院，可徒步前往。`` **莫残溪** ：苍山十八溪之一，沿途有“大理路极主题公园”。 | -| | 环海东路小众打卡点 | 洱海东岸 | 拥有独特地貌和视角，容易出片。 | **挖色码头** ：有废弃船坞，适合拍摄工业风照片。`` **鹿卧山** ：有悬崖窗框等自然形成的拍照点。 | -| | 特色庄园/农场 | 洱海周边 | 亲子友好，体验田园与手作乐趣。 | **苍海云上草原** ：位于苍山脚，有草坪、小动物和亲子设施。`` **风地花野香草庄园** ：可体验制作鲜花饼、香草纯露等。 | - -### 💡 如何组合与国庆出行贴士 - -基于以上清单，安排国庆7天行程的关键是 **合理串联、劳逸结合** ： - -1. **行程组合建议** ：核心思路是“ **古城及洱海西岸（2-3天）→ 沙溪（2天1晚）→ 洱海东岸及返程（1-2天）** ”。 - -* 前几晚可住**大理古城**或 **喜洲** ，方便游览苍山、洱海西岸生态廊道和喜洲。 -* 中间预留完整的**2天1晚**给 **沙溪古镇** ，并从沙溪直接包车前往双廊或挖色，开始环海东线游览。 -* 最后一晚可住 **海东** （如双廊、文笔村），方便看日落并为返程做准备。 - -1. **国庆黄金周特别提醒** ： - -* **预订第一** ：国庆住宿（尤其是沙溪、海东一线海景房）、机票/车票、苍山大索道票务必**提前1个月以上**预订。 -* **交通优选** ：环洱海东岸及前往沙溪，**包车**是最舒适灵活的选择。西岸生态廊道则需骑行或乘坐观光车。 -* **心态放平** ：国庆难免人多，善用“早出晚归”错峰，并放慢节奏，享受大理的“慢生活”本质。 - -## 7. 清明节杭州周边踏青小众景点推荐 - -### 杭州三日游核心景点与玩法 - -| 主题 | 主要景点 | 特色玩法与核心亮点 | -| ---------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **西湖核心与文化夜游** | **1. 西湖** | **特色玩法** ：**清晨游湖** ：早起前往 **断桥** 、 **苏堤** ，避开人流，享受清静。 **小众路线** ：游览**北山街**民国建筑群，或从杨公堤进入 **茅家埠** 、 **乌龟潭** 、 **浴鹄湾** ，体验野趣西湖。**经典游船** ：从**花港观鱼**等码头乘船至**三潭印月**。 **核心亮点** ：一次看遍水墨画般的湖光山色与静谧的湿地秘境。 | -| | **2. 西湖夜游 (宋风上岛)** | **特色玩法** ：傍晚从**湖滨二公园**等码头登船。跟随“苏东坡”的足迹，欣赏诗词光影秀、宋式点茶、歌舞等沉浸式演出。 **核心亮点** ：在夜色与科技光影中，穿越千年，感受宋“潮”繁华。 | -| **佛国禅意与城市考古** | **3. 灵隐飞来峰景区** | **特色玩法** ：**必体验** ：参观**灵隐寺**祈福。 **文化精华** ：按**青林洞→玉乳洞→龙泓洞→冷泉溪**路线，欣赏五代至元代的石窟造像。**登高可选** ：前往**永福寺**或攀**北高峰**。 **核心亮点** ：在千年古刹与江南罕见石窟群中，领略佛教艺术与山林清幽。 | -| | **4. 杭州博物馆 “City Boat” 活动** | **特色玩法** ：关注“杭州博物馆”官方信息，报名参与。活动结合 **城市徒步(五柳巷街区)** 与**东河乘船**，由讲解员带领探访南宋古迹。 **核心亮点** ：用“City Walk+City Boat”的新颖形式，深度解读杭州的南宋历史脉络。 | -| **湿地生态与春日花海** | **5. 西溪国家湿地公园** | **特色玩法** ：• **春日赏花** ：清明正值 **花朝节** ，在**绿堤**可赏郁金香等春日花海。• **推荐路线** ：从周家村入口进入， **徒步游览绿堤** （免费区域），再**乘电瓶船**深入湿地核心区（如深潭口）。• **生态体验** ：在**莲花滩**观鸟，或体验湿地研学活动。 **核心亮点* | - -* **交通住宿策略** ：清明期间西湖周边拥堵，建议**地铁+共享单车/公交**结合。住宿可首选**西湖湖滨东侧**或 **地铁1号线、2号线沿线** ，去各景点都方便。 -* **天气与着装** ：清明多雨，备好雨具，穿 **舒适防水的鞋子** 。早晚温差大，建议采用“洋葱式”穿衣法。 -* **错峰游览** ：每天**早出发**是避开人群的最好方法。西湖和灵隐寺尽量安排在上午，下午可安排相对轻松的博物馆或湿地徒步。 - -## 8. 成都周边特色景点玩法推荐 - -### 成都三日游特色玩法与推荐美食 - -| 主题 | 核心景点 | 特色玩法与亮点 | 推荐美食 | -| ---------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -| **熊猫萌趣与城市烟火** | **1. 成都大熊猫繁育研究基地** | **赶早看熊猫** ：务必在**上午9点前**抵达，此时熊猫最活跃。可重点参观 **月亮产房** （看幼崽）和 **熊猫别墅** （看成年熊猫）。园区大，可乘坐观光车（约30元）节省体力。 | 午餐可在基地内简餐，或返回市区在**建设路小吃街**等地解决。 | -| | **2. 宽窄巷子** | **节日深度游** ：由宽巷子、窄巷子、井巷子组成。五一期间常有特别展览、市集或光影装置。可去**见山书院**喝茶、**熊猫邮局**寄明信片，或看一场**川剧变脸**小演出。 | 晚餐可在**宽窄巷子**内体验氛围，或步行至隔壁的 **奎星楼街** （更受本地人欢迎）品尝钟水饺、担担面、糖油果子等小吃。 | -| **古街漫游与都市休闲** | **3. 人民公园（鹤鸣茶社）** | **体验成都“慢”** ：在百年历史的鹤鸣茶社，花十几元点一杯盖碗茶（推荐“碧潭飘雪”），融入当地人“摆龙门阵”的悠闲生活。可顺道逛逛公园内的“相亲角”。 | 午餐可在茶社点**钟水饺**等小吃，或前往公园旁的**廖老妈蹄花**总店品尝地道蹄花。 | -| | **4. 武侯祠** | **三国文化与网红打卡** ：中国唯一君臣合祀祠庙，了解蜀汉历史。标志性的**“红墙竹影”** 蜿蜒曲折，是绝佳的摄影背景。 | 武侯祠与锦里相邻，晚餐推荐在**锦里古街**解决，可品尝三大炮、担担面、龙抄手等地道小吃。 | -| | **5. 锦里古街** | **夜景更出片** ：建议傍晚前往，待灯笼亮起后，古街氛围感十足。街内常有川剧变脸等小型街头表演。 | | -| **周边山水一日游** | **方案A：都江堰** | **水利奇观与网红打卡** ：按“鱼嘴→飞沙堰→宝瓶口”路线参观，感受古人智慧。出高铁站即可打卡**仰天窝广场**巨型“自拍熊猫”雕塑。 | 午餐可在都江堰市区或景区外的**南桥**附近解决，品尝当地特色的 **尤兔头** 、老腊肉或豆腐脑。 | -| | **方案B：青城山** | **问道青城，幽静徒步** ：感受“青城天下幽”的自然静谧。可选择徒步上山（约2-3小时）或乘坐索道，探访天师洞、上清宫等道教宫观。 | 午餐可在山脚下的**泰安古镇**解决，品尝腊排骨、白果炖鸡、豆花等农家菜。 | - -### 💡 假期出行贴士 - -1. **门票预约是重中之重** ：**熊猫基地**必须提前在线实名预约购票。武侯祠、都江堰、青城山等热门景点门票也建议提前购买。 -2. **关注活动，提前规划** ：宽窄巷子在节假日会举办特别活动（如光影展、市集、巡游等），出行前可关注其官方信息，让体验更丰富。 -3. **交通住宿策略** ： - * **交通** ：市区内优先使用 **地铁+共享单车** 。前往都江堰/青城山，建议提前购买**犀浦站**出发的城际列车票。假期期间车位紧张，自驾需谨慎。 - * **住宿** ：建议选择 **地铁2、3、4号线沿线** （如春熙路、宽窄巷子、人民公园附近），出行和就餐都极为方便。 -4. **出行心态** ：假期人流密集，请务必 **“赶早”** （尤其是熊猫基地），并保持耐心。可以灵活调整游览顺序，例如先去相对小众的人民公园，下午再逛武侯祠和锦里。 diff --git a/02-use-cases/travel_planner/requirements.txt b/02-use-cases/travel_planner/requirements.txt deleted file mode 100644 index 81906a71..00000000 --- a/02-use-cases/travel_planner/requirements.txt +++ /dev/null @@ -1,6 +0,0 @@ -tos>=2.8.7 -veadk-python==0.5.1 -google-adk==1.19.0 -volcengine-python-sdk>=4.0.33 -agentkit-sdk-python==0.3.2 -cozeloop==0.1.21 diff --git a/python/02-use-cases/travel_planner/agent.py b/python/02-use-cases/travel_planner/agent.py index 77b182f8..1d08ad1e 100644 --- a/python/02-use-cases/travel_planner/agent.py +++ b/python/02-use-cases/travel_planner/agent.py @@ -177,6 +177,7 @@ model_name=model_name, instruction=travel_planner_prompt, tools=[amap_tool, web_search], + auto_save_session=True, long_term_memory=long_term_memory, knowledgebase=knowledge, ) diff --git a/python/02-use-cases/travel_planner/requirements.txt b/python/02-use-cases/travel_planner/requirements.txt index cd45a5ef..7349c4ba 100644 --- a/python/02-use-cases/travel_planner/requirements.txt +++ b/python/02-use-cases/travel_planner/requirements.txt @@ -1,6 +1,6 @@ tos>=2.8.7 -veadk-python==0.5.20 +veadk-python==0.5.21 google-adk==1.21.0 volcengine-python-sdk>=4.0.33 -agentkit-sdk-python==0.5.1 +agentkit-sdk-python==0.5.2 cozeloop==0.1.21 \ No newline at end of file