WorkBuddy

WorkBuddy 是腾讯云代码助手推出的AI Agent 办公工具，自主规划并交付多模态复杂任务结果，支持多Agents 并行工作，极致提效。

准备工作

• 已开通云开发环境，获取环境ID cloudBase环境ID

• 在 AI 控制台中开启所需模型

• 在 AI 控制台中获取 Base URL 和 API Key

配置步骤

您可以选择通过 UI 配置，也可以选择编辑 WorkBuddy 自定义模型配置文件快捷配置。

我们以2026年6月9日最新 WorkBuddy 版本为例。

通过 UI 配置

1. 打开 WorkBuddy，点击右上角账号菜单，进入 设置

2. 选择模型，点击添加模型按钮

3. 选择自定义模型

4. 填写 AI 控制台复制的 Base URL和 API Key，从 AI 控制台模型列表中选择已启用的模型，复制模型名，填入并保存

5. 选择相应的大模型即可对话（您可能需要重启 WorkBuddy 才能在模型列表中找到已添加的模型）

通过配置文件配置

1. 打开配置文件

备注

如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。

Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目" 打开。

• Windows 配置路径

C:\Users\<你的用户名>\.workbuddy\models.json

• Mac/Linux 配置路径

~/.workbuddy/models.json

2. 从 AI 控制台复制的 Base URL 和 API Key 和模型名称，配置保存如下（以大模型 hy3-preview 为例）

{
  "models": [
    {
      "id": "hy3-preview",
      "name": "hy3-preview",
      "vendor": "Custom",
      "url": "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase",
      "apiKey": "eyJhbGciOiJSUzI1N...",
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ]
}

3. 选择相应的大模型即可对话

常见错误排查

报错信息	解决方法
404 错误：未找到模型	Base URL 填写不正确，请前往 AI 控制台中复制正确的 Base URL
401 错误：请重新登录后继续使用	API Key 填写错误，或者可能被删除
6004 错误	配置了错误的大模型名称，或者大模型未在 AI 控制台 中启用