WorkBuddy

WorkBuddy 支持添加 OpenAI 兼容的自定义模型，可将模型请求发送到模型聚合服务平台。

添加自定义模型

1. 打开 WorkBuddy，进入 设置 → 模型。
2. 点击 添加模型 或 配置自定义模型。
3. 提供商选择 自定义 / Custom（OpenAI Compatible）。
4. 填写以下信息：

配置	值
模型名称	自定义显示名称
模型 ID	模型广场中的精确模型标识
API Key	模型聚合服务平台 API Key
接口地址	https://ai.example.edu.cn/v1/chat/completions

5. 保存后回到任务页面，在模型选择器中选择刚添加的模型。
6. 先发送一条不含敏感数据的消息测试连接。

接口地址差异

WorkBuddy 不同版本对接口地址的处理可能不同：

• 如果设置项要求填写完整端点，使用 https://ai.example.edu.cn/v1/chat/completions。
• 如果客户端会自动追加 /chat/completions，只填写 https://ai.example.edu.cn/v1。
• 如果界面提供 自定义协议 开关，填写完整端点时开启它，避免路径被重复拼接。

出现 404 时，优先检查最终地址是否变成了 /v1/chat/completions/chat/completions 或 /v1/v1/chat/completions。

能力设置

工具调用、图片输入和推理能力必须与实际模型一致。不要仅因 WorkBuddy 提供了某个能力开关就启用；错误的能力声明可能导致请求失败或 Agent 行为异常。

校内使用提醒

WorkBuddy 可以读取文件、操作本地应用并执行 Agent 任务。使用前应确认它将哪些内容发送给模型：

• 为 WorkBuddy 创建独立 API Key，并限制模型、额度和有效期。
• 不授权读取密码、证书、.env 或未公开科研数据目录。
• 涉及敏感数据时，只使用学校批准的敏感数据分组。
• 执行发送消息、修改文件或批量操作前检查任务范围。
• 不要在共享电脑上保存个人 API Key。