手把手教你接入WorkBuddy开放平台
鹅厂正式上线开放平台,把造好的Agent底座直接开放给个人与开发者。文章逐一拆解Buddy应用、专家、Skill、连接器与硬件五大能力,并演示账号认证、Skill YAML编写与市场提交的完整接入流程。

刚刚,鹅厂放了个大招:WorkBuddy开放平台,正式上线。
这和我之前在群里的判断一致:WB正在生态上发力,软硬件一起建设。
前段时间还只是邀测,今天正式上线了,所有个人开发者、公司都可以入驻,目前免费。
这意味着什么?
简单说,以前你想做一个AI Agent产品,得先自己造一个Agent——这件事,99%的个人和公司都造不起。现在,腾讯把造好的Agent底座直接端出来了。你的业务、服务、技能、工作流,搬上去就能跑。
你负责造场景、造应用,WorkBuddy负责提供Agent OS。
如何使用?
这次WorkBuddy一口气开放了5个生态能力:Buddy应用、专家、Skill、连接器和硬件。

一个个说。
- Buddy应用,特别适合垂直行业,比如搞金融、法律、医疗、教育、设计、视频制作的朋友,你只需要把场景、业务上下文、工具能力和品牌接进来,无需自研AI Agent,就能获得一个自己品牌的垂类Agent产品。
- 专家(Expert),有点类似知识库,将你这个行业的Know-How、专业经验进行封装。接到wb里后,就可以公开调用。可以单Agent,也可以组Agent Team。
- Skill,这个就不多解释了,万物都可以Skill。
- 连接器(Connector),可以是MCP,也可以是CLI,以API形式让Agent连接外部系统,比如邮箱、飞书、文档、ima、GitHub等,都能接进来。
- 硬件,所有旧硬件无需自己再造Agent,直接连上wb就行。第一批,他们接入了30多个硬件品牌,基本覆盖“听、看、记、聊、协”等核心场景。

来自好友@AJ 的现场图
认识这五大能力后,下面我们来实操一下,怎么接入WorkBuddy开放平台。
首先注册WorkBuddy开放平台账户。

注册后需要进行认证,可以选个人认证,也可以选企业认证。
这里说明一下,能企业认证的话尽量选企业认证,这样五大能力都可以接入。如果是个人认证的话,Buddy应用和硬件,无法使用。
企业认证,也很简单,先上传营业执照,然后法人扫一下人脸就行。

如果你没有公司,也可以先个人认证,后面再企业认证。一个账号,可以同时做个人认证和企业认证。
认证后,就能进入后台了。

我们选择「技能」,上传一个Skill试试看。

它提示我YAML区的格式不对,这个倒很简单,直接用我开源的markdown编辑器改一下就行。
建议大家按照这个格式来写Skill,这样可以快速通过。
—
name: your-skill-name
display_name: 展示名称
display_name_en: 英文名称
description: 一句话描述技能能力
description_zh: 简短中文介绍
description_en: A Brief English Introduction
category: 分类名 # 分类之一
version: 1.0.0
author: 合作方名称
—
# 技能指令正文
当用户需要做 XX 时,按以下步骤执行:
1. …
2. …
3. …
以及推荐的Skill结构:
skills/
└── {skill-name}/
├── SKILL.md # ★ 技能定义(必须)
├── references/ # 参考资料(可选)
│ ├── api-spec.md # API 规范、字段类型等
│ └── examples.md # 示例数据
├── scripts/ # 可执行脚本(可选)
│ ├── fetch-data.js # 数据获取脚本
│ └── transform.py # 数据处理脚本
└── templates/ # 模板文件(可选)
├── report.sh # 报告生成模板
└── workflow.sh # 工作流模板格式
注意,所有冒号后面都要空一格,不然就像我这样……一直在YAML区改了七八遍,才上传成功。

同时,也尽量不用引号“”,不然很容易解析失败。给大家看下我最终上传成功后的Skill YAML区。

上传后,接下来就是做一些配置了,多数内容它都已经自动解析好了,主要就是选分类、服务类目和头像。

说到这里,必须吐槽一下,腾讯的大多数产品后台都比较难用。都AI时代了,居然还是让用户一个个去点选,不支持意图识别。
而且,我这个Skill在服务类目找了半天,硬是找不出符合它的类目。尤其是AI相关的,很难找到合适的类目。

最后,索性选了一个商业服务类目。之后,这个Skill就可以提交审核了。

后面,大家在WorkBuddy技能市场直接搜「视频提示词专家」,就可以调用我这个Skill了。

预计多久能用呢?官方说7个工作日左右,审核通过后会通知我。

其他的连接器、专家和专家团,也基本是同样的流程。
连接器,支持MCP+Skill和CLI+Skill的方式,两种都可以。
MCP + Skill的基础结构:
your-connector/
├── connector-meta.json # 连接器元信息(必须)
├── mcp.json # MCP Server 连接配置(必须)
├── icon.svg # 市场图标(必须)
└── skills/ # AI 使用说明(可选)
└── {skill-name}/
└── SKILL.md
CLI + Skill的基础结构:
your-cli-connector/
├── connector-meta.json # 连接器元信息(必须,type 为 cli)
├── cli.json # CLI 安装与认证配置(必须)
├── icon.svg # 市场图标(必须)
└── skills/
└── {skill-name}/
└── SKILL.md # CLI 使用说明(强烈推荐)
专家,支持单Agent的专家和多Agent Team的专家团。
专家的基础结构:
my-expert/
├── .codebuddy-plugin/
│ └── plugin.json
├── avatars/
│ └── expert.png
├── agents/
│ └── my-expert.md
└── README.md
专家团的基础结构:
my-team/
├── .codebuddy-plugin/
│ └── plugin.json # ★ 配置文件(必须)
├── avatars/ # ★ 头像目录(必须)
│ ├── team.png # 团队头像
│ ├── team-lead.png # 主理人头像
│ ├── member-a.png # 成员头像
│ └── member-b.png # 成员头像
├── agents/ # ★ Agent 定义(必须)
│ ├── {team}-team-lead.md # 主理人(名称须加专家团前缀,不可用通用 team-lead)
│ ├── member-a.md # 成员 A
│ └── member-b.md # 成员 B
├── skills/ # 共享技能(可选)
│ └── {skill-name}/
│ ├── SKILL.md
│ ├── references/
│ ├── scripts/
│ └── templates/
├── .mcp.json # 内置 MCP / 连接器依赖声明(可选,见第六节)
├── bin/ # 可执行文件(可选)
├── settings.json # ★ 设置主理人(必须)
└── README.md # 说明文档(推荐)
Buddy应用,你可以理解为是垂直行业的AI Harness,你无需自己再搭一套AI产品,而是直接通过Buddy应用封装,就可以把将行业的know-how整合到WorkBuddy里。
Buddy应用可以自定义System Prompt,内置工具,模型配置以及场景胶囊等。用户端,最后看到的界面是这样。

硬件接入,采用的是第三方调API的方式接入WorkBuddy,这是整体接入流程。

以上,就是WorkBuddy开发平台的整体接入流程,希望能够对你有所帮助。
写在最后
提起Agent OS,这个词已经被用烂了。
但说实话,直到今天,我才在WorkBuddy开放平台上看清楚了Agent OS的实际摸样。
当然,它问题也不少。流程糙、审核慢、后台难用,商业化方面也暂无具体的方案。
它也不是第一个这么玩的,阿里的骡子快跑、字节的Coze,都是类似的做法。
但门槛和用户量这块,WorkBuddy毫无疑问是目前国内最具优势的Agent。你接进去,等于直接站在了一个现成的用户入口上,不用从零获客。
所以,对于开发者来说,我的建议就一句话:不用想那么多,先上车,占个坑再说。
本文由人人都是产品经理作者【沃垠AI】,微信公众号:【沃垠AI】,原创/授权 发布于人人都是产品经理,未经许可,禁止转载。
题图来自Unsplash,基于 CC0 协议。

起点课堂会员权益





Buddy应用的设计对垂直行业是真友好。金融、法律、医疗这类领域最难的本来就不是造Agent,而是把行业Know-How整理成可以用、可验证的流程。WorkBuddy把Agent OS这部分做完了,行业方反而能把精力放到业务上下文和工具集成上,这个分工比让行业方自己从零搭Agent靠谱。