Tourmind-Booking-Skills的Token如何配置?uk_个人通道与sk_企业通道完全解析

原创2026-10-11 00:57:472,171 阅读

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":

  1. 单 Token 双技能共享:酒店技能与机票技能使用同一个 TourMind Skill Token。解析顺序是先读当前技能目录的 {baseDir}/skill_token.txt,若为空再回退到兄弟技能目录的 skill_token.txt,取到第一个非空凭证即生效。
  2. 机票通道:两个通道共用同一 Base URL 与端点路径,Token 只通过 X-Skill-Token 请求头传输,绝不放入 JSON 请求体或 URL。
  3. 酒店通道:无 Token 走公开个人通道;uk_ 走认证个人通道;sk_ 走企业通道,且每个企业端点都要求携带 token。
  4. 通道切换 = 报价作废:从 uk_ 切到 sk_(或反向)时,此前返回的所有房价、rate_code、取消政策、库存状态全部失效,Agent 会用新通道重新查询实时房型、重新核验价格,并要求你重新确认预订详情。
  5. 订单绑定创建通道:订单创建后,后续的支付、查询、取消必须继续使用创建订单时同一前缀的凭证,不能"跨通道"访问,更不能两个通道轮流试探。

完整的端点契约(包括 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)时,技能内置了一套"先止损、再换证"的恢复机制:

  1. 立即清除:Agent 会把被拒绝的 Token 从其来源文件与可复用的请求头中删除,并停止当前受保护操作——不会自动重试被拒凭证。
  2. 按前缀换新:uk_ 失效 → 引导到 Journione 登录页获取新 Token;sk_ 失效 → 引导到 TourMind 私有 Token 页;若前缀未知,则同时展示两个选项。
  3. 保存 ≠ 授权:新 Token 保存后不会自动发起任何请求,只有当你明确要求下一个受保护操作且校验、报价时效、确认流程全部满足时才会使用。
  4. 换 Token 作废旧报价(航班 20105):搜索后更换了 sk_ Token 再去验价,或 verify_offer 返回业务码 20105,都表示"Token 已变更"——Agent 会保留当前凭证、清空旧报价,用最新 Token 和原搜索条件重新搜索一次,然后等你从新结果中重新选择,绝不自动匹配并验价旧选项。
  5. 权限未开通 ≠ 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 就能顺畅地帮你订酒店、订机票了。💺✈️

登录后查看全文
Tourmind-Booking-Skills