changedInput schema / properties / adults / description
Previous value: -"Number of adults in each room"New value: +"每房成人数,不是所有房间合计;相同入住配置应用于每间房。有效入住人数必须大于 0。 此入口不提供默认值;在使用入住条件时必须显式提供。"
changedInput schema / properties / check_in_date / description
Previous value: -"Check-in date in YYYY-MM-DD format"New value: +"入住日期,YYYY-MM-DD。 此入口不提供默认值;在使用入住条件时必须显式提供。"
changedInput schema / properties / check_out_date / description
Previous value: -"Check-out date in YYYY-MM-DD format"New value: +"离店日期,YYYY-MM-DD,必须晚于 check_in_date。 此入口不提供默认值;在使用入住条件时必须显式提供。"
changedInput schema / properties / children / description
Previous value: -"Number of children in each room"New value: +"每房儿童数,非负整数;省略或 0 表示无儿童,必须等于 children_ages 数组长度。"
changedInput schema / properties / children_ages / description
Previous value: -"Ages of the children in each room, each from 0 to 17"New value: +"每房儿童年龄数组,逐个为 0–17 岁整数;数组长度必须等于 children,同一组年龄应用于每间房。省略/null/[] 只适用于 children=0。"
changedInput schema / properties / contact_email / description
Previous value: -"Contact email for booking status notifications"New value: +"订单通知邮箱,可省略;应向用户核实,不编造。"
changedInput schema / properties / contact_phone / description
Previous value: -"Contact phone including country code"New value: +"联系手机号,可带国家码;最多 32 字节,不允许换行。可省略。"
changedInput schema / properties / currency / description
Previous value: -"Three-letter booking currency code"New value: +"核实报价的 ISO 4217 币种;订单实际以鉴权账号结算币种为准,本参数不改变账号币种。"
changedInput schema / properties / guest_name / description
Previous value: -"Guest full legal name"New value: +"入住人法定全名;现有 MCP Schema 要求该字段始终存在。未提供非空 rooms 时业务处理器按本字段解析姓名;rooms 非空时优先使用其姓名。"
changedInput schema / properties / hotel_id / description
Previous value: -"TourMind hotel identifier"New value: +"TourMind 酒店 ID,数字字符串;从地点/酒店搜索返回取得,不使用 Google place_id。"
changedInput schema / properties / rate_code / description
Previous value: -"Verified rate code returned by check_room_availability"New value: +"不透明报价代码,原样传递;验价使用 query_room_rates 返回值,下单使用 check_room_availability 最新返回值,酒店/日期/入住人数必须一致。"
changedInput schema / properties / room_count / description
Previous value: -"Number of rooms using the same occupancy"New value: +"相同入住配置的房间数;业务处理器将 0 按 1 间处理,负数无效。查询工具可省略;下单工具原有 MCP Schema 要求此字段存在。"
changedInput schema / properties / rooms / description
Previous value: -"Named guests grouped by room; when supplied length must equal room_count"New value: +"按房间分组的入住人,提供非空数组时长度必须等于有效 room_count;每房至少 1 名、最多 adults 名,优先于 guest_name。"
addedInput schema / properties / rooms / items / properties / guests / description
Added value: +"本房间入住成人名单,至少 1 名且不超过 adults;不作为儿童年龄列表。"
addedInput schema / properties / rooms / items / properties / guests / items / properties / firstName / description
Added value: +"入住人证件上的名;须非空白,原始值最多 50 个 Unicode 字符,不能含控制字符。"
addedInput schema / properties / rooms / items / properties / guests / items / properties / lastName / description
Added value: +"入住人证件上的姓;须非空白,原始值最多 50 个 Unicode 字符,不能含控制字符。"
changedInput schema / properties / total_price / description
Previous value: -"Verified total booking price"New value: +"最新验价的全部房间、整段入住总价,currency 主单位,必须大于 0;未含另列 Stripe 手续费。价格变化须先征得用户确认。"
changedInput schema / properties / user_key / description
Previous value: -"TourMind user key required for authenticated ToC booking"New value: +"由可信本地客户端配置的 TourMind 用户凭证;勿让用户在聊天中粘贴。普通 ToC 查询可省略,订单/支付操作必填;OAuth 与 ToB 不接受此字段。"
addedOutput schema / description
Added value: +"返回字段说明(不增加校验约束;缺失、零值和 null 按各字段说明解释):\n返回值 [object] 必有字段=ok: 业务响应信封;字段缺失表示没有提供,不能自动补零。数组的 null 与 [] 都不含条目,但 null 不承诺完成了该部分查询。\n返回值.data [object] 必有字段=agent_ref_id,total_price,currency,status,message: 订单创建结果,不代表支付成功。\n返回值.data.agent_ref_id [string]: TourMind 订单号;用于后续查询、支付和取消,不是酒店确认号。\n返回值.data.currency [string]: 账号结算币种,ISO 4217。\n返回值.data.message [string]: 订单创建结果及下一步支付说明。\n返回值.data.status [string] 取值=[\"confirmed\"]: 创建接口固定返回 confirmed,不能据此认定已付款或供应商已确认;以 query_booking 状态为准。\n返回值.data.total_price [number]: 全部房间、整段入住的订单总价,使用对应币种主单位(如 CNY 元),不是分;未包含另列的 Stripe 手续费,酒店到店收取费用以政策及 exclusions 为准。\n返回值.error [string]: 业务失败说明,不作为可重试或成功的唯一依据。\n返回值.error_code [string]: 鉴权等机器可读错误码,仅在错误路径提供。\n返回值.ok [boolean]: 业务是否成功。false 时读取 error/reason;工具执行错误也可能通过 MCP isError 返回而没有 structuredContent。\n返回值.reason [string] 取值=[\"invalid_request\",\"hotel_not_found\",\"upstream_timeout\",\"upstream_error\",\"hotel_detail_unavailable\"]: 失败原因:invalid_request=参数无效,hotel_not_found=酒店不存在,upstream_timeout=上游超时,upstream_error=上游失败,hotel_detail_unavailable=酒店详情不可用。成功空结果的 no_matching_live_room 位于 data.reason;批量逐项判断,不把一项失败当成整批失败。\n返回值 的分支 1:\n返回值 必有字段=data\n返回值.ok 取值=[true]\n返回值 的分支 2:\n返回值 必有字段=error,reason\n返回值.ok 取值=[false]\n"