火山引擎AgentKit升级依赖修复智能体启动异常

需升级agentkit至2.3.0+版本并修复配置：执行pip install --upgrade "agentkit>=2.3.0"，确认Python≥3.10；删除残留文件后强制重装；精简agentkit.yaml中runtime区块为type、timeout_ms、max_concurrent_tasks三项，并确保末尾有空行。

火山引擎AgentKit升级后智能体启动报错“ModuleNotFoundError: No module named 'agentkit.runtime'”或进程卡在“Initializing agent runtime...”状态，需要手动修复依赖版本冲突和运行时初始化逻辑。

检查当前agentkit版本与Python环境兼容性

执行 pip show agentkit，确认输出中 Version 字段为

（2026年7月起所有新部署默认使用该版本）。若显示 2.2.x 或更低，请立即升级：pip install --upgrade "agentkit>=2.3.0"。

请注意，AgentKit 2.3.0需要Python ≥ 3.10，并且

。如果您使用conda环境，请先运行conda install -c conda-forge python=3.10.12，然后再升级agentkit。

重装核心运行时组件

方法一：强制清除并重建 runtime 子模块

进入项目根目录，然后执行命令“pip uninstall agentkit -y”，接着删除本地site-packages中残留的agentkit*文件夹（可通过“find $(python -m site --user-site) -name "agentkit*" -type d”找到其路径），最后运行“pip install --no-cache-dir --force-reinstall "agentkit[full]>=2.3.0"”。

方法二：跳过 wheel 缓存，直装源码构建版

执行 pip install --no-binary agentkit --force-reinstall "agentkit[full]>=2.3.0"。这会触发本地编译 runtime 模块，绕过预编译 wheel 中可能存在的 ABI 不匹配问题。

修复 agentkit.yaml 中的 runtime 初始化配置

第一步：打开项目根目录下的 agentkit.yaml 文件。

第二步：定位到 runtime: 区块，确认存在且仅存在以下三项（删除任何自定义字段如 preload_modules: 或 asyncio_policy:）：

runtime:
type: "default"
timeout_ms: 30000
max_concurrent_tasks: 8

第三步：在文件末尾新增一行空行，保存。缺少空行会导致 YAML 解析器在某些 patch 版本中静默跳过 runtime 块，造成启动时无报错但卡死。

第四步：执行 agentkit launch --dry-run 验证配置可加载。若输出包含 “Runtime config loaded: default” 即表示通过。