> ## 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.

# 高代码智能体

高代码路径适合需要自定义逻辑、工具或多智能体编排的场景：你从模板脚手架一个项目，直接编写智能体代码，再由 CLI 在云端构建镜像并部署为运行时。闭环从脚手架开始，经编辑、部署、调用、查看日志，最终回到编辑持续迭代。

<Note>
  开始前请先配置 AK/SK，或通过 [SSO 登录](/productions/agentkit-cli/preview/zh/commands/auth)获取短期 STS 凭证。`launch`、`deploy` 和 `invoke` 会按统一的凭证优先级读取有效凭证。配置方法见[快速开始](/productions/agentkit-cli/preview/zh/quickstart)的「鉴权」一节。编写智能体代码的完整说明见 [VeADK 文档](/productions/veadk/preview/zh/index)。
</Note>

<Steps>
  <Step title="脚手架项目">
    从内置模板创建项目。运行 `agentkit init --list-templates` 可先列出全部模板。

    ```bash lines theme={null}
    agentkit init my-agent --template basic --directory my-agent
    cd my-agent
    ```
  </Step>

  <Step title="编辑智能体">
    修改脚手架生成的代码，调整智能体的指令、工具与编排逻辑。

    <Note>
      运行时容器必须监听 `0.0.0.0:8000`，以通过就绪探针。模板已默认满足该要求，通常无需改动。
    </Note>
  </Step>

  <Step title="配置模型与目标云环境">
    参照[快速开始](/productions/agentkit-cli/preview/zh/quickstart#创建并配置项目)选择火山引擎或 BytePlus，并配置模型名称、API 地址和 API Key。部署凭据和模型凭据用途不同，不能只完成 CLI 登录就跳过模型配置

    在项目根目录的 `.gitignore` 和 `.dockerignore` 中加入 `agentkit.yaml` 与 `.env`，再将已导出的模型变量写入生命周期配置

    ```bash lines theme={null}
    agentkit config \
      --runtime_envs "MODEL_AGENT_NAME=$MODEL_AGENT_NAME" \
      --runtime_envs "MODEL_AGENT_API_BASE=$MODEL_AGENT_API_BASE" \
      --runtime_envs "MODEL_AGENT_API_KEY=$MODEL_AGENT_API_KEY" \
      --runtime_envs "MODEL_AGENT_PROVIDER=openai"
    agentkit config --show
    ```

    该命令将真实取值写入本地 `agentkit.yaml`；根目录配置不会自动展开文件里的 `${VAR}`
  </Step>

  <Step title="构建并部署">
    执行完整生命周期流程，在云端构建镜像并创建或更新运行时。

    <Warning>
      `launch` 会构建镜像并创建或更新云资源，可能产生费用；更新还会改变已有 Runtime 的行为。先核对配置、目标账号、地域与项目
    </Warning>

    ```bash lines theme={null}
    agentkit launch
    ```

    <Tip>
      需要在脚手架与构建之间检查或手改 `agentkit.yaml`、`Dockerfile` 时，可先运行 `agentkit config --show`，再分步执行 `agentkit build` 与 `agentkit deploy`。详见[配置](/productions/agentkit-cli/preview/zh/commands/config)、[构建](/productions/agentkit-cli/preview/zh/commands/build)与[部署](/productions/agentkit-cli/preview/zh/commands/deploy)。
    </Tip>
  </Step>

  <Step title="调用运行时">
    读取当前项目的 `agentkit.yaml` 调用运行时，验证部署结果。

    ```bash lines theme={null}
    agentkit invoke run "你好，介绍一下你自己"
    ```
  </Step>

  <Step title="查看与迭代">
    运行时行为异常时先看日志；修改代码后重新部署即可发布新版本。

    ```bash lines theme={null}
    agentkit runtime logs my-agent --limit 200
    agentkit launch
    ```

    需要回滚或调整资源时，借助版本与更新命令：查看历史用 `agentkit runtime versions my-agent`，发布指定版本用 `agentkit runtime release my-agent --rev <n>`，调整 CPU 与内存用 `agentkit runtime update my-agent --cpu-milli 1000 --memory-mb 2048 --auto-release`。
  </Step>
</Steps>

不再需要该运行时时，将其删除以释放资源：

<Warning>
  删除会立即影响线上调用，且无法恢复。先确认目标 Runtime 并保留需要的业务数据
</Warning>

```bash lines theme={null}
agentkit runtime delete my-agent -y
```

只需配置、无需编写代码时，改用[使用 Harness](/productions/agentkit-cli/preview/zh/workflows/harness)。