AI 模型配置
连接模型服务、填写访问凭据,并选择 AI 助手使用的模型。
本页目录
选择模型服务#
在 AI 模型配置中选择服务商。支持的连接类型包括:
| 服务商 | 配置内容 |
|---|---|
| OpenAI | API 密钥与模型 |
| Anthropic | API 密钥与 Claude 模型 |
| Google Gemini | API 密钥与 Gemini 模型 |
| Mistral | API 密钥与模型 |
| xAI | API 密钥与模型 |
| DeepSeek | API 密钥与模型 |
| Groq | API 密钥与模型 |
| OpenAI 兼容服务 | API 地址、密钥与模型标识 |
可通过配置页中的获取 API 密钥链接打开对应服务商的控制台。密钥用于授权模型调用,填写后保存。
填写密钥与模型#
- 选择服务商。
- 填写该服务商提供的 API 密钥。
- 在模型列表中选择模型;使用自定义模型时,填写服务商要求的完整模型标识。
- 保存配置,等待连接验证结果。
保存时会进行实际模型调用测试。模型标识错误、服务不可达或账号权限不足,也可能导致验证失败;出现错误时应同时检查密钥、模型名称和服务状态。
密钥保管:不要将真实 API 密钥放入公开页面、代码仓库或聊天截图。密钥泄露后,应在服务商控制台撤销并更换。
连接 OpenAI 兼容服务#
选择 OpenAI 兼容服务后,会显示 API 地址字段。填写服务商提供的 API 基础地址,再填写密钥与模型标识。
地址应包含兼容接口的版本路径,例如服务商提供的 /v1。系统会补齐聊天接口路径,也会自动移除末尾的斜线和 /chat/completions,因此粘贴完整的聊天接口地址也可以。
接口地址必须能够从 eoochat 服务访问。此处填写的是模型服务接口地址,不是网站页面地址。
OpenAI 兼容服务不提供预设模型列表。选择自定义模型 ID,填写所连接服务实际提供的模型标识。API 密钥字段始终必填;接口未启用身份验证时,填写一个非空占位值。
兼容服务还需支持助手使用的工具调用与结构化输出。接口不支持 tools 或 response_format 时,知识检索、线索收集、结束会话和人工交接会失败。
为助手选择合适的模型#
选择时同时考虑回答质量、工具调用、响应速度与调用成本。OpenAI 和 Anthropic 模型的结构化操作较稳定;小模型偶尔可能漏掉收集线索、结束会话或交接的步骤,出现这类情况时可切换到能力更强的模型。
- 需要多步判断或复杂资料分析时,优先测试推理能力与上下文处理。
- 需要收集客户信息、调用工具或转人工时,重点测试结构化输出和工具调用。
- 处理大量日常咨询时,比较响应时间与成本,并用实际问题验证回答质量。
- 小模型或兼容接口的行为可能与主流托管模型不同,应逐项验证关键动作。
检查与维护#
连接成功后,打开助手的测试与预览,测试知识问答、连续追问,以及已启用的工具与人工交接。
定期检查调用情况、模型响应和密钥有效性。更换模型或凭据后,重新测试相关流程。详细步骤见测试与上线检查。