Skip to main content
安装 VeADK 后，可以使用 Python 创建和运行智能体。首次使用建议安装 PyPI 已发布版本；需要验证未发布能力或修改 SDK 时，再使用源码安装

​
前置条件

  • Python 3.10 至 3.13，以及对应环境中的 pip
  • 调用模型时需要可用的模型和 API Key；安装软件包本身不需要模型凭证。火山引擎和 BytePlus 的配置见快速开始

​
安装已发布版本

在项目目录中创建虚拟环境，避免与其他项目的依赖冲突：
激活该环境：
从 PyPI 安装最新已发布版本，并检查安装结果：
第二条命令输出当前 Python 环境中的 VeADK 版本号。本页的 Python 版本要求和可选依赖组按已发布的 1.1.13 核对；生产项目应固定经过验证的版本
Preview 还包含更新日志中标记为「未发布」的能力。使用这些能力前，查看对应页面的版本条件和源码安装说明，不能仅凭 Preview 中存在说明就认定 PyPI 版本已经支持

​
可选依赖组

根据需要安装可选依赖组。例如，接入飞书、Cozeloop 或 LlamaIndex 时安装 extensions：
固定主包版本时，可选依赖组也应使用相同版本，例如 veadk-python[extensions]==1.1.13

​
安装 Preview 源码

需要 Git 和 uv。克隆公开仓库，在仓库目录中创建独立环境并以可编辑模式安装：
如果目标页面指定了提交或 tag，先执行 git checkout <ref> 切换到该版本，再创建环境并安装：
需要可选依赖组时，将安装命令改为 uv pip install -e ".[extensions]" 使用前激活仓库中的 .venv，激活方式与上文相同，再执行版本检查命令。可编辑安装后，对仓库中 Python 源码的修改会作用于该环境 主线源码会继续变化。验证特定未发布能力时，使用对应页面指定的源码版本；运行第一个智能体见快速开始
最后修改于 2026年9月19日