> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maple.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Core 故障排查

> 解决 Maple Voice Core 的常见问题

Maple Voice Core 常见问题的解决方法。

## 通话质量问题

### 问题：音质差

**解决方法：**

- 检查网络连接
- 确认带宽（每路通话至少 100kbps）
- 用另一部电话测试
- 如果问题持续，请联系支持团队

### 问题：通话中断

**解决方法：**

- 检查是否有服务中断
- 确认账户状态
- 查看通话记录中的规律
- 检查并发通话数量上限

## AI 回答问题

### 问题：信息不正确

**解决方法：**

- 检查知识库的准确性
- 检查是否有过时的条目
- 更新门店营业时间
- 核实特别公告

### 问题：设置正确，AI 却说已打烊或外送已暂停

旧的知识库条目或 Behavior 覆盖了您当前的设置。AI 电话助手会严格遵循 [Behaviors](https://docs.maple.inc/zh/voice-core/knowledge-base.md#behaviors)，并根据知识库条目回答问题。因此，之前添加的说明（例如某个忙碌周末外送暂停）在您更改设置后仍会被重复。

**解决方法：**

1. 点击侧边栏中的 **Knowledge**，打开 **All Entries** 标签页
2. 搜索过时的内容，例如 “closed” 或 “delivery”
3. 点击 **Edit entry** 更正，或点击 **Delete entry**
4. 如果没有匹配的条目，请查看 **Behaviors** 标签页。Behaviors 无法在那里编辑；请让 Maple Copilot 或 Maple 支持团队删除过时的 Behavior
5. 再次测试您的 AI 电话助手

营业时间、外送状态或菜单信息有变化时，请同时更新对应的条目。

### 问题：AI 听不懂问题

**解决方法：**

- 写出更清晰、更完整的答案
- 查看日志中失败的查询
- 添加更多知识库条目
- 调整语音配置
- 参阅 [Speech recognition limits](https://docs.maple.inc/help/troubleshooting/ai-voice-recognition-limitations-and-workarounds.md) 和 [Pronunciation fixes](https://docs.maple.inc/help/troubleshooting/fixing-ai-pronunciation-of-restaurant-and-menu-names.md)（英文）

## 电话号码问题

### 问题：号码无法使用

**解决方法：**

- 确认号码处于激活状态
- 检查账户账单
- 测试转接规则（参阅 [Call forwarding issues](https://docs.maple.inc/help/troubleshooting/call-forwarding-troubleshooting.md)，英文）
- 确认号码转移已完成

### 问题：号码能响铃但无法接通，而 Try Your Agent 正常

控制台中的 **Try Your Agent** 直接连接您的 AI 电话助手，不经过电话号码。如果它正常而真实来电不正常，问题在号码，而不在 AI。

**解决方法：**

- 逐位核对您拨打的是 **AI Agents** 中显示的 AI 号码
- 如果刚设置或更换了号码，请等几分钟后再试
- 如果仍无法接通，请把您拨打的号码和听到的内容发给 Maple 支持团队。支持团队会检查号码的路由，并修复或重新分配号码

### 问题：转接时来电无法接通员工

请参阅 [Call transfer issues](https://docs.maple.inc/help/troubleshooting/why-calls-aren-t-transferring-to-my-staff-or-the-ai-says-the-restaurant-is-busy.md)（英文）。

### 问题：无法接收短信

**解决方法：**

- 检查 A2P 注册状态
- 确认已启用短信
- 用不同的运营商测试
- 查看消息日志

## 配置问题

### 问题：更改未生效

**解决方法：**

- 请等待 5 分钟让更改生效
- 清除浏览器缓存
- 检查保存确认提示
- 确认所选门店正确（多门店时）

## 获取帮助

- 查看[系统状态](https://status.maple.inc)
- 查阅[文档](https://docs.maple.inc/zh/voice-core/overview.md)
- 联系支持团队：<hello@maple.inc>
- 紧急情况：请致电支持热线