跳到主要内容

设置 Chatbot

快速设置

大多数酒店大约 7 分钟就能完成消息、机器人指令和 Live Chat 时段设置。

本指南帮助你配置 Chatbot 消息、回复行为、访问权限和 Live Chat 时段。 当你需要统一的客人回复和下班后处理时，可使用本指南。

前往： Chatbot → Setup

快速参考​

任务点击位置结果
设置欢迎消息Bot Configuration → Welcome Message客人会先看到你的问候语
设置兜底回复Bot Configuration → Default Answer没有匹配项时，客人会收到回复
定义机器人的语气Bot Configuration → Bot InstructionChatbot 会按你的指引回复
选择答案引擎Advanced Settings → Answer Engine可在 RAG 和 Agent (Pi) 之间切换
调整回复风格Advanced Settings控制 temperature、token 上限、检索深度和 grounding 模式
启用 Skill ModeAdvanced Settings → Skill Mode使用你配置的 Vertex ADK skill 生成流式 GenAI 回复
运行 Quick SetupQuick Setup预填消息和语气
选择聊天模式Widget & Access → Chat modeAI、live chat 或混合模式
设置 Live Chat 时段Widget & Access → Operating Hours员工只在开放时段内回复
创建落地页Widget & Access → Create Landing Page会出现客人链接和 QR 选项
允许 widget 域名Widget & Access → Whitelisted Domainswidget 会在你的网站上加载

套餐权限​

  • Chatbot 设置需要付费套餐。
  • 免费套餐账号会看到升级提示，且无法保存更改。

要升级，请前往 Settings → Billing & Subscription。

开始之前​

请先确认以下要求：

  • 你有权限管理 Chatbot 设置
  • 你的套餐包含 Chatbot 功能
  • 你知道希望机器人使用的语气

配置机器人消息​

  1. 前往 Chatbot → Setup

  2. 保持在 Bot Configuration 标签页

  3. 用简短问候语更新 Welcome Message

  4. 用有帮助的兜底回复更新 Default Answer

  5. 在每个卡片下点击 Save

    ✓ 会出现成功提示。

设置机器人指令​

  1. 在 Bot Instruction 中描述语气和规则

  2. 点击 Save

    ✓ 该指令会被保存并供 Chatbot 使用。

优秀指令示例

“保持简洁友好。如果不确定，请先追问一个后续问题。”

设置高级回复参数​

  1. 点击页面顶部的 Advanced Settings。

  2. 在 Answer Engine 中选择 RAG 或 Agent (Pi)。

  3. 查看 Generation 区域里的回复行为设置。

  4. 如果选择 RAG，再查看 Retrieval 区域。

  5. 在 Retrieval 中打开或关闭 Disable grounding RAG engine。

  6. 将数值设置在以下范围内：

    • Temperature: 0 到 1
    • Top P: 0 到 1
    • Max Output Tokens: 500 到 3024
    • Retrieval K: 1 到 7

  7. 如果打开了 Disable grounding RAG engine，请将 Retrieval K 保持在 1 到 3 之间。

  8. 点击 Save。

    ✓ 保存成功后，弹窗会关闭。

这些设置控制什么

数值越低，回复越聚焦。数值越高，回复变化越多。 RAG 会使用你的 Chatbot 文档和检索设置。 Agent (Pi) 会在弹窗中隐藏仅 RAG 可见的控件。 打开 Disable grounding RAG engine 后，系统会在回答前直接预取上下文。 这会消耗更多 token，但检索更可靠。 这些设置会影响 Chatbot 回复和已连接的语音流程。

使用 Skill Mode​

当你的 GenAI 设置需要通过 Vertex ADK 流式输出回复时，使用 Skill Mode。

  1. 点击 Advanced Settings。

  2. 打开 Use Skill Mode。

  3. 输入一个 Skill Name，例如 booking-assistant。

  4. 点击 Save。

    ✓ 重新打开 Advanced Settings 后，该设置仍会保持开启。 ✓ 弹窗会保留你的 skill 名称。

Skill name 规则

你的 Skill Name 只能使用小写字母、数字和连字符。 当 Use Skill Mode 开启时，该字段为必填。 Vertex ADK 会在后台运行该 skill。

如果 skill 没有出现

请让管理员在添加或更新 skill 包后重启 Streamliner。 如果 skill 仍未加载，请确认 skill 名称与包名完全一致。

使用 Quick Setup（可选）​

  1. 点击页面顶部的 Quick Setup
  2. 按向导生成消息和语气
  3. 在各字段中检查结果
  4. 在你想保留的每个部分点击 Save

选择聊天模式​

  1. 打开 Widget & Access 标签页

  2. 选择一种模式：

    • AI only
    • Live chat only
    • Hybrid (AI + live chat)

    ✓ 所选模式会高亮并生效。

设置 Live Chat 时段​

当客人只应在有员工值守的时段联系到员工时，使用 Live Chat 时段。 排期会使用你酒店的时区。 在开放时间之外，客人会看到你的离开消息。 每个工作日都可以设置多个时段。

  1. 打开 Widget & Access 标签页。

  2. 打开 Limit live chat to operating hours。

  3. 检查 Timezone 标签。

  4. 如果不正确，请在 Settings → Essentials → Hotel Basic Details 中更新 Timezone。

  5. 为每个工作日添加开放时段。

  6. 使用 Copy Mon → weekdays、Copy Mon → all days、Set 24/7 或 Clear all 更快填充。

  7. 当某天保持关闭时，使用 Open this day。

  8. 点击 Save changes。

    ✓ 状态标签会显示 Open now 或 Closed now。 ✓ 客人只能在开放时段联系到员工。 ✓ 在开放时间外，客人会看到你的离开消息。 ✓ 回复会使用最新排期。 ✓ 无效时间会显示红色边框和辅助文本。

安全的排期回退

如果排期数据不完整或格式有误，Streamliner 会加载安全回退排期。 你仍然可以打开页面、检查编辑器，并保存修正后的排期。

只读时区

此页面上的时区始终与你酒店的时区一致。 使用 Change 链接可打开 Settings → Essentials → Hotel Basic Details。

创建落地页链接​

  1. 在 Widget & Access 中找到 Landing Pages

  2. 点击 Create Landing Page

    ✓ 会出现一个新的客人访问链接。

  3. 使用 View QR 预览客人代码。

  4. 如果你需要为客房或欢迎区域准备印刷标识，请点击 Download chatbot QR。

管理白名单域名​

  1. 在 Whitelisted Domains 中输入一个域名，例如 yourhotel.com
  2. 点击 Add Domain
  3. 使用开关启用或停用该域名
  4. 只有在希望 widget 不再在该域名上工作时，才删除它

故障排查​

保存按钮被禁用​

你会看到： 你无法保存消息或指令。

解决方法：

  1. 确保字段不为空
  2. 删除多余空格后重试
  3. 确认你的套餐包含 Chatbot 功能

高级设置无法保存​

你会看到： Save 按钮一直不可用，或者显示校验错误。

解决方法：

  1. 等待当前高级值加载完成
  2. 检查所有红色校验提示
  3. 将 Max Output Tokens 保持在 500 到 3024 之间
  4. 将 Retrieval K 保持在 1 到 7 之间
  5. 如果 Disable grounding RAG engine 已开启，请将 Retrieval K 保持在 1 到 3 之间
  6. 再次尝试 Save

缺少 RAG 控件​

你会看到： 找不到 Retrieval K 或 Disable grounding RAG engine。

解决方法：

  1. 打开 Advanced Settings

  2. 检查当前 Answer Engine

  3. 选择 RAG

  4. 点击 Save

    ✓ 仅适用于 RAG 的控件会重新出现。

Retrieval K 看起来太低​

你会看到： Retrieval K 只能取 1 到 3。

解决方法：

  1. 关闭 Disable grounding RAG engine
  2. 重新检查 Retrieval K
  3. 保存更新后的设置

Skill Mode 无法保存​

你会看到： 打开 Use Skill Mode 后保存失败。

解决方法：

  1. 确认 Skill Name 不是空白
  2. 仅使用小写字母、数字和连字符
  3. 试试像 booking-assistant 这样的名称
  4. 再次点击 Save

Skill Mode 找不到 skill​

你会看到： 部署后某个 skill 没有出现。

解决方法：

  1. 等待下一次部署完成。
  2. 确认 skill 包名与 Skill Name 完全一致。
  3. 如果 skill 是在启动后才添加的，请让管理员重启 Streamliner。
  4. 如果 skill 仍未加载，请联系支持。

落地页无法创建​

你会看到： 创建落地页时出现错误。

解决方法：

  1. 刷新页面后重试
  2. 按提示替换旧页面
  3. 如果仍失败，请联系支持

域名开关不起作用​

你会看到： 开关切换后又恢复原状。

解决方法：

  1. 刷新页面
  2. 删除该域名后重新添加
  3. 再次尝试切换开关

客人在开放时间外看到离开消息​

你会看到： 客人在你预期应回复的时段却收到了离开消息。

解决方法：

  1. 打开 Widget & Access。
  2. 检查 Limit live chat to operating hours 是否开启。
  3. 确认当前日期是开放的。
  4. 检查 Timezone 标签是否与 Settings → Essentials → Hotel Basic Details 一致。
  5. 更改后重新保存。
  6. 如果排期刚刚变更，请刷新 widget 并等待下一个切换点。

仍有问题？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 多次尝试后仍无法保存
  • ❌ 落地页无法创建
  • ❌ 问题持续超过 30 分钟

建议附上：

  • Chatbot 设置页截图
  • 你尝试的操作和错误信息
  • 问题开始时间