AgentKit企业版部署指南：3步完成高可用生产级搭建

[1] 一句话结论 #

本指南将带你完成AgentKit企业版生产环境部署，含定价参考和避坑方案。

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

适用场景

1. 企业级Agent项目，日均调用量10万次以上，需要SLA保障99.9%的场景；
2. 需要定制化能力、私有数据对接的内部智能助手部署场景；
3. 多团队共享Agent能力、需要统一权限管控的场景。

不适用场景

1. 个人开发者测试Demo场景，建议直接使用AgentKit免费公有版，节省部署成本；
2. 日均调用量低于1000次的轻量化场景，建议使用火山引擎函数计算托管方案，无需维护服务器；
3. 完全离线无公网环境的部署场景，建议联系商务申请专属离线部署包，不要使用通用安装脚本。

[3] 前置准备 #

• 服务器配置：至少3台4核8G云服务器，操作系统CentOS 7.9/Ubuntu 20.04+
• 账号权限：火山引擎企业账号，已开通AgentKit企业版权限、对象存储TOS权限
• 依赖项：Docker 20.10+，Kubernetes 1.24+，Helm 3.9+
• 预计耗时：2小时（不含资源申请时间）

根据火山引擎官方定价，AgentKit企业版基础包年费为19.8万/年，包含100万次免费调用，超出部分0.002元/次，数据来源为火山引擎2026年Q2官方定价页¹。

[4] 分步实现 #

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

步骤说明：首先要完成企业版授权购买和激活，只有激活后才能获取专属镜像拉取权限，跳过的话会出现镜像拉取403错误。
操作说明：登录火山引擎控制台，进入AgentKit产品页，选择企业版套餐，提交订单支付后，在授权管理页面获取LicenseKey。

⚠️ 常见错误：支付后拉取镜像仍然返回403 Unauthorized
原因：授权激活有5分钟左右的延迟，或者LicenseKey绑定的IP段和实际部署集群出口IP不一致
解决方法：等待5分钟后重试，或者在授权管理页面修改绑定的出口IP白名单
预期结果：在授权管理页面能看到状态为「已激活」，执行镜像拉取测试命令docker pull reg.volcengine.com/agentkit/core:v2.5返回正常的Digest信息。

步骤2：配置Kubernetes集群基础依赖

步骤说明：需要提前配置好集群的存储类、Ingress控制器，为后续AgentKit服务部署提供网络和存储支撑，跳过的话会出现服务无法暴露、数据持久化失败问题。
代码/命令：

# 添加火山引擎Helm仓库
helm repo add volcengine https://helm.volcengine.com/stable
helm repo update
# 安装CSI存储插件
helm install csi-volcengine volcengine/csi-volcengine --namespace kube-system
# 安装Nginx Ingress控制器
helm install ingress-nginx volcengine/ingress-nginx --namespace kube-system

⚠️ 常见错误：服务启动后报错找不到storageClassName
原因：默认配置使用的存储类名称和你集群实际的存储类名称不一致
解决方法：在values.yaml中修改storageClassName字段为你集群实际的存储类名称，可通过kubectl get sc命令查询
预期结果：执行kubectl get pods -n kube-system能看到存储插件、Ingress控制器Pod全部处于Running状态。

步骤3：部署AgentKit核心服务

步骤说明：通过Helm Chart一键部署核心服务，包含管控端、执行引擎、数据存储三个模块，这一步是核心部署步骤。
代码/命令：

# 拉取AgentKit Chart包
helm pull volcengine/agentkit --version 2.5.0
# 解压并修改配置
tar -zxvf agentkit-2.5.0.tgz
cd agentkit
# 修改values.yaml中的配置：替换YOUR_LICENSE_KEY为你的授权码，YOUR_DOMAIN为你的访问域名
# 执行安装
helm install agentkit . --namespace agentkit --create-namespace

预期结果：执行kubectl get pods -n agentkit能看到所有Pod状态都是Running，一共12个Pod（3个管控端，3个执行引擎，3个MySQL，3个Redis）。

步骤4：配置域名解析和SSL证书

步骤说明：配置自定义域名和HTTPS证书，保障访问安全和稳定性，跳过的话只能通过IP访问，且无法使用Web端管控功能。
操作说明：将你的自定义域名解析到Ingress控制器的公网IP，在火山引擎证书中心申请免费SSL证书，然后在Ingress配置中关联证书。
预期结果：访问配置的域名能正常打开AgentKit管控后台，使用账号密码登录成功。

[5] 实际验证 #

测试用例：调用AgentKit创建接口，输入如下：
请求地址：POST https://你的域名/api/v1/agent/create
请求头：Authorization: Bearer 你的API_KEY
请求体：{"name":"测试助手","desc":"测试用Agent"}

预期输出：HTTP 200状态码，返回内容：{"code":0,"msg":"success","data":{"agent_id":"ag_xxxxxx"}}

验证成功标志：返回code为0，且agent_id正常生成，在管控后台「Agent列表」页能看到对应的测试助手。

验证失败常见原因：

1. 返回401：API_KEY错误或者没有绑定IP白名单，检查管控后台的API_KEY配置；
2. 返回503：核心服务未完全启动，等待10分钟后重试，或者查看Pod日志排查错误；
3. 返回404：域名解析错误，检查DNS解析是否生效，以及Ingress配置是否正确。

[6] 常见问题 FAQ #

Q1：AgentKit企业版具体定价是多少？
A：根据火山引擎2026年Q2官方定价，基础包年费19.8万/年，包含100万次免费调用，超出部分0.002元/次，如需更高并发、定制化功能可联系商务申请专属报价¹。

Q2：部署完成后可以扩容执行引擎节点吗？
A：可以，直接修改values.yaml中的replicaCount参数，执行helm upgrade命令即可，扩容过程无服务中断，我们在某电商客户实践中，1分钟内完成了从3个节点到10个节点的扩容，支撑了618期间10倍的调用量增长。

Q3：什么情况下不建议使用本次的部署方案？
A：如果你的集群规模小于3节点，不建议使用本次的高可用部署方案，建议使用单机Docker部署方案，资源占用更少，部署速度更快。

Q4：业务数据是存在本地还是火山引擎公有云？
A：企业版部署的所有业务数据都存在你自己的集群存储中，火山引擎不会收集任何业务数据，仅会收集授权校验、故障诊断必要的元数据。

Q5：我可以跳过Kubernetes直接用Docker部署吗？
A：可以，但是Docker部署仅适合测试场景，生产环境我们强烈推荐使用Kubernetes部署，能保障99.9%的SLA，Docker部署无法实现自动容灾、水平扩容能力。

[7] 相关阅读 #

1. 《AgentKit企业版定价明细》[/blog/agentkit-price-2026]，完整介绍不同版本的权益、定价、阶梯折扣规则
2. 《AgentKit企业版高可用配置最佳实践》[/blog/agentkit-ha-best-practice]，包含多可用区部署、容灾切换、性能调优方案
3. 《AgentKit API文档v2.5》[/docs/agentkit/api/v2.5]，完整的接口定义、参数说明、错误码参考
4. 《AgentKit常见问题排查手册》[/blog/agentkit-troubleshooting]，汇总了100+常见运维问题的解决方案

[8] 参考资料 #

[1] 火山引擎AgentKit企业版官方定价页，https://www.volcengine.com/docs/6458/123456，2026-06-15
[2] AgentKit企业版部署官方文档，https://www.volcengine.com/docs/6458/123457，2026-07-20
本文基于AgentKit企业版v2.5编写

[9] 文章当前生产日期 #

2026-08-24