模型管理
模型配置在 Alice 的 模型 页面维护，并在智能体中按用途选择。不要沿用旧版文件配置教程；当前界面和 SQLite 数据库才是有效配置入口。
支持状态：已支持
Provider 和可用模型会随版本及服务端变化，本页不固定供应商或模型总数。
需求
开始前准备：
- 模型服务的 API Key；本地 Ollama 也需按当前表单填写凭据；
- 正确的模型名称与 Base URL；
- 若智能体需要操作游戏，模型应支持 Function Calling；
- 了解第三方模型服务会收到你提交的提示词、对话上下文和所选工具描述。
一个智能体可以配置三种用途：
| 用途 | 当前作用 |
|---|---|
| 主智能体模型 | 核心决策、对话和工具调用 |
| QQ 机器人模型 | 处理游戏外 QQ 消息；可选择“与主智能体相同” |
| 压缩模型 | 对话历史压缩和上下文精炼；可选择“与主智能体相同” |
架构
模型管理 保存 Provider、模型名、API Key、Base URL、上下文窗口和 Function Calling 标记。模型名称输入后，Alice 会尝试自动识别上下文窗口与 Function Calling 能力；无法识别时显示手动字段。
智能体只保存对模型配置的选择。QQ 模型未单独配置时，运行链路回退到主模型。主模型没有有效 providerId 或模型记录被删除时，智能体请求会失败。
API Key 当前保存在 Alice 本地 SQLite 的模型配置表中。源码未实现操作系统凭据保险箱加密；请保护 Windows 账户和 Alice 数据目录，不要共享数据库或诊断包。
执行
添加模型
- 在左侧打开
模型。 - 点击
添加模型。 - 选择
Provider，填写精确的模型名称。 - 填写
API Key和Base URL。 - 等待上下文窗口和 Function Calling 检测；若出现未识别提示，按供应商文档手动填写。
- 点击
保存，返回模型列表。
成功标志：模型出现在 模型管理 列表中，Provider、模型名和启用状态正确。
分配给智能体
- 选择左侧智能体，打开
配置。 - 在
模型选择中设置主智能体模型。 - QQ 或压缩用途需要独立模型时，取消
与主智能体相同再选择模型。 - 点击
保存。
创建新智能体时，在向导第 5 步 LLM 完成相同选择；主模型是完成向导的必填项。
失败处理
模型添加失败：检查字段是否为空、模型 ID 是否重复，并确认 Alice 可写入本地数据库；- 401/403：重新核对 API Key，不要把 Key 发到聊天或截图中；
- 404：核对 Base URL 和模型名称，不要把网页控制台地址当作 API 地址；
- 工具调用不可用：确认模型服务确实支持 Function Calling，自动检测结果只用于配置提示，不代替真实请求验证；
- 超时或限流：查看聊天错误与仪表盘调用数据，降低并发或联系模型服务商。