HiAgent 3.0客户画像配置与数据导出：零基础操作指南

[1] 一句话结论 #

本指南将带你完成HiAgent 3.0客户画像设置及数据导出全流程操作，全程无代码也可实现。

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

适用场景

1. 运营人员需要基于客户交互标签做分层运营，对应智能客服实例日均会话量≥500条的场景；
2. 产品团队需要导出最近90天内全量客户属性数据，做用户需求调研的场景；
3. 合规团队需要定期拉取客户画像存档，满足等保2.0数据留存要求的场景。

不适用场景

1. 如果需要实时流式同步客户画像数据到第三方CRM系统，不建议使用导出功能，建议参考HiAgent 3.0开放API回调功能实现实时同步；
2. 如果单次导出数据量超过100万条，不建议直接在控制台操作，容易触发超时，建议联系技术支持申请离线导出功能；
3. 如果需要自定义非系统内置的画像标签计算逻辑，不要直接用默认导出功能，建议先对接标签自定义接口配置规则后再导出。

[3] 前置准备 #

• 账号权限：HiAgent 3.0控制台管理员或运营权限账号，普通访客账号无操作权限；
• 环境要求：Chrome 108+/Edge 108+浏览器，不兼容IE11及以下版本；
• 依赖项：无需额外安装SDK，控制台直接操作即可；
• 预计耗时：画像标签配置约10分钟，10万条以内数据导出约3分钟。

[4] 分步实现 #

步骤1：进入客户画像配置模块

步骤说明：首先需要进入对应实例的客户画像管理页面，跳过这一步无法找到配置入口。
操作：打开HiAgent 3.0控制台地址https://hagent.volcengine.com/，登录后选择你要操作的实例，在左侧菜单栏依次点击「客户运营」-「客户画像配置」。
预期结果：页面展示系统内置的23个基础标签（数据来源：火山引擎HiAgent 3.0官方文档2026版），包括会话次数、意向等级、咨询产品类型等，标签状态默认为部分启用。

⚠️ 常见错误：左侧菜单栏找不到「客户画像配置」入口
原因：要么是你的账号没有对应运营权限，要么是实例版本为基础版，不支持客户画像功能
解决方法：联系账号管理员开通运营权限，或者将实例升级到专业版及以上版本。

步骤2：配置需要采集的画像标签

步骤说明：系统默认仅开启10个基础标签，你需要根据业务需求勾选内置标签或新建自定义标签，不配置的话导出的数据会缺少业务需要的字段。
操作：在标签管理页勾选需要的内置标签，点击「新建自定义标签」，设置标签名称、数据来源（可选会话关键词提取、用户主动上报、坐席手动标记）、匹配规则，保存后点击右上角「生效配置」。
如果需要批量配置标签，也可以调用API实现：

import requests
headers = {
    "X-API-KEY": "YOUR_API_KEY", # 替换为你的控制台API密钥
    "Content-Type": "application/json"
}
data = {
    "instance_id": "YOUR_INSTANCE_ID", # 替换为你的实例ID
    "tag_list": [
        {
            "tag_name": "意向产品",
            "source": "session_keyword",
            "match_rule": ["云服务器","CDN","对象存储"]
        }
    ]
}
res = requests.post("https://hagent.volcengine.com/api/v1/tag/create", json=data, headers=headers)
print(res.json())

预期结果：页面弹出「标签配置生效成功」提示，所有启用的标签状态显示为「已生效」。

⚠️ 常见错误：自定义标签配置后不生效，采集不到对应数据
原因：匹配规则设置的关键词太短（少于2个字符）或者包含特殊符号，系统无法识别
解决方法：修改匹配规则，每个关键词长度≥2字符，仅支持中文、英文、数字，不要使用*、？等通配符。

步骤3：设置导出数据的筛选范围

步骤说明：为了避免导出全量敏感数据，需要先设置导出的时间范围、标签筛选条件、接收人邮箱，跳过这一步导出的数据可能不符合需求或者泄露敏感信息。
操作：进入「客户画像导出」页面，选择导出时间范围（最多支持最近90天的数据），设置筛选条件（比如意向等级≥3级、最近7天有过会话），填写接收导出文件的邮箱地址。
预期结果：筛选条件设置完成后，页面显示预计导出数据量，比如「符合条件的数据共12345条」。

步骤4：提交导出任务

步骤说明：导出任务是异步执行的，提交后不需要停留在页面，系统生成完文件会自动发邮件通知。
操作：确认导出条件无误后点击「提交导出」，输入手机验证码确认提交。
预期结果：页面弹出「导出任务提交成功，预计3分钟内发送到你的邮箱」提示，导出任务列表里显示该任务状态为「处理中」。

步骤5：下载导出文件并校验

步骤说明：收到邮件后下载文件，校验文件内容是否符合预期，避免数据缺失。
操作：打开邮箱里的导出通知邮件，点击下载链接（链接24小时内有效），下载后解压得到CSV格式的文件。
预期结果：CSV文件包含你配置的所有标签字段，数据条数和页面预计导出量误差≤0.1%（数据来源：火山引擎HiAgent 3.0性能白皮书2026版）。

[5] 实际验证 #

测试用例：设置筛选条件为「最近7天，意向等级≥2级的客户」，提交导出任务。
验证成功标志：收到导出邮件，下载的CSV文件无乱码，包含你配置的所有标签字段，数据条数和页面显示的预计条数误差≤0.1%，HTTP下载请求返回状态码200。
常见失败排查方法：

1. 收不到导出邮件：先检查垃圾邮件箱，再确认提交的邮箱地址是否正确，还是没收到的话去导出任务列表里点击「重新发送邮件」；
2. 文件乱码：用WPS或Numbers打开文件，不要用系统自带的记事本，编码选择UTF-8即可；
3. 字段缺失：回到画像配置页检查对应标签是否启用，重新提交导出任务即可。

[6] 常见问题 FAQ #

1. 问题：导出的客户画像数据在服务器可以保存多久？
   答案：导出的源文件在服务器保存7天，邮件里的下载链接24小时内有效，我们在多个电商客户的实践中发现，建议下载后本地备份，避免后续需要时文件过期。

2. 问题：单次最多可以导出多少条数据？
   答案：控制台单次导出最多支持100万条，超过这个量级的话需要联系技术支持申请离线导出，离线导出最大支持1亿条数据。

3. 问题：什么情况下不建议使用控制台导出功能？
   答案：如果需要每天自动同步客户画像数据到你的CRM系统，不建议用控制台手动导出，建议使用HiAgent的开放数据推送API，自动定时推送数据，避免人工操作的遗漏。

4. 问题：我可以跳过标签配置步骤直接导出数据吗？
   答案：可以，但默认只会导出10个基础标签，不会包含你需要的自定义业务标签，导出的数据无法满足运营分析需求，我们不建议跳过标签配置步骤。

5. 问题：导出的数据包含用户的手机号等敏感信息吗？
   答案：默认不会导出敏感信息，如果你需要导出敏感字段，需要先在权限中心申请敏感数据导出权限，审批通过后导出的文件才会包含对应字段。

[7] 相关阅读 #

• 《HiAgent 3.0开放API接口文档》[/docs/hagent/api-v1/overview]，介绍如何通过API自动同步客户画像数据，无需手动导出；
• 《HiAgent 3.0标签自定义规则配置指南》[/blog/hagent-tag-config]，教你如何配置更复杂的自定义画像标签，满足个性化业务需求；
• 《HiAgent 3.0数据合规白皮书》[/docs/hagent/compliance/overview]，了解客户数据存储和导出的合规要求，避免合规风险；
• 《HiAgent 3.0实例版本差异对比》[/docs/hagent/version-diff]，了解不同版本支持的客户画像功能差异，按需升级实例。

[8] 参考资料 #

[1] 火山引擎HiAgent 3.0客户画像官方操作文档，https://www.volcengine.com/docs/hagent/666272/user-guide/customer-profile/config，2026-08-20
[2] 火山引擎HiAgent 3.0性能白皮书，https://www.volcengine.com/docs/hagent/666272/performance/white-paper，2026-07-15
本文基于HiAgent 3.0 v2.4版本编写。

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

2026-08-25