← 返回
未分类 Key

Ctg Travel

中旅旅行开放平台一站式预订助手。整合机票、酒店、火车票、门票四大资源,支持查询、预订、退款全流程。下载中旅旅行APP获取 API Key。当用户表达出行住宿需求时(如"买火车票""订酒店""查询航班""购买景区门票"),提供智能引导和便捷预订服务。
中旅旅行开放平台一站式预订助手,整合机票、酒店、火车票、门票,支持查询、预订、退款全流程。下载中旅旅行APP获取API Key,当用户表达出行住宿需求(如买火车票、订酒店、查航班、购买景区门票)时,提供智能引导和便捷预订服务。
ctg-travel ctg-travel 来源
未分类 clawhub v1.0.5 1 版本 100000 Key: 需要
★ 0
Stars
📥 469
下载
💾 0
安装
1
版本
#latest

概述

旅游项目 Skill

一、前置条件(首要步骤,必须先完成)

  • 运行环境:Python 环境,支持 HTTP 调用
  • 接入指南Skill 接入指南
  • CTG_API_KEY:中旅旅行 API Key,用于调用接口

在任何预订/查询流程开始之前,必须先确保 API Key 可用。 获取流程如下:

  1. 检查配置文件:检查 config/ctgConfig.json 中是否存在 apiKey 字段。
  2. 索取并持久化:若配置文件中无 API Key,立即向用户索要,并阻塞后续流程直到用户提供。获取后通过命令持久化:python scripts/apiexe.py set-key --api-key <用户提供的Key>,将 Key 写入 config/ctgConfig.json,后续调用自动读取。
  3. 禁止访问:当没有获取到 CTG_API_KEY 时不要进行需求识别与分流

话术示例:「为了为您办理预订服务,请提供您的中旅旅行 API Key。您可以在中旅旅行 APP 中获取后提供给我。」

二、需求识别与分流(按需加载指南)

根据用户输入识别意图,仅加载匹配的资源 guide,不预加载全部。

资源线触发示例操作指南接口文档
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
火车买火车票、订火车票、买高铁票、动车票、预定武汉-北京火车票、查询火车票/高铁票、去上海有什么车次、坐 G101 去北京guide/train.mdapi/train.json
火车票退订火车票退票、我要退票、申请退款、确认退票guide/train-refund.mdapi/train-refund.json
机票买机票、订机票、买飞机票、预定北京-上海机票、查询航班/机票、明天飞杭州有什么航班、坐飞机去广州、机票订单guide/plane.mdapi/plane.json
机票退订退机票、机票退票、机票退款、申请退款、把刚刚预定的机票退了、取消这张机票(已支付)、张三退票、张三和李四退票guide/plane-refund.mdapi/plane-refund.json
酒店预订酒店、订酒店、订房、酒店订单、我的酒店订单、取消订单(未支付)guide/hotel.mdapi/hotel.json
酒店退订退订酒店、酒店退款、申请退款、我要退订guide/hotel-refund.mdapi/hotel-refund.json
门票购买门票、订门票、景区门票、查询门票、门票订单guide/ticket.mdapi/ticket.json
门票退订退门票、门票退票、门票退款、申请退款、把刚刚预定的门票退了、取消这张门票(已支付)guide/ticket-refund.mdapi/ticket-refund.json
  • 模糊推荐:用户说「想去XX旅游」「推荐去哪玩」→ 先推荐目的地,再引导明确资源类型
  • 多资源:逐个引导、依次下单

三、整体交互流程

用户输入 → 确认 API Key 已配置(无则索要并通过 set-key 持久化) → 匹配资源线 → 加载对应 guide + api → 收集必填参数 → 调用接口 → 话术反馈

四、接口调用

  • 执行scripts/apiexe.py call --method --arg ''
  • 请求超时:「当前系统响应较慢,请稍后再试。」
  • 后台报错:转化为通俗话术,禁止暴露接口名、method、技术报错原文
  • 多次失败:「抱歉,当前服务暂时繁忙。您可以前往「中旅旅行」App 完成操作,体验更流畅。」

五、入参引导与结果反馈

  • 以 api/*.json 为准:查阅对应 method 的 parameters.requiredproperties
  • 缺则提示:每次只问一项缺项(如「从哪个城市出发?」),逐步收集
  • 完整后再请求:所有必填字段齐备后再调用
  • 结果反馈:使用通俗语言,禁止返回原始技术字段。如「您的火车票订单已创建成功,请注意查收通知。」

版本历史

共 1 个版本

  • v1.0.5 当前
    2026-05-03 06:00 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

life-service

healthcheck

stellarhold170nt
使用 JSON 文件存储追踪饮水和睡眠
★ 11 📥 30,198
life-service

Sonoscli

steipete
控制Sonos音箱(发现/状态/播放/音量/分组)
★ 56 📥 85,234
life-service

Caldav Calendar

asleep123
使用 vdirsyncer + khal 同步并查询 CalDAV 日历(iCloud、Google、Fastmail、Nextcloud 等)。适用于 Linux。
★ 244 📥 30,678