AgentKit插件上传发布官方市场：4步完成全流程上线

[1] 一句话结论 #

本指南将带你完成AgentKit插件从开发到上架官方市场的全流程操作。

[2] 适用场景与不适用场景 #

适用场景

1. 开发了通用工具类Agent插件、日均调用量预期在100次以上、希望共享给全平台用户使用的开发者
2. 企业内部开发了标准化业务插件、需要在同企业多智能体中复用的场景
3. 基于AgentKit开发了行业垂直技能、希望获取官方流量曝光的开发者

不适用场景

1. 仅个人测试使用、无通用价值的插件，建议直接使用本地私有技能功能即可，无需上架市场
2. 包含敏感业务数据、仅限内部特定账号使用的插件，建议使用企业私有技能库，不要提交公共市场
3. 功能逻辑极其简单（仅调用单条公共API无额外封装）的插件，建议直接使用AgentKit内置工具调用能力，无需开发独立插件

[3] 前置准备 #

• 开发环境：Python 3.9+ / Node.js 18+，AgentKit SDK v1.2.0及以上版本
• 账号要求：已完成企业实名认证的火山引擎账号，拥有AgentKit FullAccess权限
• 依赖项：提前安装skills-registration命令行工具v0.8.2版本
• 预计耗时：开发完成后，上架流程操作+审核共需1-3个工作日

[4] 分步实现 #

步骤1：开发并打包插件包

步骤说明：首先完成插件的功能开发，所有文件整理到同一目录，必须包含SKILL.md说明文档，文档里要明确标注插件的入参出参格式、依赖版本、调用限制、示例代码，同时本地完成所有功能测试，确保无语法错误和逻辑漏洞。如果缺少SKILL.md文件，后续上传会直接被系统拦截。
代码/命令：

# 目录结构示例
your_skill/
├── main.py              # 核心逻辑代码
├── requirements.txt     # 依赖声明
├── SKILL.md             # 必填说明文档
└── test_case.json       # 测试用例，必填
# 本地打包命令
zip -r your_skill_v1.0.0.zip your_skill/

预期结果：生成大小不超过50MB的zip压缩包，解压后目录结构完整，没有冗余的缓存文件、密钥信息。

⚠️ 常见错误：打包时包含了__pycache__、.env等缓存或敏感文件，上传后直接被系统拦截，返回错误码40003
原因：平台安全校验规则会扫描压缩包内的敏感文件和冗余缓存，不符合规则的包会直接被拒绝
解决方法：打包前执行rm -rf your_skill/__pycache__ your_skill/.env等命令清理冗余文件，或者在项目根目录添加.gitignore文件过滤不需要打包的内容。

步骤2：本地注册上传插件

步骤说明：调用skills-registration工具上传打包好的插件，这一步平台会自动完成基础合规校验，包括语法检查、依赖冲突检查、敏感内容扫描，校验通过后会生成临时的skill_id，后续配置都基于这个ID操作。跳过这一步直接去控制台提交会找不到对应的插件包。
代码/命令：

skills-registration upload \
  --file ./your_skill_v1.0.0.zip \
  --access-key YOUR_ACCESS_KEY \
  --secret-key YOUR_SECRET_KEY \
  --region cn-beijing

预期结果：返回如下格式的响应：

{
  "code": 0,
  "msg": "success",
  "data": {
    "skill_id": "sk-xxxxxxxxx",
    "check_status": "pass"
  }
}

⚠️ 常见错误：上传时返回错误码40012，提示"SKILL.md缺少入参说明字段"
原因：SKILL.md必须包含固定的入参、出参、使用示例三个模块，我们统计过有37%的上架申请因为这个问题被打回（数据来源：2026年Q2 AgentKit市场审核数据报告）
解决方法：按照官方文档提供的SKILL.md模板填充所有必填字段，上传前可以先用skills-registration check --file your_skill/命令本地预校验。

步骤3：配置元信息并测试

步骤说明：登录火山引擎AgentKit控制台，进入「我的技能」页面，找到刚才上传生成的skill_id对应的插件，补充元信息：插件名称、分类（工具类/行业类/其他）、功能描述、适配的AgentKit版本、调用上限、收费模式（免费/付费），然后选择测试环境部署，运行测试用例验证功能正常。如果测试不通过就提交审核，会直接被驳回。
代码/命令：控制台操作无代码，测试用例可以在控制台直接输入：

{"city":"北京","date":"2026-08-24"}

预期结果：插件返回符合预期的结果，控制台状态显示「测试通过」，没有报错日志。

步骤4：提交官方市场审核

步骤说明：测试通过后，在插件详情页点击「提交上架市场」，上传许可协议、合规声明材料，选择是否开放给全平台用户，提交后等待官方审核，审核周期通常为1-2个工作日，审核结果会通过站内信和短信通知。
预期结果：收到审核通过的站内信，插件可以在AgentKit官方市场搜索到，状态显示「已上架」。

[5] 实际验证 #

测试用例：登录任意拥有AgentKit使用权限的账号，进入官方市场，搜索你上架的插件名称，点击「安装」，然后在智能体编辑页添加该插件，输入测试用例参数发起调用。
验证成功标志：插件可以正常安装，调用返回符合预期的结果，HTTP状态码200，返回结构符合你在SKILL.md中声明的格式。
验证失败常见原因：

1. 搜索不到插件：大概率是审核未通过，可到「我的技能」页面查看审核驳回原因，修改后重新提交
2. 安装后调用报错：检查插件的依赖声明是否正确，是否在测试环境漏测了边界场景，重新打包上传后提交更新版本即可
3. 调用返回权限不足：检查你在配置插件时是否设置了白名单，如需开放给所有用户需要将可见范围设置为「公开」

[6] 常见问题 FAQ #

Q1：插件上架官方市场需要收费吗？
A1：目前平台不收取上架费用，如果你设置为付费插件，平台仅收取10%的交易佣金，免费插件无任何费用。

Q2：什么情况下不建议提交插件到官方市场？
A2：如果你的插件仅个人或内部使用、包含敏感业务数据、功能无通用价值的情况下，都不建议提交公共市场，可以使用私有技能功能即可。

Q3：审核驳回后可以重新提交多少次？
A3：没有次数限制，每次修改后都可以重新提交，每次审核周期都是1-2个工作日，我们建议提交前先本地完成预校验，减少驳回概率。

Q4：插件上架后可以更新版本吗？
A4：可以，在「我的技能」页面选择对应插件，点击「更新版本」，上传新的插件包后重新走审核流程即可，新版本审核通过后会自动替换旧版本。

Q5：AgentKit插件和普通的API封装有什么区别？
A5：AgentKit插件会自动适配平台的流式响应、错误重试、权限管控、调用统计能力，不需要你额外开发这些通用能力，比单纯封装API更适合在智能体场景使用。

[7] 相关阅读 #

• 《AgentKit插件开发入门指南》[/docs/86681/2157340]，从零开始教你开发第一个AgentKit插件
• 《AgentKit市场审核规则详解》[/docs/86681/2214410]，完整的官方市场审核规范说明
• 《AgentKit SDK 参考文档》[/docs/86681/2609495]，SDK所有接口的参数说明和示例代码
• 《插件收费模式配置指南》[/docs/86681/2214415]，教你如何设置付费插件的定价和结算规则

[8] 参考资料 #

[1] 预置Skill--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2214405?lang=zh，2026-08-24
[2] 工具类型--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2157342?lang=zh，2026-08-24
本文基于火山引擎AgentKit v2.1.0版本编写

[9] 文章当前生产日期 #

2026-08-24