WorkBuddy怎么用API接口?有开发文档吗
作者:别来无恙窗外有雨
时间:2026-11-16
来源:正软商城
浏览:0
WorkBuddy 目前没有面向普通用户的公开 REST API 接口文档,扩展与集成走四条官方路径:接入 MCP 服务扩展工具能力、用连接器打通外部应用(支持公共/个人授权)、编写技能(Skill)与专家包定制工作流、在开放平台发布 Buddy 应用。另支持接入 OpenAI 兼容的自定义模型。本文含 4 张真实界面截图并如实说明现状。
本文目录

更新时间:2026-11-16 | 适用:WorkBuddy 桌面端 | 界面以实际版本显示为准
一句话答案:WorkBuddy 目前没有面向普通用户的公开 REST API 文档。官方的扩展路径是四条:MCP 服务(协议级工具扩展)、连接器(打通外部应用账号)、技能 / 专家(SKILL.md 定义工作流)、开放平台(发布 Buddy 应用)。模型层面还支持接入 OpenAI 兼容的自定义模型。
如实说明:截至 2026 年 11 月,官方文档未提供对外 REST API 或 Webhook 的开发者文档。上述四条路径均为官方文档明确支持的能力,不代表「调 WorkBuddy 接口」类用法。
路径一:MCP 服务(最通用的扩展方式)
- 在设置中添加 MCP 服务(支持本地命令与 HTTP / SSE 远端);
- 会话需要连接时,对话流显示「正在连接 MCP 服务」与已连接数 / 服务总数,全部就绪后提示消失;
- 提供交互界面的 MCP 应用,可以在对话或右侧产物区直接展示界面,不只是返回文字;
- 安全中心可按服务启停、逐工具管控,HTTP 类 MCP 的域名受网络规则判定。

▲ 图1:会话中连接 MCP 服务的进度提示

▲ 图2:任务执行进度示例——Agent 调用工具、生成产物的过程
路径二:连接器(打通外部应用账号)
| 授权方式 | 说明 | 适合 |
|---|---|---|
| 公共授权 | 管理员配置一次,全员共用同一套票据 | 团队共享的服务账号 |
| 个人授权 | 每位成员各自授权自己的账号,票据不共享 | 个人私有服务 |
同一个连接器可以同时两种方式存在:管理员用团队账号配置了飞书(公共授权),成员也可以用自己的飞书账号挂到个人授权里。

▲ 图3:连接器管理页,乐享、腾讯文档、Notion 等应用可一键连接
路径三:技能与专家(工作流定制)
- 技能(Skill):每个技能是独立目录、包含
SKILL.md定义文件;项目级技能放.codebuddy/skills/目录,随项目共享给团队,项目级优先于用户级生效; - 专家:从专家中心选用或自建专家包,注入专业方法论;项目可配置专属专家并置顶;
- 项目规则:
.codebuddy/rules/定义团队统一的代码规范与工作流约定,自动加载生效。

▲ 图4:设置 > 模型 的自定义模型配置,支持 OpenAI 兼容接口
路径四:开放平台(开发者发布)
如果你是 Buddy 应用、专家、技能或连接器的提供方:
- 在 WorkBuddy 开放平台提交和管理资产;
- 资产审核结果通过开放平台的通知中心(开发者工作台右上角)及时触达;
- 第三方授权页面支持微信扫码 / 手机号等方式完成应用授权。
扩展路径对照表
| 需求 | 推荐路径 |
|---|---|
| 给 Agent 加新工具 | MCP 服务 |
| 打通外部应用账号 | 连接器(公共 / 个人授权) |
| 固化团队工作流 | 技能(SKILL.md)+ 项目规则 |
| 注入领域方法论 | 专家 / 专家包 |
| 接自建模型或本地模型 | 设置 > 模型(OpenAI 兼容) |
| 面向他人分发能力 | 开放平台提交资产 |
自检清单:
- 新接 MCP 先在安全中心确认工具粒度授权;
- 团队公共服务走连接器公共授权,避免人人配一遍;
- 技能定义写清触发场景与步骤,项目级放 .codebuddy 目录随仓库共享;
- 自建模型先小流量验证再切主力。
常见问题 FAQ
- Q:WorkBuddy 会开放 REST API 吗?
A:以官方后续版本为准;当前扩展优先走 MCP / 连接器 / 技能体系。 - Q:MCP 服务连接失败怎么排查?
A:对话流会显示连接进度与已连接数;检查服务配置与网络,HTTP 类 MCP 注意域名是否命中网络安全规则(允许 / 询问 / 拒绝)。 - Q:MCP 的 Token 怎么管理?
A:部分通过 MCP Token 调用的工具已在白名单内不会弹确认;其余按安全中心的工具管控策略执行。 - Q:技能和 MCP 能同时用吗?
A:可以。技能编排工作流,MCP 提供工具,Agent 在同一任务里按需组合调用。 - Q:.codebuddy 配置支持哪些内容?
A:rules(规则)、agents(Agent 定义)、skills(技能)、CODEBUDDY.md(团队记忆);项目级优先于用户级,同名时项目级生效。 - Q:自定义模型消耗积分吗?
A:接入自定义模型后按该模型的计费规则处理;本地模型不走云端积分,这也是官方支持的离线方案。 - Q:开放平台审核要多久?
A:审核结果通过开放平台通知中心触达,无需反复到后台查询状态;具体时长以平台提示为准。 - Q:CLI 或脚本调用 WorkBuddy 可以吗?
A:当前版本未提供公开 CLI 接口;需要自动化触发时用定时任务在客户端内实现,外部联动关注官方后续开放能力。
数据来源:WorkBuddy 官方文档「对话(MCP 服务加载 / 使用 MCP 应用界面)」「项目(连接器 / .codebuddy 配置)」「模型配置」「Buddy 应用与开放平台」「权限模式(工具管控 / 网络安全)」,均为 2026 年 11 月官方公开内容。
作者最新文章
动漫之家官网登录入口 动漫之家app最新版页直达
2026-11-12 15:02
coreldraw怎么量曲线长度 曲线测量技巧
2026-10-27 22:30
PS反选快捷键是Ctrl加什么
2026-10-27 15:17
打开excel表格显示正在访问打印机怎么解决
2026-10-26 10:44
goldwave怎么把两个音乐合在一起
2026-10-23 17:13
热门文章
更多
精品专题
更多
Mac软件
更多
火山引擎 网页版
Windows/ macOS/ Linux
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。
















