前置条件
- Go 1.26.5 或更高版本。该要求来自当前主线
go.mod。 - 调用模型时需要可用的模型和 API Key;安装模块本身不需要模型凭证。
- 使用 V2 能力时,固定到
v2.0.0tag。
新项目安装 V2
在你的项目目录初始化 Go module:v2.0.0 tag 安装:
V2 包含 ADK v2 和 A2A v2 所需的破坏性更新。生产项目应固定到
v2.0.0 或经过验证的版本。存量项目安装 V1
如果项目仍使用 ADK v1,可以安装 V1 维护版本:/v2:
release/v1。查看 V1 示例或修复时,切换到该分支:
配置模型
VeADK Go 会从当前工作目录读取.env 和 config.yaml。.env 不会覆盖已经存在的环境变量;config.yaml 中的键会转换为环境变量格式,且同样不会覆盖已存在的环境变量。因此,已导出的环境变量优先级高于文件配置。
在项目根目录创建 config.yaml: