文档中心

AgentKit

CLI 参考

常见问题

常见问题

配置文件找不到

问题：

Error: Configuration file not found: agentkit.yaml

原因：当前目录没有配置文件。

解决方案：

# 如果是新项目
agentkit init my_agent

# 如果已有项目
agentkit config

Docker 没有运行（Local 模式）

问题

Error: Docker daemon not running

原因：Docker 服务未启动。

解决方案：

Windows/Mac：打开 Docker Desktop。

Linux：sudo systemctl start docker。

云端凭证未配置（Cloud 模式）

问题：

Error: VOLC_ACCESSKEY or VOLC_SECRETKEY not set

原因：没有设置火山引擎 AK/SK。

解决方案：

# 推荐：使用安全的全局配置
agentkit config --global --init
agentkit config --global --set volcengine.access_key="Your AccessKey"
agentkit config --global --set volcengine.secret_key="Your SecretKey"

# 或者：临时环境变量（开发调试用）
export VOLC_ACCESSKEY="Your AccessKey"
export VOLC_SECRETKEY="Your SecretKey"

构建失败

可能原因和解决方案：

依赖问题：检查 requirements.txt 是否正确

代码错误：检查 Python 代码是否有语法错误

网络问题：检查网络连接，重试构建

权限问题：确保有 Docker/云端的操作权限

调试技巧

查看详细日志。

# 设置详细日志级别
export LOG_LEVEL=DEBUG
agentkit build

验证配置文件。

# 检查配置是否正确
cat agentkit.yaml

分步执行。

# 分开执行，更容易定位问题
agentkit build # 先构建
agentkit deploy # 再部署
# 而不是直接用 launch

检查运行状态。

# 查看 Agent 是否正常运行
agentkit status

YAML 格式错误

问题：

Error: Invalid YAML format

解决方案：

使用空格缩进（不要用 Tab）。

检查冒号后面有空格。

字符串包含特殊字符要加引号。

模板变量用引号包裹：""。

必填项缺失

问题：

Error: agent_name is required

解决方案：

agentkit config # 重新配置，填写必填项

模板变量渲染失败

问题：

Error: Config field 'cr_instance_name' template variables were not fully rendered

可能原因：

火山引擎凭证未配置。

AK/SK 权限不足。

解决方案：

# 检查环境变量
echo $VOLC_ACCESSKEY
echo $VOLC_SECRETKEY
# 或检查全局配置
cat ~/.agentkit/config.yaml

环境变量不生效

可能原因：

变量名拼写错误。

配置没有保存。

没有重新部署。

common.runtime_envs和策略级runtime_envs混淆。

解决方案：

# 1. 检查配置
cat agentkit.yaml

# 2. 确认环境变量位置正确
# common.runtime_envs - 所有模式共享
# launch_types.<mode>.runtime_envs - 该模式专用

# 3. 重新部署
agentkit deploy

最近更新时间：2026.10.29 12:23:55

这个页面对您有帮助吗？

有用

有用

无用

无用