qunar-travel-query

# 去哪儿网旅游查询 Skill

## 任务目标
- 本 Skill 用于：通过去哪儿网开放平台API查询旅游相关信息
- 能力包含：机票查询、酒店查询、景点查询、火车票查询
- 触发条件：用户提出查询航班、酒店、景点或火车票的需求时

## 前置准备

### 凭证配置
首次使用时需要配置去哪儿网API Key凭证。当智能体检测到未配置凭证时，会自动触发凭证配置流程：
- 凭证名称：qunar_api_key
- 所需信息：去哪儿网开放平台API Key
- 获取方式：访问 http://open.qunar.com 注册开发者账号，创建应用获取API Key

### API文档参考
在使用前，建议阅读 [references/api_reference.md](references/api_reference.md) 了解各类查询的API端点和参数格式。

## 操作步骤

### 标准流程

1. **意图识别**
   - 智能体分析用户查询意图，识别查询类型（机票/酒店/景点/火车票）
   - 识别关键参数：出发地、目的地、日期、人数等
   - 确认用户期望的输出格式（列表/详细/对话式）

2. **参数收集与验证**
   - 根据查询类型收集必要参数：
     - 机票：出发城市、到达城市、出发日期、返回日期（可选）
     - 酒店：城市名称、入住日期、退房日期
     - 景点：城市名称、景点名称（可选）
     - 火车票：出发城市、到达城市、出发日期
   - 智能体与用户确认缺失的关键参数

3. **API查询**
   - 调用 `scripts/qunar_query.py` 执行查询
   - 脚本参数：
     - `query_type`: 查询类型（flight/hotel/scenic/train）
     - `api_endpoint`: API端点URL（根据 [references/api_reference.md](references/api_reference.md) 确定）
     - `api_params`: 查询参数字典
     - `method`: HTTP方法（GET/POST，默认POST）
     - `output_format`: 输出格式（list/detail/conversation）

4. **结果处理与展示**
   - 智能体根据API返回数据进行解析
   - 根据用户选择的输出格式生成结果：
     - **列表格式**：简洁展示关键信息（价格、时间、排名）
     - **详细格式**：提供完整信息和分析建议
     - **对话格式**：交互式查询，逐步细化需求

5. **推荐与建议（可选）**
   - 智能体基于查询结果提供个性化推荐
   - 分析价格趋势、最佳选择、注意事项等

### 可选分支

- **当查询失败**：检查API Key配置、网络连接、参数格式，向用户说明错误原因
- **当需要更换API Key**：指导用户重新配置凭证
- **当查询结果为空**：建议用户调整查询参数或查询条件

##...