安装 - AgentKit 文档

前置条件

Python 3.10 及以上版本。
火山方舟 API Key，用于调用模型，可在火山引擎方舟控制台创建。

从 PyPI 安装

从 PyPI 安装 VeADK 1.0.7：

pip install "veadk-python==1.0.7"

可选依赖组

VeADK 通过可选依赖组提供按需能力，可根据用途单独安装：

pip install "veadk-python[extensions]"

依赖组	用途
`extensions`	飞书渠道、Cozeloop、LlamaIndex 等集成
`database`	Redis、MySQL、Viking DB、mem0 等存储后端
`eval`	基于 DeepEval 与 Google ADK 的评测
`a2ui`	A2UI
`harness`	Harness 服务与 Headroom 集成
`pdf`	向后兼容的安装别名；1.0.5 已默认安装 PDF 页面渲染依赖

speech 与 cli 依赖组为兼容已有安装命令而保留，在 1.0.5 中不会增加额外依赖。

依赖兼容性

PostgreSQL 集成要求 psycopg2-binary>=2.9.10。项目自行锁定依赖时，不要把该包降到更早版本。
AgentKit 集成依赖 SDK 提供默认 CORS 配置。使用 veadk-python==1.0.7 解析出的 AgentKit SDK 版本；覆盖或降级该依赖后，应重新验证 AgentKit 应用启动与跨域访问。

从源码构建

如需基于源码开发，可使用 uv 构建：

git clone --branch 1.0.7 --depth 1 https://github.com/volcengine/veadk-python.git
cd veadk-python

# 创建 Python 3.12 虚拟环境
uv venv --python 3.12

# 安装依赖（如需可选依赖组，使用 --extra <name> 或 --all-extras）
uv sync --all-extras

# 以可编辑模式安装 VeADK
uv pip install -e .

安装完成后，即可进入快速开始运行第一个智能体。

最后修改于 2026年9月19日