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