LLM 模型
概述
LLM 模型标签页配置平台的 AI 主模型连接。配好后，平台的 AI 助手（Collie）可以使用你指定的大语言模型，提供自然语言交互、智能问答、自动化操作等 AI 能力。
平台采用 OpenAI 兼容的 API 协议连接 LLM——任何兼容 OpenAI Chat Completions 接口的模型服务（包括 OpenAI 官方、Azure OpenAI、以及各类国产 / 自部署的兼容服务）都可以接入。
配置项说明
本标签页提供三个配置项，它们共同定义了 AI 助手使用的大模型连接。
主模型名称
| 属性 | 说明 |
|---|---|
| 业务含义 | AI 助手使用的大语言模型名称 |
| 示例 | gpt-4o、deepseek-chat、qwen-max |
模型名称需要与你的模型服务支持的模型 ID 完全一致。不确定时请查阅模型服务的文档。
主模型 Base URL
| 属性 | 说明 |
|---|---|
| 业务含义 | 模型服务的 OpenAI 兼容 API 根地址 |
| 格式 | 有效的 URL |
| 示例 | https://api.openai.com/v1、https://api.deepseek.com/v1 |
什么是"OpenAI 兼容"？
OpenAI 兼容是指模型服务提供了与 OpenAI Chat Completions 相同的 HTTP 接口规范。大多数主流模型服务（DeepSeek、通义千问、Moonshot、Azure OpenAI 等）都提供兼容模式，只需把 Base URL 指向对应服务的地址即可。
主模型 API Key
| 属性 | 说明 |
|---|---|
| 业务含义 | 访问模型服务的 API 密钥 |
| 显示方式 | 已配置时显示 ******** 掩码 |
API Key 由你的模型服务提供商发放。请妥善保管，不要泄露给未授权人员。
密码字段的安全处理
API Key 是密码类字段——已配置时显示 ******** 掩码。保存时：
- 如果未修改掩码字段，已有的 API Key 不会被覆盖
- 要更换 API Key，直接在字段中输入新值并保存
- 要清除 API Key，将字段清空后保存
配置验证
保存后，如何确认 AI 模型连接正常？
- 查看 AI 助手是否可用：配置成功后，平台界面中的 AI 助手 (Collie) 应该可以正常对话
- 检查错误提示：如果 API Key 无效、Base URL 错误或模型名称不存在，AI 助手在对话时会返回连接错误
- 查看后端日志：如有权限访问后端日志，可以查看模型调用是否成功
没有内置测试按钮
与邮件标签页不同，LLM 模型标签页目前没有"测试连接"按钮。配置后需要通过实际使用 AI 助手来验证连接是否正常。