跳到主要内容

设置语音助手提示词

快速设置

约 5 分钟即可设置欢迎语、兜底回复和指令。

本指南帮助你控制客人使用语音助手时听到的内容。

本指南还说明了当存在文件 ID 时，主题建议如何优先使用 Vertex RAG。 如果没有文件 ID，助手仍会回退到旧版检索。 你也可以调整语音回复时序。 网关现在会等待最终转写结果，然后再使用明确的音频轮次。 在客人发言期间，AVA 显示语音查询进度的次数不会超过一次。

运行时默认值

如果未设置 OPENAI_REALTIME_MODEL，AVA 会使用 gpt-realtime-2.1-mini。 如果团队希望使用其他 Realtime 模型，请显式设置该变量。

Vertex AI 平台

语音回复使用与聊天机器人回复相同的已配置 Vertex AI 平台。 如果语音答案看起来异常，请先确认平台设置。

前往： Chatbot → Voice Setup

快速参考​

设置控制内容客人体验
Voice Welcome Message语音会话中的首句播报客人听到清晰的酒店欢迎语
Voice Default Answer无可靠答案时的回复客人仍能收到礼貌回应
Instruction语音 AI 的语气与行为指导回复符合酒店沟通风格
Topic Suggestions常见客人问题的侧边栏提示客人会看到 Vertex RAG 建议或旧版回退主题
RAG Request Timeout等待语音回答的最长时间较慢的回复会持续运行，直到达到上限
First Chunk Timeout等待流式回答第一段内容的时间更长的停顿会更早终止卡住的 AI 回复
Stream Idle Timeout等待流式分段之间内容的时间断流会在长时间挂起前失败

套餐权限​

  • 语音设置需要付费套餐。
  • 免费套餐账号会显示升级提示，且无法保存语音设置。

升级请前往 Settings → Billing & Subscription。

开始前​

请确认以下条件：

  • 你有管理 Chatbot 设置的权限
  • 你的套餐包含 AI Chatbot 功能
  • 你已确定欢迎语与兜底回复措辞
  • 你的技术团队了解当前语音网关的超时设置

配置语音消息​

  1. 前往 Chatbot → Voice Setup

  2. 在 Voice Messages 中更新 Voice Welcome Message

  3. 更新 Voice Default Answer

  4. 在每个卡片点击 Save

    ✓ 会显示成功提示。 ✓ 按钮旁会显示保存时间戳。

设置语音指令​

  1. 在同一页面找到 Voice Instruction

  2. 描述语气、措辞规则与兜底行为

  3. 点击 Save

    ✓ 指令会保存并用于后续语音回复。

当指令为空时

保存空白指令会应用默认的友好语音指令。

使用客人入住信息和客房服务请求​

语音助手可以使用已验证的当前入住详情回答客人问题。 对于静态房间 QR 会话，当扫描房间与恰好一条当前在店入住记录匹配时，AVA 会在使用语音前刷新链接。 当你的 PMS 能力契约支持该状态时，AVA 也允许一条原生 DUE_OUT 入住记录匹配。 否则，静态房间 QR 查询只匹配 CHECKED_IN 入住记录。 查询使用 QR 代码中编码的确切房间值。 对于静态位置 QR 会话，AVA 只保留位置上下文。 它不会执行预订验证、入住关联或基于预订的视频丰富。 它还可以帮助客人请求已配置的客人服务。

客人请求语音助手行为
询问当前入住情况使用该客人可用的已验证预订上下文
请求客人服务重复请求，并在提交前要求客人确认
请求缺少必要详情说明缺少哪些信息，或提供可用服务
询问入住前的房间不会通过语音流程透露入住前的房间号
使用位置 QR 会话使用位置上下文，不使用预订详情
需要确认

只有客人明确确认后，客人服务请求才会提交或取消。 如果对话内容发生变化，客人必须再次确认请求。 确认后，AVA 会提交客人审核过的已准备请求。 客人只需确认语音中说出的请求，不需要提供内部请求字段。 如果请求无法验证，助手会继续提供对客人安全的说明。 它可以询问缺少的详情，或提供酒店已配置的服务。

测试客人语音请求​

  1. 使用已验证的当前入住测试预订启动语音会话。

  2. 询问与入住相关的问题。

  3. 请求一项客人服务，例如额外毛巾。

  4. 助手重复请求时确认该请求。

    ✓ 助手会使用可用的入住信息回答。 ✓ 只有确认后，请求才会提交。

测试时，在未提供所有必要详情的情况下请求一项服务。

✓ 助手会说明需要哪些信息。 ✓ 助手可以提供可用服务，而不是给出笼统的拒绝。

使用入住前测试预订，确认其房间号仍然保持私密。

处理可选语音助手​

语音侧边栏会向网关请求建议主题。

当请求包含 Vertex RAG 文件 ID 时，AVA 会先读取这些文档。 其他可选语音助手（例如转写词库和知识覆盖检查）也使用相同模式。 如果没有文件 ID，AVA 会改用旧版向量存储。 明确的音频轮次现在会等到最终转写完成后，才会触发 RAG。 这样可以避免在麦克风静音或不可用时触发无关工具调用。

这样可以让语音流程继续运行，而不是显示 502 错误。

你会看到： 主题列表为空，或者看起来是旧的。

解决方法：

  1. 保持语音会话开启并继续对话
  2. 如果你预期有更新的建议，请刷新页面
  3. 确认相关 Chatbot 文档已标记为 Active
  4. 确认语音请求包含 Vertex RAG 文件 ID
  5. 确认网关可以访问聊天微服务
有哪些变化

语音助手现在采用故障开放策略。 即使助手数据不可用，客人也可以继续。

音频轮次没有触发预期回复​

你会看到： 客人说话了，但助手忽略了这次轮次，或者回答很晚。

解决方法：

  1. 确认麦克风可用且没有静音
  2. 在再次测试前，等待转写完成
  3. 如果该轮次已被后续内容覆盖，请开启新的语音会话
  4. 在任何运行时变更后重新部署语音网关
原因说明

在网关拿到最终转写结果之前，它会拒绝显式的音频工具调用。 这样可以避免静音或不完整音频轮次触发无关的 RAG 查询。

调整语音回复时序​

当语音回答感觉太慢，或者在回复中途卡住时，使用这些网关设置。

设置控制内容默认值
VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS完整 RAG 请求的最长时间60000
VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS等待第一段流式内容的时间30000
VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS等待流式内容各段之间的时间15000

这些超时如何工作​

  • 流式回复会先使用首段超时。
  • 收到第一段后，空闲超时会保护正在进行的流式传输。
  • 非流式回复只使用最长请求超时。
  • 网关会把默认最长请求超时提高到 60 秒。

何时调整​

你会看到： 助手在慢速回答完成前就停止了。

解决方法：

  1. 提高 VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
  2. 如果回答仍然超时，再提高 VOICE_GATEWAY_RAG_REQUEST_TIMEOUT_MS
  3. 如果流式内容在分段之间停顿，再提高 VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS
  4. 修改环境变量后重新部署语音网关

你会看到： 回答还在运行，但一段时间内没有内容返回。

解决方法：

  1. 降低 VOICE_GATEWAY_RAG_FIRST_CHUNK_TIMEOUT_MS
  2. 降低 VOICE_GATEWAY_RAG_STREAM_IDLE_TIMEOUT_MS
  3. 保持最长请求超时时间足够高，以适配你的 AI 提供商
  1. 保持 Voice Welcome Message 简短自然
  2. 保持 Voice Default Answer 礼貌并给出行动指引
  3. 使用 Instruction 记录稳定规则，而不是一次性通知
优秀兜底回复示例

“抱歉，我暂时没有这项信息。请联系前台团队获取帮助。”

故障排查​

保存时报 “Invalid content”​

你会看到： 点击 Save 后出现校验错误。

解决方法：

  1. 确认字段是纯文本
  2. 删除过长文本块
  3. 再次保存

语音回复不符合指令​

你会看到： 客人听到的回复语气与预期不一致。

解决方法：

  1. 打开 Instruction 并写得更具体
  2. 点击 Save
  3. 开启新的语音会话再次测试

Voice Setup 页面缺失​

你会看到： 侧边栏找不到 Voice Setup。

解决方法：

  1. 确认套餐包含 AI Chatbot 工具
  2. 确认角色具有 Chatbot 设置权限
  3. 权限调整后刷新页面

主题建议看起来是空的​

你会看到： 语音侧边栏没有任何建议主题。

解决方法：

  1. 继续使用语音流程
  2. 检查相关 Chatbot 文档是否仍在 Processing
  3. 验证网关可以访问聊天微服务
  4. 如果列表一直像旧的，检查缓存的主题设置

客人服务请求没有提交​

你会看到： 助手重复客人服务请求，但没有提交请求。

解决方法：

  1. 清楚地回答助手的确认问题。
  2. 如果对话切换了主题，重新说出客人服务请求。
  3. 如果确认提示已过期，开启新的语音会话。
  4. 如果已确认的请求仍未提交，请联系支持团队。

助手要求提供更多请求详情​

你会看到： 助手询问缺少的信息，或建议可用服务。

解决方法：

这是客房服务请求尚未完成验证时的预期行为。 提供所要求的详情，然后确认完整请求。

语音播报了入住前的房间号​

你会看到： 客人在入住前，助手播报了房间号。

解决方法：

  1. 结束语音会话。
  2. 记录客人的预订和通话详情。
  3. 立即联系支持团队进行审核。

仍未解决？​

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

  • ❌ 多次重试后仍无法保存
  • ❌ 语音回复忽略已保存提示词
  • ❌ 调整网关设置后语音回复仍然超时
  • ❌ 问题持续超过 30 分钟

建议附上：

  • Voice Setup 页面截图
  • 你尝试保存的完整文本
  • 当前使用的超时值
  • 问题开始时间