腾讯云 WorkBuddy 开放平台接入实战:企业开发者从入驻到上架全流程指南,企业想把一套内部系统能力、或者多年沉淀的行业经验,封装成能随叫随到的 AI,传统路子得先自己造一个 Agent 底座——这件事对绝大多数团队都是门槛。2026 年 9 月 2 日腾讯 WorkBuddy 生态发布会上,开放平台正式上线,把底层的 Agent 能力、模型接入、分发渠道一次性开放出来。作为腾讯云 WorkBuddy 授权伙伴,我们在帮企业客户做部署落地时,把入驻到上架的完整路径走了一遍,本文把实操步骤和踩过的坑整理出来,供开发者参考。

注:下文以企业主体视角为主,因为 Buddy 应用和硬件接入这两类能力,个人认证是用不了的。
平台首期开放了五大生态能力,对应不同的封装形态:
做哪一行的业务,大概就能对上哪类资产。比如有现成 API 的后端团队做连接器最顺;有行业 know-how 的个人或团队做专家更合适;想先试水的开发者从 Skill 切入最轻。
第一次注册开放平台,必须先完成实名认证,个人或企业二选一。
个人认证只需四样:中国大陆二代身份证、本人实名手机号、能收验证码的邮箱、一台能人脸识别的手机。注意一个身份证在全平台只能认证一个个人主体。
企业认证有三种方式,按企业情况挑:
企业认证走下来,管理员先做实名,上传营业执照由系统 OCR 识别企业名称、统一社会信用代码和法定代表人,核对后填开发者昵称,最后完成验证。认证成功后,操作账号自动成为该企业的超级管理员。
几个容易忽略的限制:每个账号最多认证 10 个企业主体;同一家企业最多被 50 个账号分别认证;认证通过后,还要在「设置—开发者信息」补齐开发者资料(头像 512×512、昵称全平台唯一 2–20 字符、简介 20–120 字符、联系方式至少 1 项),这一步不做完,发布管理的开发入口是不解锁的。
认证失败多半卡在三点:姓名 / 身份证 / 手机号三要素不是同一人;营业执照照片不清晰有反光;扫码授权的腾讯云或微信账号和营业执照不是同一家企业。对应换对资料重传即可。
开发板块实际有七项,最主流的是 Skill、连接器、专家,下面逐一看。
技能市场里用户点「添加技能 → 创建技能」,平台会跳进对话界面,补全提示词 AI 帮你生成;自己打包 zip 上传也可以。核心是 `SKILL.md`,YAML 头加 Markdown 正文:
```yaml
---
name: your-skill-name
display_name: 展示名称
description: 一句话描述技能能力
description_zh: 简短中文介绍
version: 1.0.0
author: 合作方名称
---
```
旁边可带三个子目录:`references`(参考资料)、`scripts`(可执行脚本)、`templates`(模板)。`description` 必须写清用途和触发词,直接决定用户问什么时你的技能被调起。
实测踩坑**:YAML 里所有冒号后面必须空一格,引号尽量不用,否则解析失败;`version` 是必填,漏了会直接报「缺少 Skill 版本号」。我们帮客户打包时,前几版都卡在缩进和冒号空格上。
已有 API 服务或能开发 MCP Server,走 MCP + Skill。硬要求:走 HTTPS,支持 SSE 或 streamableHttp,工具调用 30 秒内响应,且一个连接器只对应一个 MCP Server。存量系统没法直接上 MCP 的,走 CLI + Skill,需要用户授权的在配置里走 auth_mode,图标用 64×64 的 SVG。
连接器做的事,本质是把 QQ 邮箱、飞书、腾讯文档、GitHub、钉钉这些外部系统接进 Agent 工作流。提交前过一遍官方检查清单能省不少来回。
专家是一个插件包结构:plugin.json 定义元信息,agents 目录放 Agent 定义,avatars 放头像。规格硬要求:头像 512×512 PNG 且不超过 500KB,行业分类从 15 个里选,展示描述控制在 40–50 字,tags 配 3 个,快捷提示词 quickPrompts 配 3 条且第一条要和 defaultInitPrompt 对上。专家团只是多了主理人和成员的分工配置。
开放平台提供 Open API,核心端点包括 GET /openapi/v2/authorize(请求用户授权)和 POST /openapi/v2/token(换取 / 刷新 Access Token),走 OAuth 2.1,按能力分成认证授权、个人资料、本地助理、云端任务、ACP 通道、会话产物、兑换码核销几类。第三方应用接入拿用户授权后调 Open API 操作用户数据,client_secret 只在创建时明文展示一次,丢了只能找平台重置。
企业主体发布资产时要选服务类目,一共 23 个大类(物流、教育、医疗、金融、政务民生、IT 科技等),规则是至少选 1 个、至多 5 个,每个大类下还有二级三级分类和对应资质要求——做教育培训要办学许可证,做快递要快递业务经营许可证,涉及你行业的逐条核对。
审核要过三道:安全扫描 → AI 审核 → 人工抽检。发布范围可以多选:WorkBuddy 市场面向公开用户,WorkBuddy 企业市场面向企业客户。
企业认证完成后,可以在自己的主体上定制 Buddy 应用、Skill 和连接器,把内部系统、业务流程、行业经验装进 WorkBuddy,能力沉淀在企业自己名下,不散落在各家外部工具。Agent 基座、模型接入、分发渠道都由平台承担,企业不用从零搭一套;上架还有平台三道审核把关,比起随处接第三方通用工具,安全性和可信任度更可控。
这也是我们建议客户优先走企业认证的原因:短期看只是多一步营业执照上传,长期看是把自己公司的数字资产留在自己账户里。
Q1:个人认证能发布 Buddy 应用吗? 不能。Buddy 应用和硬件接入这两类能力仅企业认证可用,个人认证只能做 Skill、专家、连接器。
Q2:企业认证失败最常见的原因是什么? 三要素不一致(姓名 / 身份证 / 手机号非同一人)、营业执照照片反光不清晰、授权账号与营业执照企业不符,占绝大多数。
Q3:连接器响应超时怎么处理? 平台要求工具调用 30 秒内响应。超时先查 MCP Server 的网络与超时配置,确认走的是 HTTPS 且支持 SSE / streamableHttp,再排查具体工具逻辑。
Q4:审核一般要多久? 官方口径约 7 个工作日,实际受类目资质复杂度影响。安全扫描和 AI 审核较快,人工抽检是主要耗时环节。
Q5:一个账号能认证几家企业? 最多 10 个企业主体;同一家企业最多被 50 个账号分别认证。
Q6:开放平台本身收费吗? 开放平台入驻与资产发布目前免费;若企业同时需要 WorkBuddy 企业版席位(账号开通、知识库、私有化等),按腾讯云官方刊例计费,与开放平台分开。
本文由企动云测试整理。企动云是腾讯云 WorkBuddy 官方授权代理商,同时持有腾讯云与腾讯官方双授权:

100045575343,授权单位:腾讯云计算(北京)有限责任公司;QD48755526,授权单位:深圳市腾讯计算机系统有限公司。企动云可以全流程协助企业每一步都按腾讯云官方合规要求交付。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。