b300b469dc
- Revised site name and description for clarity and detail. - Updated navigation structure to better reflect the organization of content. - Improved changelog entries for better readability and consistency. - Migrated assistant configuration and prompt guidelines to new documentation paths. - Enhanced core concepts section to clarify the roles and capabilities of assistants and engines. - Streamlined workflow documentation to provide clearer guidance on configuration and usage.
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# 常见问题
|
||
|
||
本页只提供简短回答和跳转建议；如果你需要逐步排查，请直接进入 [故障排查](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、页面加载或性能问题分类处理
|
||
|