SuperAPI AI 工具集

tourmind-booking

办公与效率

查看项目

更新于 10-23 16:18

技能介绍

TourMind Booking Skill 是面向酒店与住宿场景的 AI 技能,用于实时酒店发现、房型价格比较、可用性检查、预订、订单管理与支付。其数据来源于 TourMind API,基础 URL 为 https://api.tourmind.com,所有端点使用 POST 与 JSON 格式。

用途与主要能力

该技能覆盖从酒店搜索到订单支付的完整流程,包括:搜索酒店候选、获取酒店详情与图片、查询实时房型与价格、批量查询多家酒店房型、重新检查房型可用性、创建预订、查询预订、取消预订以及发起支付。还提供位置解析(区域、POI 或酒店)和技能更新检查。

凭证与通道

技能根据凭证前缀选择通道:无令牌时使用公开个人通道(ToC),用于搜索、详情、价格和可用性查询;令牌以 uk_ 开头时使用已认证个人通道;令牌以 sk_ 开头时使用商业通道(ToB)。凭证需从 {baseDir}/skill_token.txt 读取,若缺失则检查同级航班技能目录 {baseDir}/../flight-booking-ai/skill_token.txt。用户主动发送令牌时,技能会将其保存到 {baseDir}/skill_token.txt,且不再重复展示完整令牌。个人通道凭证字段为 user_key,商业通道凭证字段为 token,两者严格绑定,不可混用。

使用方式

用户需提供地点、入住日期和退房日期才能进行首次酒店搜索;若未提供成人数量,默认按每间房 1 位成人处理并明确告知用户。搜索时,lowest_price 和 highest_price 必须以人民币(CNY)发送,且表示整个住宿期间所有房间的总价,而非每晚价格;若用户预算为其他货币,需获取实时汇率并换算。创建预订前必须提供客人完整合法姓名和有效联系邮箱,不收集电话号码。取消政策严格按返回结果解释:non_refundable 或 effective_non_refundable=true 表示不可退款;free_cancel_before_deadline 表示仅在截止日期前可免费取消。最终预订确认模板中需说明 TourMind 房价含税,并单独展示酒店强制费用披露;仅当用户选择 Stripe 时,额外收取 3.5% 处理费。

适用场景

该技能适用于多语言酒店搜索与推荐、附近住宿查找、旅舍与宾馆查询、房型价格比较、可用性检查以及预订与订单管理。示例包括:为巴黎旅行寻找卢浮宫或歌剧院附近、每晚约 200 欧元的酒店;为东京家庭旅行寻找新宿附近安静、含早餐且可免费取消的酒店;为巴厘岛蜜月寻找努沙杜瓦海滩附近、带泳池且每晚低于 300 美元的度假村。

限制

技能禁止使用记忆或训练数据填补酒店、坐标、房间、图片、价格、政策或可用性信息,必须仅使用 TourMind API 数据。不得静默扩大硬性半径或预算约束。若 API 调用失败,需报告确切错误,不得编造结果或推荐无关内容。价格和订单工作流严格属于单一通道,不得跨通道复用 rate_code、价格、取消政策、可用性状态、支付上下文或订单操作上下文。遇到 HTTP 401 或未授权错误时,需删除被拒绝的凭证并停止需要认证的操作,不得静默降级或尝试其他通道。商业通道返回 HTTP 403 且 error_code=HOTEL_BUSINESS_PERMISSION_REQUIRED 时,需停止酒店工作流并提示用户联系管理员或 TourMind 支持,不得删除或替换凭证文件。