输入关键词搜索

WorkBuddy 接入

更新时间: 2026/11/12 14:29:54

WorkBuddy 是桌面 AI Agent 工作台,支持通过 自定义模型 以 OpenAI-compatible 方式接入云信大模型 API 平台(简称 AIHub)。

安装 WorkBuddy

  1. 前往 WorkBuddy 官网,点击 立即下载。

  2. 根据操作系统下载安装包并完成安装。

  3. 启动后按页面提示登录 WorkBuddy 账号。

配置接入凭证

  1. 在对话界面底部点击模型选择器,在列表底部选择 配置自定义模型;或从左下角头像进入 设置,在左侧导航的功能分组中选择 模型。

  2. 点击 添加模型,供应商选择 自定义。

  3. 按以下示例填写接口地址、API Key 与模型名称。填写完后可点击 测试连接 确认接口连通。

    WorkBuddy 配置项 说明
    供应商 自定义
    接口地址 $AIHUB_BASE_URL/v1/chat/completions,例如 https://ai.yunxinapi.com/hub/v1/chat/completions
    API Key AIHUB_TOKEN,即 AIHub API 密钥/访问令牌
    模型名称 AIHub 逻辑模型名称

    配置示例:

    text接口地址: https://ai.yunxinapi.com/hub/v1/chat/completions
    API Key: sk-...
    模型名称: your-logical-model
    
  4. 点击 保存。

  • 接口地址 不会自动补全,需填写完整的 Chat Completions 地址(结尾为 /chat/completions),见上方配置示例。
  • 自定义模型仅支持 OpenAI 兼容的 Chat Completions 协议,不支持 Responses API 与 Anthropic 协议,因此不要填写 AIHub 的 /v1/messages 入口。

验证配置

保存后,在对话界面底部的模型选择器中选择该模型,发送:

text只回复 OK

如果模型正常返回响应,说明配置已生效。

常见问题

现象 排查方向
测试连接失败 接口地址未填写完整的 /chat/completions 地址,或误填了 AIHub 的 Anthropic Messages 入口。
报错模型不存在 模型名称会作为请求中的 model 参数发送,须与 AIHub 逻辑模型名完全一致(区分大小写,不带额外前后缀)。
401/unauthorized API Key 应填写 AIHub 访问令牌(AIHUB_TOKEN)。
404 接口地址缺少 /hub/v1/chat/completions,或误把根地址填入了不会自动补全的字段。
填写的模型不可用 先用 /v1/models 查询当前令牌可见的模型列表,并按其 data[].id 填写模型名称。
model not allowed/no candidate 当前访问令牌未授权该模型,或模型无可用路由。
此文档是否对你有帮助?
有帮助
去反馈
  • 安装 WorkBuddy
  • 配置接入凭证
  • 验证配置
  • 常见问题