配置 AI 服务
配置文本模型、语音转写和可选的联网搜索。
哪些功能需要配置
| 服务 | 用途 | 是否必需 |
|---|---|---|
| OpenAI 兼容的文本模型 | 对话、总结、知识点、习题、复习资料等 AI 任务 | 使用这些功能时需要 |
| 腾讯云语音识别 | 将录音或导入音频转为文字 | 使用语音转写时需要 |
| Tavily | 对话中的联网搜索 | 可选 |
这些服务由你选择的供应商提供，可能产生调用费用。无需为保存和查找本地资料配置全部服务。
配置文本模型
- 打开「设置 → AI 服务」。
- 在 AI 服务区域填写服务商提供的服务地址、模型名称、API 密钥。
- 保存配置，再按需点击「测试连接」。
- 测试成功后，回到记录或对话重试 AI 任务。
可以使用「填入 DashScope 预设」辅助填写，再按自己的服务账号核对信息。同一时间只有一份文本模型配置生效，不是每个助手独立配置一个模型。
连接测试会发起真实模型请求，可能计费。保存密钥也不等于允许发送资料，内容外发同意仍由应用单独处理。
配置语音转写
在同一页面的「语音转写」区域填写腾讯云 SecretId、SecretKey 和地域，保存后按需测试连接。
首次转写前需要同意发送音频至腾讯云。未配置密钥或未完成同意时，查看记录显示的等待原因，补齐后继续，不需要反复导入同一个文件。
配置联网搜索
在「联网搜索」区域保存 Tavily 密钥，再在通用助手的对话中开启联网搜索。未配置时开关不可用，其他 AI 功能不因此停用。
联网搜索会将搜索词发送给 Tavily，测试连接也会执行一次真实搜索。本地知识助手不提供联网搜索。
配置失败时
- 连接失败：检查地址是否为服务商提供的兼容接口、模型名是否可用，以及网络与密钥权限。
- 额度不足或限流：查看供应商账户和错误提示，处理后再重试。
- 录音一直等待：同时检查转写密钥、网络和音频外发同意。
不要把真实密钥粘贴到公开截图、Issue 或文档中。数据与外发范围见数据与隐私。