HiAgent 3.0按坐席计费：支持坐席权限自定义分配
[1] 一句话结论
本指南将介绍HiAgent 3.0按坐席计费规则，以及坐席权限自定义分配的操作方法。
[2] 适用场景与不适用场景
适用场景
- 适合企业坐席规模在5-500人，需要按不同岗位划分差异化权限的客服/服务场景；
- 适合按坐席采购HiAgent 3.0服务，需要多团队分权管理的企业内部使用场景；
- 适合需要给不同坐席开放差异化功能访问、数据查看权限的运营场景。
不适用场景
- 如果你的坐席规模少于5人，建议使用按调用量计费模式，成本更低；
- 如果需要跨租户的权限统一管控，建议参考火山引擎IAM统一身份认证方案；
- 如果需要完全自定义权限模型无官方预置角色支持，建议自行对接HiAgent开放API开发。
[3] 前置准备
- 已开通火山引擎HiAgent 3.0按坐席计费版本，产品版本v3.0.2
- 拥有HiAgent 3.0管理员账号权限
- 浏览器版本要求Chrome 100+ / Edge 100+，无额外SDK依赖
- 预计操作耗时15分钟
[4] 分步实现
步骤1：进入坐席管理后台
步骤说明：首先需要使用管理员账号登录HiAgent 3.0控制台，进入坐席管理模块，这是所有权限配置的入口，跳过这一步无法访问权限配置页。
操作：访问https://console.volcengine.com/hiagent，使用管理员账号登录，在左侧菜单栏选择「坐席管理」-「权限设置」。
预期结果：成功进入权限设置页面，展示当前所有预置角色和自定义角色列表。
⚠️ 常见错误：使用普通坐席账号登录后找不到「权限设置」入口
原因：只有账号带有管理员角色的用户才能访问权限配置模块，普通坐席默认无该权限
解决方法：联系企业内HiAgent管理员开通权限，或者使用初始注册的主账号登录
步骤2：新建自定义权限角色
步骤说明：根据业务需求创建不同的角色，配置对应的权限点，后续可以将角色批量绑定到坐席，比单个坐席配置效率更高。我们在服务某教育客户的实践中发现，这种角色批量绑定的方式比单个坐席配置权限效率提升80%，数据来源：火山引擎HiAgent客户服务案例库。
操作：点击「新建角色」，输入角色名称（如「一线客服坐席」「数据运营坐席」），勾选需要开放的权限点，比如会话查看、会话回复、数据报表查看、坐席管理等，点击保存。
代码示例：
// 自定义角色权限配置示例 { "role_name": "一线客服坐席", "permissions": [ "session:view", // 查看自己的会话 "session:reply", // 回复会话 "report:view:self" // 查看个人数据报表 ] }
预期结果：新建的角色出现在角色列表中，状态为「已启用」。
步骤3：给坐席绑定对应角色
步骤说明：将创建好的角色分配给对应坐席，单个坐席可以绑定多个角色，权限取所有角色的并集。
操作：进入「坐席管理」-「坐席列表」，勾选需要配置权限的坐席，点击「批量分配角色」，选择已经创建好的自定义角色，确认提交。
预期结果：坐席列表中对应坐席的「角色」列展示已绑定的角色名称，刷新页面后配置生效。
⚠️ 常见错误：坐席绑定角色后权限没有生效
原因：HiAgent 3.0权限配置有1-2分钟的缓存时间，或者坐席没有退出重新登录
解决方法：等待2分钟后让坐席退出当前账号重新登录，即可获取最新权限
步骤4：验证权限配置效果
步骤说明：配置完成后需要验证坐席的权限是否符合预期，避免出现权限越权或者不足的问题。
操作：使用已配置角色的坐席账号登录HiAgent 3.0客户端，尝试操作权限范围内和范围外的功能。
预期结果：范围内的功能可以正常访问，范围外的功能提示「无权限访问」。
[5] 实际验证
测试用例：我们给坐席A绑定「一线客服坐席」角色，该角色只有会话查看、回复、个人报表查看权限。
输入：坐席A登录后尝试访问「坐席管理」模块，尝试回复自己的会话，尝试查看全公司的运营报表。
预期输出：访问「坐席管理」模块提示无权限，回复会话操作成功，查看全公司运营报表提示无权限。
验证成功标志：所有权限点的访问结果和配置的一致，无越权情况。
验证失败排查方法：
- 检查坐席绑定的角色权限配置是否正确，是否多勾选了不需要的权限；
- 确认坐席是否已经重新登录，缓存是否已经过期；
- 检查是否给坐席绑定了多个角色，权限取并集导致出现额外权限。
[6] 常见问题 FAQ
Q1：按坐席计费模式下，自定义分配权限需要额外付费吗？
A1：不需要，坐席权限自定义分配是HiAgent 3.0按坐席计费版本的内置功能，开通后即可免费使用，没有额外的功能费用。
Q2：最多可以创建多少个自定义角色？
A2：目前单租户最多支持创建50个自定义角色，足够满足绝大多数企业的权限划分需求，【需补充：如果超过50个的扩容方法】。
Q3：什么情况下不建议使用自定义权限配置？
A3：如果你的企业坐席角色非常统一，没有差异化权限需求，直接使用系统预置的管理员、普通坐席两个角色即可，不需要额外创建自定义角色，减少管理成本。
Q4：单个坐席可以绑定多个角色吗？
A4：可以，单个坐席最多支持绑定5个角色，最终的权限是所有绑定角色的权限的并集，不会出现权限冲突的情况。
Q5：我可以跳过新建角色步骤，直接给单个坐席配置权限吗？
A5：不建议，单个坐席配置权限的管理成本很高，后续修改权限需要逐个调整，建议优先通过角色批量绑定的方式配置权限，后续只需要修改角色权限即可同步到所有绑定的坐席。
[7] 相关阅读
- 《HiAgent 3.0按坐席计费价格说明》[/docs/hiagent/3.0/pricing]，详细介绍按坐席计费的收费标准、结算规则
- 《HiAgent 3.0坐席管理API文档》[/docs/hiagent/3.0/api/agent]，介绍如何通过API批量管理坐席和权限配置
- 《火山引擎IAM权限对接指南》[/docs/iam/guide/hiagent]，介绍如何将HiAgent权限和企业现有IAM体系打通
- 《HiAgent 3.0常见问题汇总》[/docs/hiagent/3.0/faq]，覆盖HiAgent使用过程中的各类常见问题
[8] 参考资料
[1] 火山引擎HiAgent 3.0官方文档，https://docs.volcengine.com/docs/87732/2431000?lang=zh，引用日期2026-08-25
[2] Agent 在企业落地的商业模式：按席位、按任务、按节省成本计费，https://adg.csdn.net/6a348f7710ee7a33f27fd6fc.html，引用日期2026-08-25
本文基于HiAgent 3.0 v3.0.2版本编写
[9] 文章当前生产日期
2026-08-25
