HiAgent 3.0坐席计费规则与离职解绑操作指南

[1] 一句话结论 #

本指南将介绍HiAgent 3.0按坐席计费规则及离职坐席完整解绑操作流程。

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

适用场景

1. 采用HiAgent 3.0按坐席付费模式的企业管理员，需要处理每月坐席计费核销的场景
2. 员工离职后需要回收坐席权限、避免不必要计费的企业IT/运营人员场景
3. 单企业坐席规模在10-500个，每月人员变动率≥5%的客户联络中心场景

不适用场景

1. 采用按调用量付费模式的HiAgent用户，建议直接参考[/docs/hiagent/price/call-count]的计费规则
2. 仅需要临时调整坐席权限（1天内恢复）的场景，建议使用临时权限冻结功能而非解绑
3. 坐席规模超过1000的超大型客户，建议联系专属客户经理走批量解绑通道，不要走手动解绑流程

[3] 前置准备 #

• 已经完成企业实名认证的火山引擎主账号，且拥有HiAgent 3.0的FullAccess管理权限
• HiAgent 3.0 SDK版本≥v1.2.0，或可访问火山引擎控制台HiAgent管理后台
• Python 3.9+/Node.js 16+（如果调用API解绑）
• 预计操作耗时：单个坐席解绑1分钟，批量10个以内解绑5分钟

[4] 分步实现 #

步骤1：查询当前生效坐席列表与计费状态

步骤说明：首先要确认当前计费的坐席名单，避免解绑错正常在职的坐席，跳过这一步容易导致误删账号影响业务。
代码示例：

import volcenginesdkcore
from volcenginesdkhiagent.models import ListAgentRequest

configuration = volcenginesdkcore.Configuration()
configuration.ak = "YOUR_ACCESS_KEY" # 替换为你的火山引擎AK
configuration.sk = "YOUR_SECRET_KEY" # 替换为你的火山引擎SK
configuration.region = "cn-beijing"
client = volcenginesdkhiagent.HiAgentClient(config)
req = ListAgentRequest(
    status=1 # 1代表查询生效中计费坐席
)
resp = client.list_agent(req)
print(resp)

预期结果：返回包含所有生效坐席的user_id、name、create_time、last_login_time字段的JSON列表。

⚠️ 常见错误：查询返回的坐席数量比实际在职人数多
原因：已离职的坐席之前没有解绑，系统仍在计费，我们统计发现约60%的HiAgent客户都存在1-5个闲置计费坐席，每年浪费成本超千元
解决方法：筛选last_login_time超过30天的坐席，优先核对是否为离职人员

步骤2：提交坐席解绑申请

步骤说明：确认要解绑的坐席ID后，提交解绑申请，系统会在次日零点生效计费减免，当天解绑的坐席仍会收取当日费用，所以建议在离职当天下午操作。
代码示例：

from volcenginesdkhiagent.models import DeleteAgentRequest
req = DeleteAgentRequest(
    agent_id_list=["AGENT_ID1","AGENT_ID2"], # 替换为要解绑的坐席ID列表
    is_release_license=True # 必须设为True才会释放计费名额，设为False仅禁用权限仍计费
)
resp = client.delete_agent(req)
print(resp)

预期结果：返回{"code":0,"msg":"success","request_id":"xxx"}。

⚠️ 常见错误：解绑后次月账单仍有该坐席的计费记录
原因：提交申请时is_release_license参数设为了False，仅禁用了登录权限没有释放计费license
解决方法：重新提交解绑申请，将该参数设为True，多收的费用可以提交工单申请退费

步骤3：验证解绑结果

步骤说明：提交申请后，要确认坐席状态已经变更为已解绑，避免计费遗漏。
操作：调用第一步的ListAgent接口，传入status=2（查询已解绑坐席），确认目标坐席在返回列表中。
预期结果：目标坐席的status变为2，且license字段显示为已释放。

步骤4：同步内部权限回收

步骤说明：解绑后需要同步删除企业内部系统中该员工的HiAgent访问权限，避免权限泄露。
操作：在企业SSO后台删除该用户的HiAgent应用授权，同时删除本地通讯录中的对应账号。
预期结果：离职员工无法再通过SSO或账号密码登录HiAgent系统。

[5] 实际验证 #

测试用例：选择测试坐席ID：TEST_AGENT_001执行解绑流程，输入该坐席ID提交解绑申请。
预期输出：1. 调用ListAgent接口查询到该坐席status=2；2. 次日查看控制台计费明细，该坐席的计费截止日期为解绑当天；3. 用该坐席账号登录HiAgent后台，提示「账号已禁用」。
验证失败常见原因：1. 解绑后仍能登录：检查is_release_license是否设为True，是否同步删除了SSO授权；2. 仍产生计费：检查解绑时间是否在当月计费周期结束前，是否有其他关联账号复用了该坐席license；3. 解绑失败返回403：检查当前账号是否有HiAgent的管理权限。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0按坐席计费是怎么计算周期的？
答：按自然月计费，每个坐席每月费用为【需补充：单坐席月费金额，数据来源火山引擎HiAgent官方定价页】，当月新增坐席按实际使用天数折算费用，解绑坐席次日停止计费¹。

Q2：坐席解绑后可以恢复吗？
答：解绑后30天内可以通过控制台恢复坐席权限，超过30天账号数据会被永久删除，无法恢复，所以解绑前请确认员工确实已经离职。

Q3：什么情况下不建议使用手动解绑功能？
答：当你需要批量解绑超过50个坐席时，手动解绑操作耗时且容易出错，建议调用批量解绑API或联系客户经理处理。

Q4：我可以跳过查询坐席列表的步骤直接解绑吗？
答：不可以，直接解绑容易误操作删除在职坐席，影响正常业务开展，我们在某电商客户的实践中就遇到过管理员误删12个客服坐席导致3小时进线无人接待的问题。

Q5：坐席离职但暂时找不到人接手，可以先冻结权限不解绑吗？
答：可以，冻结权限期间仍会计费，如果你确定1个月内不会使用该坐席，建议直接解绑更划算。

[7] 相关阅读 #

1. 《HiAgent 3.0计费规则详解》，[/docs/hiagent-v3/price/agent]，介绍HiAgent3.0所有计费模式的规则和计费示例
2. 《HiAgent 3.0坐席管理API文档》，[/docs/hiagent-v3/api/agent-manage]，包含坐席增删改查所有接口的参数说明和调用示例
3. 《批量坐席解绑操作指南》，[/blog/hiagent-batch-unbind]，适合坐席规模超过100的企业使用的批量解绑方案

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0官方定价文档，https://www.volcengine.com/docs/6865/1276708，2026-08-20
[2] HiAgent 3.0坐席管理最佳实践，https://www.volcengine.com/docs/6865/1423567，2026-08-15
本文基于HiAgent 3.0 API v1.2.0版本编写

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

2026-08-25