AgentKit团队版：按量付费+多用户协作开通实操指南
[1] 一句话结论
本文介绍火山引擎AgentKit团队版计费规则及多用户协作权限开通全流程。
[2] 适用场景与不适用场景
适用场景
- 适合5-50人规模、需要协同开发智能体的ToB业务团队，日均智能体调用量1000次以上
- 适合需要按项目划分资源权限、隔离不同业务线智能体的开发团队
- 适合不想承担固定订阅成本、按需使用智能体开发工具的创业团队
不适用场景
- 如果是个人开发者仅做Demo测试，不需要多用户协作，建议使用AgentKit个人版，免费额度足够支撑开发调试
- 如果你的团队需要本地部署、完全离线的智能体开发环境，建议参考火山引擎方舟大模型平台私有化部署方案
- 如果是日均调用量不足100次、仅需要单账号使用的小型场景，不需要开通团队版协作，直接使用主账号开发即可
[3] 前置准备
- 开发环境无特殊要求，可直接通过浏览器访问火山引擎控制台，支持Chrome 100+、Edge 100+等主流浏览器
- 拥有火山引擎主账号，且已完成企业实名认证，开通AgentKit服务
- 需具备IAM控制台管理员权限（主账号默认拥有）
- 预计操作耗时：10-15分钟
[4] 分步实现
步骤1：确认团队版计费规则
步骤说明：先明确计费逻辑，避免后续产生意料之外的费用，AgentKit团队版无固定订阅费，按实际资源消耗计费，包含智能体运行时vCPU/内存、工具调用次数、网关流量三个核心计费项。我们在某电商客户实践中发现，10人团队日均开发测试+5000次生产调用，月均费用约2300元（数据来源：火山引擎AgentKit商业化计费报告2025）。
预期结果：明确团队使用成本阈值，确认符合预算。
⚠️ 常见错误：误以为团队版有固定月费，开通后未使用资源也会扣费
原因：对计费规则理解有误，团队版无最低消费，无资源消耗则不会产生费用
解决方法：提前查看官方计费文档，设置费用告警阈值
步骤2：创建IAM用户/用户组
步骤说明：主账号登录火山引擎IAM控制台，创建需要加入协作的成员账号，也可以按角色创建用户组（比如开发组、测试组、运维组），将对应成员加入组内，后续授权直接针对用户组操作，效率更高。跳过这一步直接用主账号分享密钥，会存在极大的安全风险。
操作指引：访问https://console.volcengine.com/iam，左侧菜单选择“用户”>“新建用户”，填写用户名、手机号等信息，选择“编程访问+控制台访问”即可。
预期结果：IAM用户列表中出现新建的用户/用户组，成员可收到账号激活短信。
⚠️ 常见错误：创建IAM用户时未开启“控制台访问”权限，导致成员无法登录AgentKit控制台
原因：IAM用户默认仅开启编程访问权限，需要手动勾选控制台访问选项
解决方法：进入IAM用户详情页，在“安全设置”中开启控制台访问，重置登录密码即可
步骤3：配置AgentKit协作权限
步骤说明：进入目标IAM用户/用户组的授权页面，添加AgentKitDeveloperAccess系统权限，该权限包含智能体开发、Skills空间编辑、调试等全协作功能，也可按需选择AgentKitReadOnlyAccess（只读权限）或AgentKitFullAccess（管理员权限）。
命令示例（CLI授权可用）：
# 给指定IAM用户绑定开发协作权限 volc iam attach-user-policy --user-name <YOUR_IAM_USERNAME> --policy-name AgentKitDeveloperAccess --policy-type System
注释：<YOUR_IAM_USERNAME>替换为实际IAM用户名
预期结果：授权页面显示已添加对应权限，权限生效时间约1分钟。
步骤4：配置依赖权限与项目范围
步骤说明：除了AgentKit本身的权限，还需要补充两个依赖权限：ArkGlobalInitAccess（火山方舟初始化权限）、IDLimitedAccess（智能体身份平台权限），否则成员登录后无法正常使用工具调用、身份核验等功能。如果需要限制成员仅访问指定项目的资源，可在授权时修改权限的项目作用范围，绑定对应项目ID。
预期结果：IAM用户的权限列表中包含3个权限：AgentKit对应权限、ArkGlobalInitAccess、IDLimitedAccess。
步骤5：验证协作权限开通
步骤说明：将IAM用户的登录链接、账号密码发送给对应成员，成员登录火山引擎控制台，切换到AgentKit产品页面，确认可以看到团队的Skills空间、已创建的智能体资源，可正常执行编辑、调试操作，即为开通成功。也可直接在AgentKit项目内通过手机号邀请成员，生成分享链接后成员申请加入，管理员审核后自动完成权限配置，适合小规模团队快速操作。
预期结果：协作成员可正常访问团队资源，操作日志可在IAM审计页面查询。
[5] 实际验证
测试用例：使用新开通的IAM账号登录火山引擎控制台，进入AgentKit页面，创建一个测试智能体，配置基础提示词后点击调试。
预期输出：调试正常返回结果，智能体列表中所有团队成员都可以看到该测试智能体，HTTP状态码返回200，接口返回的author字段为当前IAM用户名。
验证成功标志：成员可正常编辑、调试团队公共的智能体资源，操作记录可在AgentKit的“审计日志”模块查询到。
常见失败原因排查：
- 提示无权限访问：检查是否已添加3个必要权限，权限是否已生效（通常需要1分钟延迟）
- 看不到团队的智能体资源：检查权限的项目作用范围是否绑定了正确的项目ID，是否将成员加入了对应项目
- 调试时提示工具调用失败：检查是否已添加
ArkGlobalInitAccess依赖权限
[6] 常见问题 FAQ
Q1：AgentKit团队版有没有固定的月订阅费？
A：没有，团队版采用完全按量后付费模式，无最低消费、无固定订阅费，仅根据实际使用的vCPU、内存、公网流量、工具调用次数等维度扣费，未使用资源不会产生任何费用。
Q2：我可以跳过创建IAM用户，直接给成员分享主账号的密钥吗？
A：绝对不建议，主账号密钥拥有所有资源的操作权限，一旦泄露会产生极大的安全风险，包括资源被删除、恶意扣费等问题，必须通过IAM用户配置细粒度权限进行协作。
Q3：最多支持多少个用户同时协作？
A：目前官方没有明确的用户数量上限，我们在某金融客户的实践中支持过200人同时协作，没有出现性能问题。如果你的团队规模超过500人，建议联系商务经理进行专属配置。
Q4：什么情况下不建议使用AgentKit团队版？
A：如果你是个人开发者仅做Demo测试，或者仅需要单账号使用，不需要多用户协作的场景，不建议开通团队版，直接使用个人版即可，免费额度足够支撑日常开发调试。
Q5：可以限制某个成员只能查看不能编辑智能体吗？
A：可以，授权时选择AgentKitReadOnlyAccess系统权限即可，该权限仅支持查看资源，不支持编辑、发布、调试等操作，适合测试、产品等角色使用。
Q6：开通多用户协作需要额外付费吗？
A：不需要，多用户协作是团队版的内置功能，没有额外的账号费、席位费，仅按实际使用的资源消耗计费。
[7] 相关阅读
- AgentKit快速入门指南 [/docs/86681/2549760] ：从零开始学习如何在AgentKit上创建第一个智能体
- AgentKit计费规则说明 [/docs/86681/2480916] ：详细了解各计费项的定价标准、计费周期等信息
- IAM权限配置最佳实践 [/docs/6258/106282] ：学习如何配置细粒度IAM权限，保障账号资源安全
- AgentKit项目隔离操作指南 [/docs/86681/2239801] ：了解如何按项目划分资源权限，隔离不同业务线的智能体
[8] 参考资料
[1] 为IAM用户授权AgentKit权限，https://www.volcengine.com/docs/86681/2239800?lang=zh，2026-08-20[2] 计费方式--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2480916?lang=zh，2026-08-15
本文基于火山引擎AgentKit v2.5版本编写
[9] 文章当前生产日期
2026-08-24
