> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 初始化项目

`init` 基于内置模板创建新的智能体项目，也可以把已有 Python 文件中的 `Agent` 包装为可部署的 AgentKit 应用。生成结果包含入口文件、依赖文件、`agentkit.yaml` 和 `.dockerignore`；随后可用 `agentkit config` 调整配置，并用 `agentkit launch` 构建与部署。

## init

从内置模板创建项目。不传 `--template` 时，命令会展示模板列表并要求输入模板 ID、Key 或名称；也可以用 `--list-templates` 只查看模板后退出。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `[project_name]` | 项目名称。 | `simple_agent` |
| `-t, --template <template>` | 模板 ID、Key 或名称。可用 Key：`basic`、`basic_stream`、`a2a`、`eino_a2a`、`agent_server`、`langchain_basic_stream`、`basic_go`、`a2a_go`。 | 交互选择 |
| `--directory <path>` | 文件写入目录；相对路径以当前目录为基准，不会再追加项目名称 | `.` |
| `--agent-name <name>` | 智能体名称。 | `Agent` |
| `--description <text>` | 智能体描述。 | 模板默认值 |
| `--system-prompt <text>` | 智能体系统提示词。 | 模板默认值 |
| `--model-name <name>` | 火山方舟模型名称。 | 模板默认值 |
| `--model-api-base <url>` | 模型 API Base URL。 | — |
| `--model-api-key <key>` | 模型 API Key；会写入运行时环境变量配置。 | — |
| `--tools <list>` | 要包含的工具列表，多个值用逗号分隔。 | — |
| `--list-templates` | 列出模板 ID、Key 和名称后退出。 | `false` |

`--model-api-key` 会将实际密钥写入生成的 `agentkit.yaml`。建议先只生成项目，再按[快速开始](/productions/agentkit-cli/preview/zh/quickstart)配置忽略文件和模型凭据，避免把密钥提交或打包到镜像

```bash lines theme={null}
agentkit init my-agent --template basic --directory ./my-agent

agentkit init go-agent --template basic_go --directory ./apps/go-agent
```

不传 `--directory` 时，文件直接写入当前目录。上例分别写入 `./my-agent` 和 `./apps/go-agent`；进入对应目录后再配置或部署

## init --from-agent

从已有 Python 文件包装一个 VeADK `Agent`。CLI 会复制原文件，生成包装入口和 `requirements.txt`，并创建生命周期配置。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `[project_name]` | 项目名称；省略时按源文件名生成。 | `agentkit-<file>` |
| `-t, --template <template>` | 选择与 `--from-agent` 兼容的模板：`basic`、`basic_stream` 或 `agent_server`。传入后会自动映射为对应包装类型。 | — |
| `-f, --from-agent <path>` | 包含 `Agent` 定义的 Python 文件路径。 | 必填 |
| `--agent-var <name>` | 文件中的 `Agent` 变量名；省略时自动检测。 | 自动检测 |
| `--wrapper-type <type>` | 包装类型：`basic`、`stream` 或 `agent_server`；与 `--template` 同时使用时必须匹配。 | `basic` |
| `--directory <path>` | 文件写入目录；相对路径以当前目录为基准，不会再追加项目名称 | `.` |

```bash lines theme={null}
agentkit init wrapped-agent --from-agent ./agent.py --agent-var root_agent --directory ./wrapped-agent

agentkit init wrapped-server --from-agent ./agent.py --template agent_server --directory ./wrapped-server
```

初始化后进入 `--directory` 指定的目录，按[快速开始](/productions/agentkit-cli/preview/zh/quickstart)配置云平台、模型和凭证，再执行部署命令。以上方 `wrapped-agent` 为例：

```bash lines theme={null}
cd wrapped-agent
agentkit launch
```