需通过官方上传通道发布自定义智能体：一、准备符合规范的ZIP包（含agent.yaml、main.py、requirements.txt等）；二、控制台上传并填写元数据；三、CLI工具命令行上传；四、Git仓库Webhook自动同步上传。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已开发完成一个自定义智能体并希望将其发布至MuleRun平台供他人调用或复用，则需通过官方上传通道提交Agent包。以下是完成此操作的步骤：

一、准备Agent标准包结构

上传前必须确保Agent以MuleRun兼容格式组织，包含核心配置文件与可执行逻辑。系统仅接受符合规范的ZIP压缩包，否则将拒绝解析并返回结构校验错误。

1、在本地创建根目录，命名为您的Agent名称（如my-data-cleaner）。

2、在该目录下放置必需文件：agent.yaml（定义元数据、输入输出schema、依赖插件）、main.py（主执行逻辑，含run()函数入口）、requirements.txt（指定Python依赖及版本）。

3、若Agent需调用外部API或读取知识库，须在agent.yaml中明确定义credentials字段与rag_sources列表，并标注是否需要用户授权。

4、使用命令行进入该目录，执行zip -r my-data-cleaner.zip .，生成不含父级路径的扁平化ZIP包。

二、通过控制台上传入口提交Agent

该方式为最直接的发布路径，适用于首次提交或版本迭代更新，所有字段均在Web界面内完成填写与验证。

1、登录MuleRun控制台，点击左侧导航栏的「Files」选项卡。

2、在页面右上角点击「Upload Agent」按钮，触发文件选择弹窗。

3、选中已准备好的ZIP包文件，点击确认后系统开始前端校验，检查文件大小（≤50MB）、包内结构完整性及YAML语法有效性。

4、校验通过后，自动跳转至元数据填写页：补全Agent名称、描述、分类标签（如“数据处理”“RAG增强”）、图标URL（可选）、是否公开（勾选则进入Agent市场）。

5、点击「提交审核」，系统生成唯一Agent ID并进入人工+自动化双审流程，状态显示为“Pending Review”。

三、使用CLI工具执行命令行上传

该方式面向开发者，支持批量管理与CI/CD集成，上传过程绕过浏览器限制，可携带签名密钥实现可信源认证。

1、在终端执行pip install mulerun-cli安装官方命令行工具。

2、运行mulerun login，按提示输入账户邮箱与API Key完成身份绑定。

3、执行mulerun agent upload --file ./my-data-cleaner.zip --visibility public --tags "cleaning, csv"。

4、命令返回JSON响应，包含upload_id、status（uploaded）、agent_id（如agnt_8a3f9b2c）及审核链接。

5、后续可通过mulerun agent status --id agnt_8a3f9b2c实时查询审核进度，状态变为“Approved”即表示上传成功并可被调用。

四、通过Git仓库自动同步上传

该方式适用于持续开发场景，当代码托管于GitHub、GitLab等平台时，可配置Webhook实现Push即部署，每次提交符合规则的分支将触发自动打包与上传。

1、进入MuleRun控制台「Developer Settings」→「Git Integrations」，点击「Connect Repository」。

2、授权MuleRun访问目标仓库的读取权限，选择需监听的仓库与分支（默认main）。

3、在仓库根目录添加.mulerun.yml配置文件，声明build_path（如./src）、entry_file（如main.py）、trigger_pattern（如"agents/**"）。

4、向匹配路径推送一次提交，MuleRun检测到变更后自动拉取代码、执行打包脚本、生成ZIP并调用内部上传接口。

5、上传任务日志可在「CI Logs」面板查看，成功标志为“Agent registered with ID: agnt_xxx”。