核心功能与用法
Hotel Booking AI 是一套面向 B2B 场景的实时酒店预订技能，覆盖「搜索-比价-锁价-下单-支付-退订」完整闭环。核心工作流为：
1. 目的地搜索 (search_location)：输入城市或地标关键词，获取 region_id 与候选酒店列表。
2. 酒店列表 (search_hotels)：传入入住/离店日期、成人数，返回最多 3 家最低价酒店。
3. 房型与实时报价 (query_room_rates)：查看可售房型、含餐情况、取消政策及总价。
4. 价格校验与锁房 (check_room_availability)：确保价格未变动并锁定库存，返回最终 rate_code 与 total_price。
5. 创建订单 (create_booking)：无需电话/邮箱，仅需客人姓名即可生成预订号 agent_ref_id。
6. 支付 (pay_order)：支持微信支付 (11) 与支付宝 (12)，返回支付链接供用户完成付款。
7. 订单管理：随时查询 (query_booking) 或在用户确认后取消 (cancel_booking)。
显著优点
- 实时直连：所有房价、库存、取消政策均来自上游 API，杜绝「幻觉」房价。
- 极简接入：仅需
user_key即可调用，无需额外资质或复杂 OAuth。 - 支付原生：内置微信/支付宝支付跳转，符合国内用户习惯。
- 取消政策透明：
refundable: true表示可免费取消至startDateTime；逾期仅扣amount手续费，非全额损失。
潜在局限与风险
- 依赖单点认证：
user_key过期或无效时全链路中断，需引导用户至 AgentAuth Dashboard 重新获取。 - Region/Hotel ID 严格为字符串：若误传数字可能导致 400 错误。
- 价格锁定时效未明示：
check_room_availability锁定后需尽快下单，超时可能释放库存。 - 无自动重试机制：API 异常时需人工介入，系统不会自动回退或推荐替代方案。
适合人群
- 商旅平台、企业 OA 机器人、行程规划 Agent 的开发者
- 需要「对话即预订」体验的终端用户（出差、度假场景）
- 已有
user_key且熟悉 JSON API 调用的技术团队
常规风险提示
- 严禁凭记忆回答：任何酒店信息必须以实时 API 返回为准，失败时如实报错。
- 支付链接安全：
pay_url由上游生成，需提醒用户核对域名防钓鱼。 - 取消需二次确认：执行
cancel_booking前务必让用户确认预订号，避免误操作。