# 常见问题

本页只提供简短回答和跳转建议；如果你需要逐步排查，请直接进入 [故障排查](troubleshooting.md)。

## Q: 我应该先看哪一部分文档？

- 想了解产品是什么：看 [产品概览](../overview/index.md)
- 想先把服务跑起来：看 [环境与部署](../getting-started/index.md)
- 想最快创建第一个助手：看 [快速开始](../quickstart/index.md)
- 想系统完成助手配置：从 [助手概览](../concepts/assistants.md) 开始

## Q: 如何配置模型或 API Key？

进入对应资源页完成配置：

- LLM：见 [LLM 模型](../customization/models.md)
- ASR：见 [语音识别](../customization/asr.md)
- TTS：见 [声音资源](../customization/voices.md)

## Q: 助手为什么不回复？

通常先检查三件事：

- 助手是否已绑定可用的模型资源
- 提示词、知识库或工具是否配置完整
- WebSocket 会话是否已经正常建立

下一步：

- 助手行为验证：看 [测试调试](../concepts/assistants/testing.md)
- 逐步排查：看 [故障排查](troubleshooting.md)

## Q: 回复为什么不准确或不稳定？

优先检查：

- 提示词是否明确了角色、任务和限制
- 是否应该补充知识库，而不是继续堆叠提示词
- 是否需要把复杂业务改成工作流，而不是单轮问答

相关文档：

- [提示词指南](../concepts/assistants/prompts.md)
- [知识库](../customization/knowledge-base.md)
- [工作流](../customization/workflows.md)

## Q: 语音识别或语音播放效果不好怎么办？

- 输入侧问题先看 [语音识别](../customization/asr.md)
- 输出侧问题先看 [声音资源](../customization/voices.md) 和 [TTS 参数](../customization/tts.md)
- 需要逐步定位链路问题时，再看 [故障排查](troubleshooting.md)

## Q: 页面空白、接口报错或连接不上怎么办？

这是典型的环境或链路问题：

- 先确认 [环境与部署](../getting-started/index.md) 中的三个服务都已启动
- 再进入 [故障排查](troubleshooting.md) 按连接、API、页面加载或性能问题分类处理