Tourmind-Booking-Skills的Token如何配置?uk_个人通道与sk_企业通道完全解析
Tourmind-Booking-Skills的Token如何配置?uk_个人通道与sk_企业通道完全解析
Tourmind-Booking-Skills 是一款让 AI Agent 端到端搜索并预订全球酒店与机票的技能包,其所有验价、预订、支付操作都依赖一个 TourMind Skill Token。本文带你完整走一遍 Token 配置流程:uk_ 个人通道(ToC)与 sk_ 企业通道(ToB)的获取路径、保存位置、通道路由原理,以及 Token 失效后的安全恢复步骤,零基础也能一次配好。
Skill Token 是什么:哪些操作必须配置 Token
Token 是调用 TourMind API 的"身份钥匙"。好消息是——搜索阶段完全免费,无需任何 Token:
| 操作类别 | 是否需要 Token |
|---|---|
| 酒店搜索、酒店详情、房型与房价查询、库存核对 | ❌ 不需要(公开个人通道) |
| 机场查询、机票实时搜索 | ❌ 不需要(已配置的 Token 仍会被后端校验) |
| 机票验价(verify_offer) | ✅ 需要 |
| 酒店/机票下单、订单查询、取消、发起支付 | ✅ 需要 |
换句话说:你可以先装上技能、畅快地对比酒店和航班,只有在要"真金白银"下单时才需要回来配置 Token。这一规则在 README.zh-CN.md 的「Token 与安全说明」中有完整描述。
Token 配置三步教程:安装 → 获取 → 一句话生效
第一步:安装 Skill(约 1 分钟)
把下面的消息直接发给你的 Agent,或自己执行安装命令:
请帮我安装 TourMind Booking Skills,技能仓库:tourmind-com/Tourmind-Booking-Skills
npx skills add tourmind-com/tourmind-booking-skills --all
该命令会一次性安装两个技能:酒店技能 tourmind-booking 与机票技能 flight-booking-ai,它们共用同一个 Token,每位用户只需申请一次,无需重复办理。
第二步:按身份获取对应 Token
Token 的前缀决定了通道,先看清自己属于哪一类 👇
- 👤 个人用户:打开
https://auth.journione.ai,通过邮箱验证完成登录后,从页面右侧复制以uk_开头的 Token。 - 🏢 企业用户:先登录 TourMind 账号,访问
https://tourmind.com/user/skill-token创建一个以sk_开头的私有 Token;若还没有企业账号,先到https://tourmind.com/admin/skillSignup注册。
第三步:把 Token 发送给 Agent(无需手动建文件)
在私密对话中把你信任的 Agent 视为收件人,发送以下模板:
请使用以下 TourMind Skill Token 调用 AI Skills:
<YOUR_SKILL_TOKEN>
该 Token 仅用于 TourMind AI Skill 鉴权,请勿在公开对话、公开代码仓库或共享文档中暴露完整 Token。
Agent 会自动将 Token 安全保存到技能目录下的 skill_token.txt 并完成配置,你不需要自己创建或编辑任何文件;在 macOS / Linux 上还会自动执行 chmod 600 skill_token.txt,把文件权限收紧为仅当前用户可读写。
uk_ 个人通道 vs sk_ 企业通道:一张表看懂差异
| 对比项 | uk_ 个人通道(ToC) |
sk_ 企业通道(ToB) |
|---|---|---|
| 适用人群 | 个人出行用户 | 企业 / 商务客户 |
| 获取入口 | Journione 登录页(邮箱验证) | TourMind 账号的私有 Token 页 |
| 机票请求中的位置 | 完整 Token 放在 X-Skill-Token 请求头 |
与左列相同 |
| 酒店请求中的位置 | JSON 请求体 user_key 字段(ToC 端点) |
JSON 请求体 token 字段(ToB 端点) |
| 附加能力 | 标准搜索与预订 | 最优渠道价格、加价与佣金能力 |
| 相互关系 | 两者不可混用,前缀即通道 | 详见下方"通道路由"小节 |
关键结论:前缀决定通道,前缀不等于授权。uk_ 绝不能发给企业端点,sk_ 也不能发给个人端点,更不能在同一个请求里同时携带两个字段——这条规则同时写在 skills/tourmind-booking/SKILL.md 与 skills/tourmind-booking/references/parameter_guide.md 中。
通道路由原理:Token 存哪里、怎么传
理解这套机制后,你就不会再问"为什么两个技能只申请一次 Token":
- 单 Token 双技能共享:酒店技能与机票技能使用同一个 TourMind Skill Token。解析顺序是先读当前技能目录的
{baseDir}/skill_token.txt,若为空再回退到兄弟技能目录的skill_token.txt,取到第一个非空凭证即生效。 - 机票通道:两个通道共用同一 Base URL 与端点路径,Token 只通过
X-Skill-Token请求头传输,绝不放入 JSON 请求体或 URL。 - 酒店通道:无 Token 走公开个人通道;
uk_走认证个人通道;sk_走企业通道,且每个企业端点都要求携带token。 - 通道切换 = 报价作废:从
uk_切到sk_(或反向)时,此前返回的所有房价、rate_code、取消政策、库存状态全部失效,Agent 会用新通道重新查询实时房型、重新核验价格,并要求你重新确认预订详情。 - 订单绑定创建通道:订单创建后,后续的支付、查询、取消必须继续使用创建订单时同一前缀的凭证,不能"跨通道"访问,更不能两个通道轮流试探。
完整的端点契约(包括 POST /skill/toc/* 与 POST /skill/tob/* 的字段要求)见 skills/flight-booking-ai/references/parameter_guide.md 与 skills/tourmind-booking/references/parameter_guide.md。
Token 失效或过期:401 认证失败恢复流程
Token 被服务端拒绝(HTTP 401、unauthorized 或 invalid_token)时,技能内置了一套"先止损、再换证"的恢复机制:
- 立即清除:Agent 会把被拒绝的 Token 从其来源文件与可复用的请求头中删除,并停止当前受保护操作——不会自动重试被拒凭证。
- 按前缀换新:
uk_失效 → 引导到 Journione 登录页获取新 Token;sk_失效 → 引导到 TourMind 私有 Token 页;若前缀未知,则同时展示两个选项。 - 保存 ≠ 授权:新 Token 保存后不会自动发起任何请求,只有当你明确要求下一个受保护操作且校验、报价时效、确认流程全部满足时才会使用。
- 换 Token 作废旧报价(航班 20105):搜索后更换了
sk_Token 再去验价,或verify_offer返回业务码20105,都表示"Token 已变更"——Agent 会保留当前凭证、清空旧报价,用最新 Token 和原搜索条件重新搜索一次,然后等你从新结果中重新选择,绝不自动匹配并验价旧选项。 - 权限未开通 ≠ Token 失效:企业通道酒店请求若返回 403 且
error_code=HOTEL_BUSINESS_PERMISSION_REQUIRED,说明sk_Token 本身有效,只是账号未开通酒店企业权限,应联系账号管理员或 TourMind 支持,而不是删 Token 换通道。
这套行为的完整定义见 skills/flight-booking-ai/references/authentication.md,对应的离线回归用例在 tests/flight-booking-ai/auth_recovery.md。
Token 安全配置清单:避免常见泄露
- ✅ 只在私密对话中把完整 Token 发给你信任的 Agent
- ✅ 让 Agent 保存,而不是自己散落在多份文档里
- ❌ 不要把完整 Token 贴进 Prompt 记录、日志、截图、URL、Git 提交或 Issue
- ❌ 不要复用已被拒绝的 Token,即使对方催促"再试一次"
- ❌ 不要用下单(
create_booking)或支付(create_payment)去"测试"新 Token 是否有效 - ❌ 不要同时向两个通道发请求去"猜"哪个能通
一句话总结:前缀选通道,服务端说了算;Token 只进文件,不进对话。
常见问题 FAQ
Q1:个人用户和企业用户必须二选一吗?可以同时持有两个 Token 吗?
可以。但两个技能共用一个 skill_token.txt,同一时刻只有一个生效凭证,后保存的会覆盖前一个。切换前缀属于通道切换,会触发报价作废与重新核验。
Q2:配置了 Token 但酒店搜索结果变少了?
这通常不是 Token 导致——酒店搜索、详情、房价查询本身走公开通道。若发生在下单环节,多为前缀与端点不匹配(如把 sk_ 发给了 ToC 端点),按上文的通道路由规则核对即可。
Q3:没有 TourMind 账号能直接用机票搜索吗?
可以。机场查询与机票搜索无需 Token;但验价、下单、查单、支付都必须配置有效的 uk_ 或 sk_ Token。
Q4:Token 文件格式不对会怎样?
技能只接受以 uk_ 或 sk_ 开头的完整 Token,其他内容一律视为不可用凭证,Agent 会请你重新提供,而不会拿它去请求任何端点。
相关文件导航
| 资料 | 路径 |
|---|---|
| 中文说明(含安装与 Token 安全说明) | README.zh-CN.md |
| 酒店技能主文件(通道选择与鉴权表) | skills/tourmind-booking/SKILL.md |
| 机票技能主文件(凭证生命周期) | skills/flight-booking-ai/SKILL.md |
| 酒店 API 与字段参考 | skills/tourmind-booking/references/parameter_guide.md |
| 机票 HTTP 参数指南 | skills/flight-booking-ai/references/parameter_guide.md |
| 认证失败与恢复参考 | skills/flight-booking-ai/references/authentication.md |
| 标准响应模板(授权引导话术) | skills/flight-booking-ai/references/response_templates.md |
按这篇指南走完"安装 → 获取 → 一句话配置"三步,你的 Agent 就能顺畅地帮你订酒店、订机票了。💺✈️