跳到主要内容

设置语音助手提示词

快速设置

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

本指南帮助你控制客人使用语音助手时听到的内容。 它还说明了当存在文件 ID 时，主题建议如何优先使用 Vertex RAG。 如果没有文件 ID，助手仍会回退到旧版检索。 你也可以调整语音回复时序。 网关现在会等待最终转写结果，然后再使用明确的音频轮次。

Vertex AI platform

语音回复使用与 Chatbot 回复相同的已配置 Vertex AI platform。 如果语音答案看起来异常，请先确认 platform 设置。

前往： 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

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

当指令为空时

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

处理可选语音助手​

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

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

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

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

解决方法：

  1. 保持语音会话开启并继续对话
  2. 如果你预期有更新的建议，请刷新页面
  3. 确认相关聊天机器人文档已标记为 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. 检查相关聊天机器人文档是否仍在 Processing
  3. 验证网关可以访问聊天微服务
  4. 如果列表一直像旧的，检查缓存的主题设置

仍未解决？​

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

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

建议附上：

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

相关指南​