需通过腾讯云COS上传标准CSV房态数据并结构化导入扣子知识库，绑定字段后启用向量检索；再用Python代码工具实现多日期库存校验，配合API密钥调用知识库，最后通过Webhook异步验证PMS写入结果以防超售。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让客人在微信里直接查房态、选房、下单，不跳转网页也不装APP，但扣子平台默认不支持酒店特有的多日期库存校验和状态流转逻辑。
准备酒店房态数据源
登录酒店PMS系统导出最新房态CSV，确保包含字段：room_id、room_type、date、status（可用/已订/维修/脏房）、price。注意【date字段必须为YYYY-MM-DD格式，且不能含空格或中文】。
将CSV上传至腾讯云COS桶，设为公共读权限，获取直链URL。这一步不能用本地文件或百度网盘链接——扣子Bot无法访问非HTTPS公开直链。
在扣子中创建知识库并结构化导入
进入扣子后台→知识库→新建知识库→选择“上传文件”→粘贴COS直链→点击解析。
系统自动识别字段后，在映射界面手动将CSV列绑定到语义字段：date→日期，room_type→房型，status→房间状态，price→价格，room_id→房间号。这一步若绑错，后续所有查询都会返回“查不到房间”。
勾选“启用向量检索”，保存并等待索引完成（通常2–3分钟）。【不要跳过索引等待，未完成就测试会导致100%返回空结果】。
配置多日期库存校验逻辑
扣子原生不支持跨日期比对，需用自定义工具函数补足：
在Bot设置→插件→新增工具→选择“代码工具”→语言选Python→粘贴以下代码：
def check_availability(start_date, end_date, room_type):
# 调用知识库API批量查指定房型在日期区间内每天的状态
# 返回True仅当每一天该房型均有≥1间status=可用
这段代码不能直接运行，需配合知识库API密钥与请求头补全。密钥在知识库详情页右上角“API凭证”中复制，填入代码第3行的headers参数里。
保存工具后，在Bot流程中添加“调用工具”节点，触发条件设为用户输入含“从X月X日住到Y月Y日”类句式。
设计预订确认话术与防超售拦截
当工具返回True时，Bot推送可选房间列表，每条带“立即锁定”按钮；返回False时，直接回复“该时段{room_type}已满，请换日期或房型”。
用户点“立即锁定”后，Bot调用酒店PMS预留接口（需提前在扣子Webhook中配置），传参包括room_id、guest_name、phone、入住离店时间。接口返回success才生成订单号，否则提示“锁定失败，请重试”。
这一步必须做异步回调验证——如果只前端显示“已锁定”，而PMS实际写入失败，就会导致超售。扣子Webhook响应超时阈值设为8秒，低于此值PMS未返回即判定失败。
