跳转到文档内容
进入工作台
文档目录AI 模型配置

AI 模型配置

连接模型服务、填写访问凭据,并选择 AI 助手使用的模型。

本页目录

选择模型服务#

在 AI 模型配置中选择服务商。支持的连接类型包括:

服务商 配置内容
OpenAI API 密钥与模型
Anthropic API 密钥与 Claude 模型
Google Gemini API 密钥与 Gemini 模型
Mistral API 密钥与模型
xAI API 密钥与模型
DeepSeek API 密钥与模型
Groq API 密钥与模型
OpenAI 兼容服务 API 地址、密钥与模型标识

可通过配置页中的获取 API 密钥链接打开对应服务商的控制台。密钥用于授权模型调用,填写后保存。

填写密钥与模型#

  1. 选择服务商。
  2. 填写该服务商提供的 API 密钥。
  3. 在模型列表中选择模型;使用自定义模型时,填写服务商要求的完整模型标识。
  4. 保存配置,等待连接验证结果。

保存时会进行实际模型调用测试。模型标识错误、服务不可达或账号权限不足,也可能导致验证失败;出现错误时应同时检查密钥、模型名称和服务状态。

密钥保管:不要将真实 API 密钥放入公开页面、代码仓库或聊天截图。密钥泄露后,应在服务商控制台撤销并更换。

连接 OpenAI 兼容服务#

选择 OpenAI 兼容服务后,会显示 API 地址字段。填写服务商提供的 API 基础地址,再填写密钥与模型标识。

地址应包含兼容接口的版本路径,例如服务商提供的 /v1。系统会补齐聊天接口路径,也会自动移除末尾的斜线和 /chat/completions,因此粘贴完整的聊天接口地址也可以。

接口地址必须能够从 eoochat 服务访问。此处填写的是模型服务接口地址,不是网站页面地址。

OpenAI 兼容服务不提供预设模型列表。选择自定义模型 ID,填写所连接服务实际提供的模型标识。API 密钥字段始终必填;接口未启用身份验证时,填写一个非空占位值。

兼容服务还需支持助手使用的工具调用与结构化输出。接口不支持 tools 或 response_format 时,知识检索、线索收集、结束会话和人工交接会失败。

为助手选择合适的模型#

选择时同时考虑回答质量、工具调用、响应速度与调用成本。OpenAI 和 Anthropic 模型的结构化操作较稳定;小模型偶尔可能漏掉收集线索、结束会话或交接的步骤,出现这类情况时可切换到能力更强的模型。

  • 需要多步判断或复杂资料分析时,优先测试推理能力与上下文处理。
  • 需要收集客户信息、调用工具或转人工时,重点测试结构化输出和工具调用。
  • 处理大量日常咨询时,比较响应时间与成本,并用实际问题验证回答质量。
  • 小模型或兼容接口的行为可能与主流托管模型不同,应逐项验证关键动作。

检查与维护#

连接成功后,打开助手的测试与预览,测试知识问答、连续追问,以及已启用的工具与人工交接。

定期检查调用情况、模型响应和密钥有效性。更换模型或凭据后,重新测试相关流程。详细步骤见测试与上线检查。