客户端
Workbuddy
在 WorkBuddy 中添加 Toodoo AI 模型连接。
先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置和填写说明。
配置入口
进入 WorkBuddy 的模型设置，添加自定义模型。新版本提供界面管理，旧版本配置方式可能不同；以当前安装版本的官方说明为准。WorkBuddy 官方模型配置
填写连接信息
- 服务商或展示名称：
Toodoo AI。 - API 密钥：在 Toodoo AI 创建的独立密钥。
- 模型 ID：平台提供的完整标识。
- 协议：选择模型支持的 OpenAI Chat Completions。
地址字段如果要求完整请求 URL，填写 https://toodooai.com/v1/chat/completions；如果明确要求 Base URL，填写 https://toodooai.com/v1。不要把两种地址混用，保存前核对界面字段说明。
验证
保存后在会话中选择自定义模型，先执行短文本任务，再验证工具操作。若验证失败，对照 错误码与排障 检查模型、协议和地址。
分享本地配置前移除密钥，避免将凭据随配置文件一起传播。
配置流程
- 为 Workbuddy 创建单独的 Toodoo AI API 密钥，并确认分组有可用额度。
- 在当前版本的模型设置中创建自定义连接。
- 如果字段名称是 Base URL，填写
https://toodooai.com/v1；如果字段明确要求完整请求 URL，填写https://toodooai.com/v1/chat/completions。 - 填入完整模型 ID，不要只填模型的展示名称。
- 保存后发送短文本，再验证代码编辑或工具操作。
地址模式不要混用
Workbuddy 不同版本可能把地址拆成“服务地址 + 路径”，也可能只提供一个 URL 输入框。保存前查看界面说明和请求预览：最终请求应只出现一层 /v1，并指向 Chat Completions 端点。
排障顺序
| 现象 | 检查内容 |
|---|---|
| 连接测试失败 | Base URL、密钥状态、代理和网络。 |
| 模型不存在 | 重新查询模型列表，确认分组允许该完整模型 ID。 |
| 请求成功但工具任务失败 | 模型是否支持工具调用、文件输入和客户端发送的高级参数。 |
| 修改后没有变化 | 关闭旧会话并重启 Workbuddy，确认没有项目级配置覆盖。 |
可参照 WorkBuddy 官方模型配置，然后用 Toodoo AI 日志功能确认真实请求。