高代码智能体

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

开始前请先配置 AK/SK，或通过 SSO 登录获取短期 STS 凭证。launch、deploy 和 invoke 会按统一的凭证优先级读取有效凭证。配置方法见快速开始的「鉴权」一节。编写智能体代码的完整说明见 VeADK 文档。

脚手架项目

从内置模板创建项目。运行 agentkit init --list-templates 可先列出全部模板。

agentkit init my-agent --template basic --directory my-agent
cd my-agent

编辑智能体

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

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

配置模型与目标云环境

参照快速开始选择火山引擎或 BytePlus，并配置模型名称、API 地址和 API Key。部署凭据和模型凭据用途不同，不能只完成 CLI 登录就跳过模型配置在项目根目录的 .gitignore 和 .dockerignore 中加入 agentkit.yaml 与 .env，再将已导出的模型变量写入生命周期配置

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}

构建并部署

执行完整生命周期流程，在云端构建镜像并创建或更新运行时。

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

agentkit launch

需要在脚手架与构建之间检查或手改 agentkit.yaml、Dockerfile 时，可先运行 agentkit config --show，再分步执行 agentkit build 与 agentkit deploy。详见配置、构建与部署。

调用运行时

读取当前项目的 agentkit.yaml 调用运行时，验证部署结果。

agentkit invoke run "你好，介绍一下你自己"

查看与迭代

运行时行为异常时先看日志；修改代码后重新部署即可发布新版本。

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。

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

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

agentkit runtime delete my-agent -y

只需配置、无需编写代码时，改用使用 Harness。

开始使用

AI-Friendly

命令参考