需用VeADK CLI初始化项目：执行npm create veadk@latest，选空模板生成标准结构及依赖；运行veadk dev启动本地服务；通过.md定义Skill或.yaml导入MCP服务；在agent.ts中用useSkill调用并发布至生产环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在火山引擎AgentKit平台上，用官方SDK快速搭建一个可上线的业务智能体，跳过繁琐配置和环境适配，直接进入核心逻辑开发与本地验证环节。
安装VeADK SDK并初始化项目
打开终端，执行 npm create veadk@latest，按提示输入智能体名称（如customer-support-agent）和描述，选择“空模板”而非预置场景。
这一步会自动拉取最新版VeADK CLI工具、生成标准目录结构，并安装@volcengine/veadk-core等必需依赖。若跳过此步直接npm install手动装包，将缺失veadk dev调试命令和veadk build构建脚本，后续无法启动本地服务。
进入项目根目录后，运行 veadk dev 启动本地开发服务器，默认监听http://localhost:3000。
定义核心业务能力：注册Skill与MCP服务
方法一：用自然语言创建Skill
在skills/目录下新建refund-policy.md，首行写---，第二行写name: 退换货政策查询，接着用中文描述业务规则：“当用户询问退货时效、运费承担、商品状态要求时，从知识库中提取对应条款，不编造未覆盖情形。”保存后，VeADK会在dist/skills/自动生成可注册的JSON Schema文件。
方法二：导入已有MCP服务
若企业已有HTTP接口提供订单状态查询，将该API的OpenAPI 3.0规范YAML文件放入mcp/目录，文件名必须以.yaml结尾；VeADK构建时会自动将其转换为MCP Server并注入运行时上下文。
【注意：MCP YAML文件必须包含info.version字段，否则构建失败且无明确报错】
编写Agent主逻辑：组合Skill与记忆流
打开src/agent.ts，删除默认示例代码，粘贴以下最小可行逻辑：
import { defineAgent, useSkill, useMemory } from '@volcengine/veadk-core';
export default defineAgent({
name: '客服助手',
description: '处理电商用户售后咨询',
async run(ctx) {
const memory = useMemory(ctx);
const policySkill = useSkill('refund-policy');
return policySkill.invoke({ query: ctx.input });
}
});
这段代码声明了智能体名称、用途，并在每次调用时仅触发一个Skill——它依赖VeADK自动注入的上下文ctx，无需手动解析输入或拼接参数。若此处误写成useSkill('RefundPolicy')（大小写不匹配），本地调试时会抛出Skill not found错误且不提示具体缺失名称。
本地调试与CLI一键发布
第一步：在浏览器访问http://localhost:3000/debug，输入测试语句如“七天无理由退货要满足什么条件”，观察响应是否命中refund-policy Skill并返回结构化结果。
第二步：确认调试通过后，在终端按下Ctrl+C停止开发服务器。
第三步：执行 veadk publish --env prod --region cn-north-1，输入账号绑定的AccessKey ID与Secret，等待控制台输出✅ Published to AgentKit runtime: arn:vc:agentkit:cn-north-1:123456789012:runtime/customer-support-agent-v1。
这一步会自动完成镜像构建、上传至火山引擎CR仓库、在指定地域创建运行时实例、绑定默认模型与观测服务——全程无需进入控制台点击任何按钮。
