安装 AgentKit
本指南将引导您完成 AgentKit 的安装和基本配置。
环境要求
- Python 版本: 3.10 或更高版本
- 操作系统: Linux, macOS
- 包管理器: 推荐使用
uv或pip
我们强烈建议在 Python 虚拟环境 中安装 AgentKit，以避免与系统包产生冲突。
安装方法
方法一：pip 安装
稳定版本
适用于生产环境部署：
bash
pip install agentkit-sdk-python开发版本
包含最新功能和修复：
bash
pip install --pre agentkit-sdk-python指定版本
安装特定版本：
bash
pip install agentkit-sdk-python==0.1.7方法二：uv 安装（推荐）
我们推荐使用 uv 来管理虚拟环境和依赖。
bash
# install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Initialize uv environment
uv init --no-workspace
# Specify Python version for the environment
uv venv --python 3.12
# Install AgentKit using uv
uv add agentkit-sdk-python
# Install veadk (recommended for local debugging)
uv add veadk-python
# Activate the virtual environment
source .venv/bin/activate方法三：源码安装
适用于开发者和需要定制化场景：
从官方Github仓库安装
bash
# clone repo
git clone git@github.com:volcengine/agentkit-sdk-python.git
cd agentkit-sdk-python
# we use uv to build this project
uv venv --python 3.12
# only install necessary requirements
uv sync
# install agentkit-sdk-python with editable mode
uv pip install -e .
# Activate the virtual environment
source .venv/bin/activate如果您习惯使用 pip 和 venv，也可以执行以下命令：
bash
# Create virtual environment
python3 -m venv .venv
# Activate virtual environment
source .venv/bin/activate
# Install AgentKit
pip install agentkit-sdk-python3. 验证安装
安装完成后，执行以下命令验证 agentkit CLI 是否可用：
bash
agentkit --version如果成功输出版本号，则说明 AgentKit 已成功安装。
认证配置
在使用 agentkit CLI 与 AgentKit Platform 交互之前，您需要配置访问凭证（AK/SK）。
将您的凭证设置为环境变量：
bash
export VOLCENGINE_ACCESS_KEY="YOUR_ACCESS_KEY"
export VOLCENGINE_SECRET_KEY="YOUR_SECRET_KEY"为方便起见，您可以将以上命令添加到 Shell 的配置文件中（如 ~/.bashrc 或 ~/.zshrc）。
下一步
现在您已经成功安装并配置了 AgentKit，可以开始构建您的第一个 Agent 了。