模型配置
下载
聚焦模式
字号
模型配置是 WorkBuddy AI 的模型管理入口，让您可以根据任务需要选择模型，或接入自己的模型服务。自定义模型支持通过界面添加、编辑和删除，无需手动编辑配置文件。
不同模型支持的文本处理、推理、图片输入和工具调用能力可能不同。接入前，请确认模型及服务接口满足任务要求。
自动模式
选择 自动（Auto） 后，模型服务会按其路由策略分配处理请求的模型，让您可以减少手动选择具体型号的步骤。
自动模式不代表所有已添加的自定义模型都会参与选择。需要指定某个模型时，请在对话中的模型选择器里手动选择。
内置模型
您可以在对话的模型选择器中查看当前账号可用的内置模型。具体型号及可用范围可能随产品版本、账号权益和服务配置调整。
选择时，建议关注任务实际需要的能力：
任务需要 | 关注的模型能力 |
问答、写作与资料整理 | 文本处理能力及可接受的上下文长度 |
截图分析、图表理解 | 图片输入能力，并结合任务验证识别效果 |
文件处理、工具操作 | 工具调用能力，以及相关技能和服务是否可用 |
多步骤分析 | 推理能力，并根据结果判断是否适合当前任务 |
图片输入不等于图片生成
支持图片输入，表示模型可以接收图片进行理解，并不代表它能生成或编辑图片。同一厂商不同型号的能力也可能不同，不应仅根据厂商名称判断。
自定义模型
在桌面端进入 头像 > 系统设置 > 模型，可以管理自己的模型服务配置：
模型列表：查看已保存的模型名称及提供商信息。
添加 / 编辑 / 删除：通过表单维护配置，删除时需确认。
测试连接：检查接口是否能够响应，便于排查地址、密钥或模型名称问题。
在对话中选择：保存后，在对话的模型选择器中选择对应自定义模型。
保存配置不等于连接成功，也不会自动将所有会话切换到新模型。建议先测试连接，再用简单任务验证需要的能力。
配置保存位置
默认用户级配置文件为
~/.workbuddy-ai/models.json；Windows 下位于 %USERPROFILE%\\.workbuddy-ai\\models.json。若调整过用户配置目录，请以模型设置页显示的路径为准。日常管理可直接通过界面完成，无需手动修改该文件。请勿将包含 API Key 的配置文件上传到公开仓库或用于公开分享。
接入方式
提供商接入
选择提供商后，界面会按预设填写接口地址、模型选项或默认能力信息。不同提供商的表单要求不同，部分需要手动填写模型名称；请根据已开通的服务补充 API Key 等必填信息。
提供商预设只用于简化配置，不代表对应套餐已开通，也不代表其全部模型都是 WorkBuddy AI 的内置模型。
Token Plan
选择与已开通方案对应的腾讯云 Token Plan 选项，再选择模型并填写该方案要求的 API Key。
不同方案的模型范围、额度和使用条件可能不同。请使用与所选方案匹配的凭据，并参考提供方的服务说明；不应将普通 WorkBuddy AI 登录状态视为已获得该方案的调用权限。
Coding Plan
提供商预设中包含腾讯云、智谱和 Kimi 的 Coding Plan 接入选项。使用前，请先确认已开通相应服务，并按所选方案填写接口所需的凭据与模型信息。
自定义 API
您可以通过提供商预设接入支持的 API 服务，例如 OpenAI、DeepSeek、智谱等。预设可减少手动填写内容，但仍需核对接口地址、模型名称和访问权限。
接口兼容要求
当前自定义模型接入使用 OpenAI 兼容的 Chat Completions API。请确认服务的请求、响应及所需工具调用格式兼容，不能只凭接口可以返回文本，就判断它适用于所有 WorkBuddy AI 任务。
本地部署
Ollama 可在本机运行模型，并提供 OpenAI 兼容接口，供 WorkBuddy AI 连接。使用本地推理前，需要先安装 Ollama、下载所需模型，并保持本地服务运行。
在提供商中选择 Ollama，填写已安装模型的准确名称。默认接口地址为：
http://localhost:11434/v1/chat/completions
Ollama 的本机接入预设无需填写 API Key。请根据所选模型的实际能力配置图片输入、工具调用等选项，再测试连接。
适合考虑本地模型的情况：
1. 希望在本机运行并测试模型，而不是把模型推理交给远程服务。
2. 已具备足够的内存、存储空间和计算资源，希望自行选择与管理模型。
3. 希望评估本地模型在特定文本处理或工具调用任务中的效果。
本地推理的边界
请确认使用的是本地下载的模型，而非通过 Ollama 调用云端模型。本地推理会占用电脑资源，并不等于零成本，也不保证 WorkBuddy AI 的所有功能都能离线使用。
联网搜索、外部连接器或其他在线服务仍可能访问网络。因此，接入本地模型不等于整个任务的数据不会离开电脑，也不能据此保证满足特定合规要求。
自定义
如果模型服务不在预设列表中，可选择 自定义 / Custom，填写服务提供方给出的接口地址、API Key 和模型名称，并核对相关能力选项。
模型名称应填写接口接受的参数值，而不是自行起的展示名称。保存后，先测试连接；若失败，请检查地址、密钥、模型访问权限和账户额度。
能力与高级配置
部分提供商的能力标记随所选模型自动填写；支持手动配置的提供商则会显示相应选项。请按服务实际支持情况填写，而不是将全部能力勾选为开启。
配置项 | 说明 |
工具调用 | 表示模型及接口支持工具调用，是许多执行类任务的必要条件 |
图片输入 | 表示模型及接口能够接收图片，不代表具备图片生成能力 |
推理模式 | 按模型支持情况配置；不同服务可能采用不同的控制方式 |
最大输入 / 输出 Token | 按模型和服务限制设置；填写更大的数值不会扩大模型真实容量 |
思考强度 | 仅在模型及配置入口支持时使用，不应填写服务不接受的档位 |
连接成功不等于能力全部验证通过
测试连接用于初步检查接口响应。图片理解、工具调用和较长输入等能力，还需使用相应任务单独验证；测试请求也可能产生服务调用用量。
自定义协议
部分提供商的高级配置中提供 自定义协议 开关，用于控制是否自动补全接口路径。一般情况下无需开启；仅在服务提供方要求使用特定完整地址时，再按其说明设置。
状态 | 行为 |
关闭（默认） | 对自定义模型地址进行规范化，确保路径末尾包含一个 /chat/completions；不会自动补齐提供方要求的所有其他路径段 |
开启 | 请求使用填写的完整接口地址，不再自动追加 /chat/completions |
例如，服务的完整地址如果是
https://api.example.com/v1/chat/completions，关闭开关时可以填写包含 /v1 的基础地址，也可以填写完整地址。若提供方使用其他路径，应按其官方说明配置。自定义协议只改变地址处理方式，不是任意 API 协议转换器。 开启后，服务仍需满足当前自定义模型接入所要求的请求与响应格式，也不会绕过身份认证或权限限制。
文档反馈