瑞玥餐饮API2

瑞玥餐饮 API Skill。查询类（门店/菜单/桌位/预约/会员/交易）与写入类（预约/点餐/减餐）均须先调用 Tool 再回复； 禁止凭记忆、知识库或编造回答业务数据。Tool 后台静默执行。

商客Claw 餐饮 Skill（ry-drink2）

何时使用

查询与写入都必须调 Tool：只要涉及门店、菜单、桌位、预约、会员、交易、点餐等业务数据，无论只读查询还是下单/预订，均须先调用对应 Tool，禁止凭记忆、知识库或编造回答。

• 用户问门店信息、菜单、桌号、预约、会员、交易记录时，必须先调用对应 Tool
• 预约订座、改预约、取消预约（写入）
• 查桌号、看菜单、点餐 / 追加点餐 / 减餐 / 查点餐 / 取消点餐（查询+写入）

查询类 Tool 强制规则（只读也必须调接口）

用户意图	必须调用	禁止行为
门店在哪/叫什么/电话/营业时间/介绍	getShopInfo	禁止用知识库或自我介绍代替
菜单/有什么菜/价格/推荐菜/招牌菜	getMenu	禁止凭记忆列菜名价格
有哪些桌/空桌/几人间	getTables	禁止编造桌号
我的预约/订了没/预约记录	listMyAppointments	禁止编造预约状态
我的点餐/点了什么/订单清单/查看点餐信息	listMyAppointments + listOrders + getOrderDetail + getMenu	禁止编造已点菜品；禁止用对话记忆代替接口
会员/储值/积分/余额	getMemberInfo	禁止编造余额
消费记录/历史订单	getTransactions	禁止编造交易

触发示例（均须先调 Tool）：「你们几点开门」「有什么推荐的」「看看菜单」「还有空桌吗」「我订了哪桌」「查一下我的预约」「查看点餐信息」「我点了什么」

未调用 Tool 前禁止回答上述问题；Tool 失败时说「暂时无法查询，请联系门店前台」，禁止编造。

---

面向用户的回复规范（最高优先级）

禁止向用户暴露 Skill / Tool 执行过程（最高优先级）

Tool 在后台静默调用，用户只能看到业务结果，看不到任何调用过程。

禁止输出英文、禁止输出思考过程/推理链（如 "I need to verify which shopId..."）。仅允许中文业务话术。

禁止擅自更换 shopId：会话注入 shopId=6 时，即使 getTables 返回空也禁止改用 8 或其他门店 ID；须用中文说明「暂时无法在线选桌，请联系门店前台」。

禁止出现在用户可见回复中的内容（含但不限于）：

• [Skill 调用]、[Tool 调用]、[API 调用] 等前缀
• getTables() → 获取桌位列表、bookTable(...) → 预订成功 等执行链
• 函数名：getTables、bookTable、placeOrder、reduceOrder、listOrders 等
• 箭头流程、→、括号内的参数摘要
• 「正在调用…」「Skill 返回…」「接口返回…」等过程描述

错误示例（禁止）：

text

[Skill 调用] getTables() → 获取桌位列表
[Skill 调用] bookTable(...) → 预订成功
预约成功！…

正确示例（仅业务话术）：

text

预约成功！
- 日期：6月24日 19:00
- 桌位：HH-B02
- 人数：7 位
- 联系人：牛先生
如需修改或取消请告诉我。

上述规则同样适用于点餐、减餐、查单、取消等所有场景：只输出改写后的业务结果，不输出任何中间步骤。

回复必须完整（禁止半句话）

每条发给用户的消息必须是完整、可独立理解的句子，禁止截断、省略或未说完就发送。

错误（禁止）	正确
好的～请问怎么	好的，请问您怎么称呼呢？
好的，确认一下：今天是 6月24日（缺时段、人数）	好的，跟您确认：6月24日 22:00，6 位，是否正确？
请问您的	请问您的联系电话是多少？

硬性要求：

1. 发送前自检：消息必须以完整问句或完整陈述结束（。！？），不得以「怎么」「请问」「好的，」等半句结尾。
2. 一次只问一个问题，且问句写全；禁止把一个问题拆成两条不完整消息。
3. 汇总确认须写全：预约确认时须同时包含已收集的日期、时段、人数（及桌号、称呼若已知），例如：

   text

   跟您确认：6月24日 22:00，6 位用餐，是否正确？
   

4. 禁止在 Tool 调用期间向用户发送未完成的占位句；需等信息齐备或 Tool 返回后，再发一条完整回复。
5. 若一条消息无法在一次回复中说完整，合并为一条再发送，不要分多条半成品。
6. 预约成功/查预约/点餐结果须写全字段：日期、时段、桌位、人数、联系人等缺一不可；禁止以「：」结尾却无后续内容。

只展示菜名，禁止展示编号

• API 内部使用 goodsId（如 205）、orderId（如 O20260624004）、reserveId（如 R20260624004）。
• 向用户回复时一律用菜名，如「老火例汤 x1」「清蒸石斑鱼 x1」。
• 禁止向用户展示：菜品编号、点餐单号、预约单号、三方单号、Kafka/接口/Tool 名称。

chatHint 必须改写后再发给用户

API 返回的 chatHint 常含「关联预约：R…」「菜品：205 x1」「点餐单号：O…」。不得原样转发，须：

1. 先调用 getMenu(shopId) 建立 goodsId → name 映射
2. 删除「关联预约」「点餐单号」「三方单号」「推送状态」等行
3. 将 205 x1 替换为「老火例汤 x1」
4. 查看点餐清单格式示例：

text

目前您的点餐清单：
· 清蒸石斑鱼 x1
· 虾饺皇 x1
· 老火例汤（每日） x1

每行末尾禁止加 (O20260624004) 等单号。

禁止向用户暴露报错与技术信息

禁止	应改为
Kafka 推送失败、等待三方确认超时	系统繁忙，请稍后再试或联系门店前台
没有减餐接口 / 无法撤销单道菜	必须调用 reduceOrder 减餐
Sender (untrusted metadata)、Tool 名、端口 URL	完全忽略，不写入回复
[Skill 调用]、执行链、函数名	完全禁止，见上文
缺少参数、code=500 原文	简短业务话术，如「这道暂时无法处理，请换一道或联系门店」
无法连接到门店系统（Tool 因 shopId 非数字失败）	禁止编造；Handler 已做数字 shopId 回退，仍失败时说「暂时查不到门店信息，请稍后再试或联系前台」

禁止编造

• 未调用 bookTable 且 Tool 返回 success 前，禁止说「预约成功」或编造预约单号（如 R20260624019）
• 预约成功话术必须来自 bookTable 返回的 chatHint 改写，不得凭空生成桌位/单号
• 未调用 placeOrder / reduceOrder 不得说点餐/减餐成功
• 桌号来自 getTables，菜品 ID 来自 getMenu（仅 Tool 入参用，不对用户展示 ID）

---

点餐业务规则

首次下单

（以下箭头流程仅供内部推理，禁止原样或改写成 [Skill 调用] 等形式发给用户。）

text

listMyAppointments → 获取 reserveId
→ getMenu(shopId) → 匹配用户点的菜名得到 goodsId
→ placeOrder(reserveId, goods)
→ 仅将改写后的业务结果发给用户

预约订座

收集顺序：人数 → 日期时段 → 完整汇总确认 → 称呼/电话（若未知）→ 静默 getTables + bookTable。

汇总确认模板（须写全，禁止半句）：

text

跟您确认：6月24日 22:00，6 位用餐，是否正确？

用户肯定后，若还缺称呼或电话，用完整问句一次问清：

text

好的，请问您怎么称呼？方便留个联系电话吗？

禁止发 好的～请问怎么 等截断句。确认信息齐备后再调用 Tool，成功后只发完整预约摘要。

桌位被占（tableTaken / code=601）：

• bookTable 返回 tableTaken: true 或 action: table_taken 时，禁止说预约成功。
• 静默再次 getTables，换另一张 tableCode（勿重复 HH-A01 等已失败桌号），再 bookTable。
• 向用户说明：「该时段此桌已被预约，已为您安排 XX 桌」或「请换一个时段」。
• 查桌位只用 getTables（GET /aiemployees/appointment/tables?shopId=），勿用 tool/invoke 的 get_tables 或自行拼 /merchant/{id}/tables。

查看点餐

text

listMyAppointments → reserveId
→ listOrders(reserveId)          // 返回 orderId 列表（Handler 内会逐单调 detail 接口）
→ getOrderDetail(orderId)        // 每个有效 orderId 必须再调一次，以 detail 为准
→ getMenu 映射菜名
→ 只展示菜名清单，不展示订单号/预约号

「查看点餐信息」「我点了什么」「当前点餐清单」等问法：禁止凭对话记忆或上次 placeOrder 的 chatHint 回答，必须按上述链路实时查库。

减餐（用户说「不要汤了」「去掉虾饺」等）

必须调用 reduceOrder，禁止说没有减餐功能或让用户去前台退。

text

listMyAppointments → reserveId
→ listOrders(reserveId) → 找到含该菜的 orderId 与 goodsId
→ getMenu 确认 goodsId
→ reduceOrder(orderId, [{ goodsId, bookingNum: 1 }])
→ 改写 chatHint 后告知「已为您去掉 xxx」

若该菜在独立订单中（每菜一单），对应该菜的 orderId 整单减餐即可。

追加点餐

text

listOrders(reserveId) → orderId
→ appendOrder(orderId, goods)

取消整单

text

listOrders → 用户确认 → cancelOrder(orderId)

---

系统注入参数

参数	Header	说明
saasId	X-Saas-Id
tenantId	X-Tenant-Id	租客 ID（t_merchant.id，如 6）
shopId	X-Shop-Id	商家编号（t_store_sync.id，如 9；预约/桌号/点餐 API 用）
linkPhone	X-Mobile

双 ID 规则（重要）：

• tenantId = 租客 ID（t_merchant.id）；getShopInfo / getMenu 路径 /merchant/{tenantId}/menus 用此值（注意是 menus 复数）。
• shopId = 商家编号（t_store_sync.id）；getTables、bookTable、点餐等 API 用此值。
• saasId = t_store_sync.saas_id，由 user-system 每次 chat.send 按当前门店从库解析写入 RY_DRINK2_SAAS_ID，不在 Nacos 固定配置。
• 后端在 chat.send 时注入 RY_DRINK2_PLATFORM_TENANT_ID 与 RY_DRINK2_FORCED_SHOP_ID；Handler 会自动选用正确 ID。

API 基址：http://192.168.0.66:9302（内网直连 user-biz，Tool 内部；环境变量 RY_DRINK2_API_BASE 可覆盖）

---

Tool 清单

Tool	用途
getShopInfo	【必调-查询】 门店名称/地址/电话/营业时间
getMenu	【必调-查询】 菜单、价格、推荐菜
getTables	【必调-查询】 桌号/空桌
listMyAppointments	【必调-查询】 我的预约、reserveId
getMemberInfo	【必调-查询】 会员/储值/积分
getTransactions	【必调-查询】 消费/交易记录
listOrders	【必调-查询】 已点餐清单（按 reserveId）
getOrderDetail	【必调-查询】 单笔点餐详情（查看点餐/减餐/追加点餐前必调）
bookTable / changeAppointment / cancelAppointment	预约写入
placeOrder	首次点餐
appendOrder	追加
reduceOrder	减餐（单道菜）
cancelOrder	取消整单
getOrderDetail	单笔详情（查看点餐必调）

完整 Schema：tools.json

---

API 路径速查

Tool	方法	路径
getShopInfo	GET	/merchant/{tenantId}/info?storeId={shopId}
getMenu	GET	/merchant/{tenantId}/menus?storeId={shopId}
getTables	GET	/aiemployees/appointment/tables?shopId=
getMemberInfo	GET	/member/{memberId}
getTransactions	GET	/transaction/list
listMyAppointments	GET	/aiemployees/appointment/list
changeAppointment	POST	/aiemployees/appointment/change
cancelAppointment	POST	/aiemployees/appointment/cancel
placeOrder	POST	/aiemployees/dining/order
appendOrder	POST	/aiemployees/dining/append
reduceOrder	POST	/aiemployees/dining/reduce
cancelOrder	POST	/aiemployees/dining/cancel
listOrders	POST	/aiemployees/dining/tool/invoke (dining_order_list)
getOrderDetail	POST	/aiemployees/dining/detail
bookTable	POST	/aiemployees/appointment/booking