更新时间：2026-04-15 GMT+08:00
导入Skill
AgentArts支持导入压缩包和导入OBS资源。
- 导入压缩包：在AgentArts平台中，用户可以通过“导入压缩包”功能，将本地开发完成的资源包上传至平台，平台会自动解析、检测、适配并部署到对话系统中使用。该功能适用于以下场景：
- 已通过第三方工具生成资源包。
- 在本地编写了完整的资源文件。
- 想要将已有技能或资源快速集成到AgentArts平台中。
- 导入OBS资源：如果您在对象存储服务（OBS）中已存有开发完成的资源包，可以通过AgentArts工作台的“导入OBS资源”功能，将其快速集成到平台中。AgentArts智能引擎会自动拉取远程资源、解析包结构、执行深度安全性检测、补全元数据信息，并重新打包，以便在Agent编排或对话中直接调用。详细对象存储服务（OBS）资源获取操作详见分享对象。
该功能特别适用于以下场景：
- 已在OBS桶中存储了构建好的资源文件，需快速引入平台。
- 资源包体积较大，通过本地上传耗时较长或易受网络限制。
- CI/CD自动化流水线将构建产物直接输出至OBS，需实现无缝集成。
资源包格式要求
上传的资源包必须满足以下格式要求：
- 文件格式：
- 导入压缩包：
- 仅支持上传ZIP文件，文件大小≤10MB;
- 名称格式需要满足条件：
- 长度在2到64个字符。
- 只能包含小写字母（a-z）、数字（0-9）和连字符（-）。
- 必须以字母或数字开头和结尾，不能以连字符开头和结尾。
- 解压后需有且仅有1个文件夹，命名与Skill.md中的Skill名称一致，Skill.md需位于文件夹内根目录下，详细内容请参考Skill的制品包规范。
- 导入OBS资源：将Skill ZIP文件上传至对象存储OBS服务，获取文件URL并在此传入，文件大小≤10MB。
- 导入压缩包：
- 推荐结构：
- SKILL.md：资源包说明文件，描述资源的功能、使用方式、依赖项等。
- skill.json：资源配置文件，定义资源的元信息。
- code/：资源代码目录，包含实现逻辑的脚本或模块。
- assets/：资源依赖的静态文件（如图片、模板等）。
如果上传的资源包不符合规范，AgentArts会尝试自动适配，并可能通过对话方式向你收集缺失信息。
导入Skill步骤
- 登录AgentArts智能体开发平台。
- 选择左侧导航栏“开发中心 > 组件库 ”，单击左上角“Skill”页签并单击“导入”下来框，选择“导入压缩包”或“导入OBS资源”。本文以导入压缩包为例：
图1 导入压缩包
- 单击“导入”，即可成功导入压缩包。
图2 导入成功
常见问题
- 问题：上传失败，提示“文件格式不支持”。
解决方案：
- 确保文件扩展名为.zip。
- 如果是.rar或其他格式，请先转换为.zip。
- 使用压缩工具（如 WinRAR、7-Zip）将文件打包为.zip 格式。
- 问题：上传后提示“Skill 包结构不完整”
原因：Skill包缺少必要文件，如SKILL.md 或 skill.json。
解决方案：
- 确保 Skill 包中包含以下文件：
- SKILL.md：技能说明文件
- skill.json：技能配置文件（可选）
- code/：技能代码目录
- assets/：资源文件目录（可选）
- 检查文件路径是否正确，避免嵌套过深或路径错误。
- 确保 Skill 包中包含以下文件：
- 问题：Skill无法解析或执行失败
原因：Skill包中的代码存在语法错误、依赖缺失或环境配置错误。
解决方案：
- 在本地环境中测试Skill脚本，确保其可以正常运行。
- 检查代码中是否使用了平台不支持的库或语法。
- 确保所有依赖项已正确安装（如Python 3.x、Node.js等）。
