---
name: import-agent
description: Import an Agent from a .akita-agent package file. Installs the Agent profile and any bundled skills to the local system.
system: true
handler: agent_package
tool-name: import_agent
category: Agent Package
---

# Import Agent

从 `.akita-agent` 包文件导入 Agent，安装 Agent 配置和捆绑技能到本地。

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|-----|------|-----|------|
| package_path | string | 是 | .akita-agent 包文件路径 |
| force | boolean | 否 | 如果 ID 冲突是否强制覆盖（默认 false） |

## Import Behavior

1. 校验包格式和安全性
2. 安装捆绑技能到 `skills/custom/` 目录
3. 创建 Agent Profile（type 强制为 custom）
4. 如果 ID 冲突且未 force，自动追加后缀

## Related Skills

- `export-agent`: 导出 Agent 包
- `inspect-agent-package`: 导入前预览包内容