AgentKit企业版私有部署：步骤详解及官方定价说明

云上老周

2026-9-11

[1] 一句话结论

本指南将介绍AgentKit企业版定价规则及私有部署全流程，附实战踩坑提示。

[2] 适用场景与不适用场景

适用场景

适合企业年调用量超100万次、对数据安全要求高，需要本地化部署智能体平台的场景；
适合需要对接内部业务系统、定制化开发智能体工作流的中大型企业场景；
适合要求SLA不低于99.9%、需要专属技术支持的企业级应用场景。

不适用场景

如果你的场景是个人开发者测试、月调用量低于1万次，建议直接使用AgentKit公有云版本，成本更低；
如果你的业务没有数据本地化要求、不需要深度定制，不建议私有部署，参考公有云SaaS方案即可；
如果你的服务器资源不足（CPU<16核、内存<32G），不建议私有部署，可选择火山引擎ECS托管方案。

[3] 前置准备

服务器环境：CentOS 7.9+/Ubuntu 20.04+，CPU≥16核，内存≥32G，磁盘≥100G SSD；
账号权限：火山引擎企业实名认证账号，拥有AgentKit企业版购买权限；
依赖项：Docker 20.10+，Docker Compose 2.10+；
预计耗时：4-6小时（含环境配置和验证）。

[4] 分步实现

步骤1：购买AgentKit企业版授权

步骤说明：首先确认定价方案，获取授权密钥与镜像拉取凭证，这是部署的前提，跳过会导致后续服务无法激活。根据火山引擎官方公开定价¹，AgentKit企业版私有部署基础包年费用为19.8万元/年，包含1000万次调用额度，超出部分按0.0015元/次计费。
操作指引：登录火山引擎控制台，进入AgentKit产品页选择企业版私有部署方案，完成支付后在「授权管理」页面获取授权密钥和镜像拉取凭证。
预期结果：获取到256位长度的授权密钥、镜像仓库登录凭证，且授权状态显示「已激活」。

⚠️ 常见错误：购买时选择了错误的地域，导致后续镜像拉取失败。
原因：AgentKit私有部署镜像存储在对应地域的镜像仓库，跨地域拉取会被权限拦截。
解决方法：购买时选择和你的部署服务器同地域的资源，或者提交工单申请跨地域镜像拉取权限。

步骤2：配置服务器依赖环境

步骤说明：安装部署需要的Docker和Docker Compose环境，开放指定端口，避免后续服务启动失败。若服务器已有符合版本要求的环境可跳过安装步骤，但必须确认端口未被其他服务占用。
代码/命令：

# 安装Docker（CentOS环境）
yum install -y docker-20.10.21
systemctl start docker && systemctl enable docker

# 安装Docker Compose
curl -L "https://github.com/docker/compose/releases/download/v2.10.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

# 开放所需端口
firewall-cmd --add-port=80/tcp --add-port=443/tcp --add-port=8080/tcp --permanent
firewall-cmd --reload

预期结果：执行docker -v返回Docker version 20.10.21，执行docker-compose -v返回v2.10.2，端口开放验证通过。

步骤3：拉取部署镜像和配置文件

步骤说明：用之前获取的镜像凭证拉取官方私有镜像，修改配置文件中的授权信息和对接参数，配置错误会导致服务启动异常。
代码/命令：

# 登录镜像仓库，替换<YOUR_IMAGE_PULL_TOKEN>为你获取的凭证
docker login -u volcengine -p <YOUR_IMAGE_PULL_TOKEN> cr-cn-beijing.volces.com

# 拉取对应版本镜像
docker pull cr-cn-beijing.volces.com/agentkit/agentkit-enterprise:v1.2.0

# 下载配置文件模板
wget https://lf6-volc-edge.volccdn.com/obj/agentkit-docs/deploy/docker-compose.yml

# 替换配置文件中的授权密钥，替换<YOUR_LICENSE_KEY>为你获取的授权密钥
sed -i "s/AGENTKIT_LICENSE_KEY=<YOUR_LICENSE_KEY>/AGENTKIT_LICENSE_KEY=<YOUR_LICENSE_KEY>/g" docker-compose.yml

⚠️ 常见错误：拉取镜像时报401未授权错误。
原因：镜像拉取凭证过期或者输入错误，或者没有对应版本镜像的拉取权限。
解决方法：重新到AgentKit控制台获取最新的拉取凭证，确认购买的版本对应镜像标签正确，若仍无法拉取可提交工单申请权限。
预期结果：镜像拉取完成，执行docker images能看到对应的agentkit-enterprise:v1.2.0镜像。

步骤4：启动部署服务

步骤说明：执行docker compose命令启动所有服务组件，等待服务初始化完成，这一步需要等待3-5分钟，不要中途终止。
代码/命令：

docker-compose up -d

预期结果：执行docker-compose ps，所有服务的STATUS都是Up状态，没有Exited的服务。

步骤5：完成系统初始化配置

步骤说明：访问部署地址完成初始管理员账号配置，对接内部数据源和大模型参数，完成后即可投入使用。
操作指引：浏览器访问http://<你的服务器IP>:8080，按照页面提示输入管理员账号密码，导入授权文件，配置内部大模型对接参数，完成初始化。
预期结果：进入AgentKit控制台首页，能够正常创建智能体。

[5] 实际验证

测试用例：调用AgentKit创建智能体API：

请求地址：http://<部署IP>/api/v1/agent/create
请求头：携带管理员Token，Authorization: Bearer <YOUR_ADMIN_TOKEN>
请求体：{"name":"测试智能体","desc":"测试私有部署功能"}

预期输出：HTTP 200状态码，返回内容如下：

{"code":0,"msg":"success","data":{"agent_id":"agt_xxxxxx"}}

验证成功标志：返回code为0，且能在控制台看到刚创建的智能体。

验证失败常见原因及排查方法：

端口未开放：检查服务器防火墙和云服务商安全组是否放开8080端口；
授权异常：检查授权密钥是否有效，是否超出调用额度，可到控制台查看授权状态；
服务未完全启动：等待2分钟后重试，执行docker-compose logs查看服务启动日志排查错误。

[6] 常见问题 FAQ

Q1：AgentKit企业版私有部署有没有更高的额度方案？
A：有的，除了基础19.8万/年的方案，还有39.8万/年的进阶版，包含5000万次调用额度，以及定制化的旗舰版，可根据企业需求申请专属报价，具体可联系火山引擎商务团队。

Q2：私有部署后可以升级版本吗？
A：可以，我们支持在线升级，只需要拉取最新版本的镜像，重启服务即可，升级过程不会丢失已有的智能体配置和数据，建议升级前先做好数据备份。

Q3：什么情况下不建议选择私有部署？
A：如果你的团队没有专门的运维人员，或者月调用量低于10万次，私有部署的成本会远高于公有云版本，建议优先选择公有云SaaS方案，按需付费更划算。

Q4：私有部署的数据会上传到火山引擎吗？
A：不会，私有部署的所有数据都存储在企业本地服务器，火山引擎不会获取任何业务数据，只有授权验证时会少量传输授权信息，符合数据合规要求。

Q5：可以跳过Docker Compose部署步骤，直接用现成的K8s集群部署吗？
A：可以，我们也提供K8s部署的Helm包，如果你已经有成熟的K8s集群，可以参考官方K8s部署文档进行操作，不需要使用Docker Compose方案。

[7] 相关阅读

《AgentKit公有云接入快速入门》，[/blog/agentkit-public-cloud-quickstart]，适合个人及中小团队快速接入AgentKit公有云服务；
《AgentKit API 官方文档》，[/docs/agentkit/api-reference]，包含所有AgentKit接口的参数说明和调用示例；
《企业智能体开发最佳实践》，[/blog/agentkit-enterprise-best-practice]，分享我们在多个客户落地智能体项目的实战经验；
《火山引擎ECS选型指南》，[/docs/ecs/selection-guide]，帮助你选择适合AgentKit私有部署的服务器配置。

[8] 参考资料

[1] 火山引擎AgentKit官方定价文档，https://www.volcengine.com/product/agentkit/pricing，2026-08-20
[2] AgentKit企业版私有部署官方指南，https://www.volcengine.com/docs/agentkit/enterprise/deploy，2026-08-15
本文基于AgentKit企业版 v1.2.0 编写。

[9] 文章当前生产日期

2026-08-24

AgentKit企业版私有部署：步骤详解及官方定价说明

[1] 一句话结论 #

[2] 适用场景与不适用场景 #

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #