必须通过导入标准JSON配置文件复用智能体配置;仅支持同版本导出或官方CLI生成的JSON文件,不兼容其他格式及旧版文件;控制台导入需勾选“覆盖同名Agent”,OpenAPI导入需注意连接器授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 AgentSpace 中快速复用已有智能体配置、避免重复搭建流程,必须通过导入标准格式的配置文件完成初始化。
确认配置文件格式与来源
AgentSpace 仅支持导入 JSON 格式的配置文件,该文件需由同版本 AgentSpace 导出,或由官方 CLI 工具生成。其他格式(如 YAML、XML、TXT)直接上传会触发校验失败,页面提示“无效的配置结构”。
若你手头是旧版导出文件,请先在控制台右上角点击「版本兼容检查」按钮验证——不兼容的文件无法跳过校验直接导入。
从控制台导入配置文件
登录 AgentLoop 控制台 → 进入目标 AgentSpace → 左侧导航栏点击「Agent 管理」→ 右上角点击「导入」按钮。
在弹出窗口中,点击「选择文件」,定位并选中已准备好的 JSON 配置文件 → 勾选「覆盖同名 Agent」(如存在重名,不勾选将导致导入中断)→ 点击「确认导入」。
【导入过程不可逆,覆盖操作会删除当前空间中同名 Agent 的全部运行时状态、历史会话及调试日志】
使用 OpenAPI 批量导入(适合多 Agent 场景)
方法一:调用 /v1/agent/import 接口,以 multipart/form-data 方式上传 JSON 文件,并在 form field 中指定 space_id 和 overwrite=true。
方法二:若需预检配置合法性,先调用 /v1/agent/import/validate,传入 base64 编码的 JSON 内容;返回 valid: true 后再执行正式导入。
注意:OpenAPI 导入不校验 Agent 所依赖的连接器是否已在当前空间启用——若缺失,导入成功但 Agent 将处于「未就绪」状态,需手动补全连接器授权。


















