必须先确认项目已发布或归档且当前账号具备project:export权限,再通过控制台【部署】页签点击【导出项目】生成ZIP包,或调用OpenAPI/CLI批量导出;ZIP含配置与代码但不含敏感凭证、训练语料及向量索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 AgentSpace 平台中导出项目文件,必须先确认当前项目已完成构建并处于可发布状态,未保存的草稿或运行中的调试会话无法导出;导出操作仅对拥有“项目导出”权限的角色开放,普通协作者默认无此权限。
确认项目导出权限与状态
登录 AgentSpace 控制台 → 进入目标工作区 → 点击左侧导航栏【项目管理】→ 找到待导出项目,查看右侧“状态”列是否显示为【已发布】或【已归档】;若显示“构建中”“调试中”或“草稿”,则需先完成构建流程并点击【发布】按钮。
鼠标悬停在项目名称上 → 点击出现的【详情】图标 → 滚动至“成员与权限”区域 → 查看当前账号角色是否包含“导出”操作权限;如无,需联系空间管理员在【权限策略】中为该角色添加project:export动作。
通过控制台一键导出 ZIP 包
进入项目详情页 → 顶部导航栏切换至【部署】页签 → 点击右上角【导出项目】按钮 → 在弹窗中勾选“包含运行时配置”和“包含版本元数据”(建议全选)→ 点击【确认导出】。
导出任务提交后,页面自动跳转至【任务中心】,状态变为“打包中”;通常 10~90 秒内完成,完成后将生成一个以项目名+时间戳命名的 ZIP 文件,如 sales-assistant-v2.3-20260903-0652.zip;点击下载即可获取完整项目包,内含:config.yaml、skills/ 目录、assets/ 和 metadata.json。
注意:该 ZIP 不含训练语料或向量索引文件,如需迁移 RAG 数据,请另行从【知识库】模块单独导出。
使用 OpenAPI 批量导出多个项目
方法一:调用 POST /v1/projects/export/batch 接口
准备 JSON 请求体,指定项目 ID 列表与导出格式:
AI编程系统协调器。触发词:开发、实现、创建、添加、修复、报错、重构、优化、review、评审、继续、为什么、记住、保存经验、复盘、分析、学习、参考、模仿、/evolve
{"project_ids": ["proj-8a2f3c", "proj-d9e1b7"], "format": "zip", "include_runtime": true}
请求头需携带有效 Authorization: Bearer <your-token>,且 token 必须由具备 space:admin 权限的账号签发;响应返回 task_id,后续轮询 GET /v1/tasks/{task_id} 获取下载 URL。
方法二:通过 CLI 工具导出
安装最新版 agentspace-cli(v2.4.0+)→ 执行命令:agentspace project export --ids proj-8a2f3c,proj-d9e1b7 --output-dir ./exports;工具自动处理鉴权、轮询与文件落地,无需手动拼接 API。
导出后的文件结构说明
解压 ZIP 后,根目录下必含 project.yml,定义 Agent 编排逻辑;skills/ 下每个子目录对应一个 Skill,含 manifest.yml 与 handler.py(或 handler.js);assets/ 存放图标、提示词模板等静态资源。
【关键限制】:导出包不包含任何敏感凭证(如数据库密码、API Key),这些字段在导出时已被自动脱敏为占位符 {{SECRET_DB_PASSWORD}},部署前需人工补全或通过环境变量注入。
打开 project.yml → 查找所有 {{ 开头的变量 → 记录其名称,用于后续部署阶段的参数绑定。

















