本文为您介绍创建与配置智能分析Agent时,内容配置相关的配置指导。
背景信息
配置内容分为取数推荐问题、分析推荐问题、PC端、飞书端四个模块。
- 取数推荐问题:支持设置用户或飞书群的取数相关推荐问题。
- 分析推荐问题:支持设置数据分析相关推荐问题。
- PC端:用户进入 PC 端智能体首页后展示的总结消息。
- 飞书端:用户进入飞书端智能体机器人后展示的欢迎卡片和主动推送消息。
说明
推荐问题:添加后的推荐问题将会展示在智能体的默认的消息卡片中,智能体的用户可以通过推荐问题快速获取业务所需要的数据。
配置取数推荐问题
进入智能体配置页面,在左侧选择「内容配置」,选择进入取数推荐问题配置页。

进入编辑页面后,首先需要选择配置方式,当前支持「统一用户配置」和「用户差异化配置」。

- 「用户差异化配置」可以为每位智能体用户单独配置推荐问题;
- 「统一用户配置」则所有用户收到的推荐问题一致。
点击「新增推荐问题配置」,在配置弹窗处配置推荐问题即可,支持拖动调整顺序,此处问题的顺序即为后续智能体使用页面展示的推荐问题的顺序。

相关参数配置说明如下:
参数 | 配置说明 |
|---|
配置名称 | 设置推荐问题配置名称。 |
推荐问题-添加模糊问题 | - 支持配置多个模糊问题,且模糊问题支持配置细分的拆解问题和拆解问题关联的数据集。
说明 - 智能分析Agent还为您提供了意图澄清功能,当用户问题模糊时,智能体可基于意图澄清规则对用户进行反问澄清,便于进一步明确问题,详情请参见意图澄清配置(灰度中)。
- 涉及查询数据场景时,建议问题包含查询数据的时间、筛选条件等关键组成部分,详情可参见最佳实践:智能问数提问建议与示例。
- 对每一个拆解问题,需要绑定数据集,智能体会根据拆解问题绑定的数据集召回数据进行回答。
- 当一个模糊问题配置多个拆解问题时,用户点击某个问题,会同时展示所有拆解问题的查询结果。

- 支持设置模糊问题的问题泛化开关。
配置一个问题的拆解思路,开启问题泛化后,拆解思路对相似的问题也会生效。例如:配置了“分析各大区的销售状况”的拆解思路,开启泛化后,“分析各省份/各城市的销售状况”也会复用拆解思路。
|
推荐问题-添加非模糊问题 | 支持配置多个非模糊问题,并设置非模糊问题关联的数据集。 |
配置分析推荐问题
智能体配置页面,在左侧选择「内容配置」,选择进入分析推荐问题配置页。点击「添加问题」,在弹出的参数配置界面设置推荐问题并选择关联知识。配置好后点击「保存」。

配置PC端
进入智能体配置页面,在左侧选择「内容配置」,可以找到「PC端」,在这里点击右上角的编辑,即可配置PC端首页展示的文案;输入内容后,可以预览展示效果。

配置飞书端
用户需先完成飞书端智能体配置与测试,才可进入智能体配置页面,在左侧选择「内容配置」,看到「飞书端」页面。在此可设置飞书端欢迎卡片以及主动推送的内容。
欢迎卡片
飞书端智能体欢迎卡片是用户首次使用智能体时的欢迎卡片,可以添加一些智能体的介绍。

支持用户在飞书卡片搭建工具配置卡片后,复制 Json 代码到这里快捷配置。飞书卡片配置请参见飞书卡片概述。

主动推送
分析Agent支持通过飞书卡片主动推送深度研究报告,并支持推送时打开MCP开关。本节将介绍如何设置飞书主动推送卡片。
前提条件
如需在推送时打开MCP开关,需确保系统级或Agent级已打开MCP开关,配置详情请参见MCP 服务管理。
操作步骤
进入智能体配置页面,在左侧选择「内容配置」,在「飞书端」配置页面,找到「飞书端主动推送设置」模块,在这里可以配置主动推送。

单击「添加推送总结」,配置推送参数,将总结按设定的计划推送给指定用户或飞书群。配置完成后,单击「保存」,即可生效。

参数项 | 配置说明 |
|---|
主动推送标题 | 自定义推送卡片标题,展示效果如下:
 |
推送频次 | 设置推送频率及时间,智能助手将在设定的时间开始执行任务,您可根据业务需求设置推送频率。
您也可根据您的数据就绪状况设置立即推送或数据就绪后推送。 - 立即推送:如果您的数据就绪时间确定,您可将推送频次中的时间设置为数据就绪时间,并选择在该时间点立即推送。智能体会检查数据就绪状态,在数据就绪后立即推送数据。
- 数据就绪后推送:如果您的数据就绪时间不确定,可选择该选项,智能体在推送前会查询数据就绪状态,在数据就绪后查询并推送数据。
注意 如果总结报告生成失败,智能体将每小时重试一次,最多重试24次,过多重试将会产生风暴,因此强烈不建议设置为每小时推送。 |
描述 | 自定义该推送的备注说明,将仅在配置页面显示。 |
推送用户 | 设置该卡片推送的目标用户。该用户来源于您在集成飞书端时设置的可用成员,配置详情请参见第三步:添加智能体的可用成员。
按用户推送时,分析Agent将为每位用户单独生成一份报告,报告内容可能存在差异。 注意 - 推送用户、共享推送、推送飞书群三种推送方式任选其一设置即可。
- 按用户推送时,由于智能助手为每位用户单独生成报告,因此,当您设置的推送用户较多时,任务执行时间可能会较长,收到报告的时间将会延迟。
|
共享推送 | 用于向多个人推送同一份报告。使用共享推送时,分析Agent会将同一份报告推送给您设置的所有用户。 操作步骤: - 单击「添加」,在目标用户群体中搜索飞书用户,单击并添加。
- 设置权限依据人,分析Agent将为目标用户授予该权限依据人所拥有的报告权限。
|
推送飞书群 | 【推荐】向指定飞书群组推送卡片。
使用飞书群推送时,分析Agent会将同一份报告推送给您设置的飞书群。 操作步骤: - 在飞书群中添加智能体机器人。在飞书群右上角单击「...」,单击设置,单击「群机器人」,单击「添加机器人」,搜索您的智能体名称,单击「添加」。
- 在分析Agent内容配置的配置详情中,在推送飞书群中,单击「添加」,输入飞书群名称,从下拉列表中单击并添加该群组。
- 设置权限依据人,分析Agent将为目标飞书群中的用户授予该权限依据人所拥有的报告权限。
注意 通过群或组“订阅”推送存在安全风险,请谨慎使用: - 发送“订阅推送”时,不会对群组中的成员进行数据鉴权。
- 若群组内成员发生变化,“订阅推送“的接收人员范围随之变化,且新增成员可查看历史消息中的“订阅推送”。
|
主动推送总结 | 配置JSON脚本。当前推荐使用深度报告总结脚本,配置示例如下。 注意 填写时,需将脚本合并为一行。主动推送总结模块按行读取内容,因此需将脚本内容合并为一行,便于系统读取。 {"pushConfig":{"enablePushImage":true,"imageType":"html","enablePushUrl":true,"enablePushSummary":true,"customSummaryPrompt":"总结成以下内容:观察期<YYYY-mm-DD>~<YYYY-mm-DD> VS 基准期<YYYY-mm-DD>~<YYYY-mm-DD> \n• 观察期【<指标名>】,对比基准期<上涨/下跌><指标变化值>,变化率 <指标变化率>\n"},"questionType":"deep_research","contentParams":{},"name":"今年是 2025 年。\r\n基准周期日期 和 观察周期日期:前天 vs 昨天\r\n指定维度:xxx","agentConfigs":{"enabledMCPServers":[{"mcpServerName":"归因工具","tools":[{"name":"dimension_attribution","selected":true},{"name":"formula_attribution","selected":false},{"name":"公式拆解"},{"name":"trend_detection","selected":true}]}]}}
JSON脚本中的参数说明请参见下文。 |
主动推送总结JSON脚本语法及参数说明如下,此处为方便您查看JSON脚本,使用了换行和缩进,实际填充仅推送配置时,需将脚本内容合并为一行。
{
"pushConfig": {
"enablePushImage": true, // 卡片是否需要包含 html/markdown 格式的报告截图
"imageType": "html", // 报告截图格式,设置为 markdown 或 html
"enablePushUrl": true, // 卡片是否需要包含「完整报告」链接,可以直接跳转到报告展示页
"enablePushSummary": true, // 卡片是否需要包含一段内容,总结卡片主要内容
"customSummaryPrompt": "" // 用于提示大模型生成卡片上的总结内容
}, // 必填
"agentConfigs": {
"enabledMCPServers": [
{
"mcpServerName": "<拓展 mcp 名字>",
"tools": [
{ "name": "<mcp 工具名称>", "selected": true } // 是否选中某个工具
]
}
]
},
"questionType": "deep_research", // 必填 deep_research
"name": "<深度研究问题>", // 必填
"contentParams": {} // 必须包含
}
参数项 | 配置说明 |
|---|
pushConfig
| |
agentConfigs
| enabledMCPServers:添加新增对象,填入 mcpServerName 或 mcpServerId,二者任选其一。
mcpServerName:填写拓展 MCP 名称。您可以在「MCP服务管理」中查看并复制所需的MCP服务名称。mcpServerId:填写拓展 MCP ID。
tools:
在 tool 数组内将需要启用的工具名称填入 name。您可在智能体的使用界面,单击「拓展」,查看并复制您使用的MCP服务的工具名称,复制下图示例的红框和黄框的值均可。

支持配置多个工具,示例如下: "tools": [
{ "name": "dimension_attribution", "selected": true },
{ "name": "formula_attribution", "selected": false }, // 注意,这个工具没被选中
{ "name": "公式拆解" }, // selected 缺省是 true,所以「公式拆解」也被选中了
{ "name": "trend_detection", "selected": true }
]
selected:设置为 true即为选定,默认值为 true。
|
questionType
| 问题类型,固定为 deep_research。 |
name
| 填写您的深度研究问题。如果已配置分析模板,此处可填入常用/周期提问问题,详情请参见调优关键:分析任务知识。 |
contentParams
| 必须保留为{}。 |
配置完成后可发送预览,您可单击「发送预览」,查看配置的推送效果。

推送卡片展示效果示例如下:
