必须先完成cli工具安装、认证凭证配置、标准项目结构初始化三步，缺一不可；依次执行pip install agentkit-cli、agentkit config login、veadk init my-travel-agent、pip install -e .，再正确配置agentkit.yaml并运行agentkit launch --local验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在火山引擎AgentKit上完成智能体开发前的环境初始化，必须先确保本地CLI工具、认证凭证、项目结构三者全部就位，缺一不可，否则后续所有部署命令都会因权限缺失或路径错误而失败。
安装并配置AgentKit CLI
执行 pip install agentkit-cli 安装最新版CLI工具。安装完成后运行 agentkit --version 验证是否输出 v2.4.0 或更高版本——低于此版本将无法识别新版 agentkit.yaml 中的 runtime.version 字段。
运行 agentkit config login，按提示打开浏览器完成火山引擎账号授权。该操作会自动写入凭证至 ~/.volc/credentials；【若手动编辑过该文件，请确认其中 access_key_id 和 secret_access_key 未被空格或换行截断】。
创建标准VeADK项目结构
进入工作目录，执行 veadk init my-travel-agent 初始化项目。
这一步会生成含 src/、tools/、knowledge/ 和 agentkit.yaml 的完整骨架。注意：不要跳过 veadk init 直接用 mkdir 手动建目录——VeADK依赖预置的 pyproject.toml 中的插件入口点，缺失会导致本地调试时 agentkit launch 无法加载 Agent 实例。
进入 my-travel-agent 目录后，立即执行 pip install -e . 安装当前项目为可编辑包。此操作让 CLI 能正确解析 agentkit.yaml 中声明的 entrypoint 模块路径。
配置 agentkit.yaml 并验证基础运行
打开项目根目录下的 agentkit.yaml，确认以下三项已填写：
-
name: my-travel-agent（名称需符合 DNS-1123 小写字母+数字+连字符规范） -
runtime:下的region: cn-north-1（必须与你开通AgentKit服务的地域一致） -
entrypoint: src.agent:build_agent（路径须与实际 Python 文件及函数名完全匹配，大小写敏感）
保存后，在项目根目录下运行 agentkit launch --local。终端出现 ✅ Agent ready at http://localhost:8000 即表示初始化成功。
