You need to enable JavaScript to run this app.
数据智能体 DataAgent(私有化)

数据智能体 DataAgent(私有化)

复制全文
创建与配置智能分析Agent
内容配置
复制全文
内容配置

本文为您介绍创建与配置智能分析Agent时,内容配置相关的配置指导。

背景信息

配置内容分为取数推荐问题、分析推荐问题、PC端、飞书端四个模块。

  • 取数推荐问题:支持设置用户或飞书群的取数相关推荐问题。
  • 分析推荐问题:支持设置数据分析相关推荐问题。
  • PC端:用户进入 PC 端智能体首页后展示的总结消息。
  • 飞书端:用户进入飞书端智能体机器人后展示的欢迎卡片和主动推送消息。

说明

推荐问题:添加后的推荐问题将会展示在智能体的默认消息卡片中,智能体的用户可以通过推荐问题快速获取业务所需要的数据。

配置取数推荐问题
  1. 进入智能体配置页面,在左侧选择「内容配置」,选择进入取数推荐问题配置页。
    Image

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

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

    参数

    配置说明

    配置名称

    设置推荐问题配置名称。

    推荐问题-添加模糊问题

    • 支持配置多个模糊问题,且模糊问题支持配置细分的拆解问题和拆解问题关联的数据集。

      说明

      • 智能分析Agent还为您提供了意图澄清功能,当用户问题模糊时,智能体可基于意图澄清规则对用户进行反问澄清,便于进一步明确问题,详情请参见意图澄清配置
      • 涉及查询数据场景时,建议问题包含查询数据的时间、筛选条件等关键组成部分,详情可参见最佳实践:提问建议与示例
      • 对每一个拆解问题,需要绑定数据集,智能体会根据拆解问题绑定的数据集召回数据进行回答。
      • 当一个模糊问题配置多个拆解问题时,用户点击某个问题,会同时展示所有拆解问题的查询结果。
        Image
    • 支持设置模糊问题的问题泛化开关。
      配置一个问题的拆解思路,开启问题泛化后,拆解思路对相似的问题也会生效。例如:配置了“分析各大区的销售状况”的拆解思路,开启泛化后,“分析各省份/各城市的销售状况”也会复用拆解思路。

    推荐问题-添加非模糊问题

    支持配置多个非模糊问题,并设置非模糊问题关联的数据集。

配置分析推荐问题

智能体配置页面,在左侧选择「内容配置」,选择进入分析推荐问题配置页。点击「添加问题」,在弹出的参数配置界面设置推荐问题并选择关联知识。配置好后点击「保存」。
Image

配置PC端

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

配置飞书端

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

欢迎卡片

飞书端智能体欢迎卡片是用户首次使用智能体时的欢迎卡片,可以添加一些智能体的介绍。
Image
支持用户在飞书卡片搭建工具配置卡片后,复制 Json 代码到这里快捷配置。飞书卡片配置请参见飞书卡片概述
Image

主动推送

分析Agent支持通过飞书卡片主动推送深度研究报告,并支持推送时打开MCP开关。本节将介绍如何设置飞书主动推送卡片。

前提条件

如需在推送时打开MCP开关,需确保系统级或Agent级已打开MCP开关,配置详情请参见MCP 服务管理

操作步骤

  1. 进入智能体配置页面,在左侧选择「内容配置」,在「飞书端」配置页面,找到「飞书端主动推送设置」模块,在这里可以配置主动推送。
    Image

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

    参数项

    配置说明

    主动推送标题

    自定义推送卡片标题,展示效果如下:
    Image

    推送频次

    设置推送频率及时间,智能助手将在设定的时间开始执行任务,您可根据业务需求设置推送频率。
    您也可根据您的数据就绪状况设置立即推送或数据就绪后推送。

    • 立即推送:如果您的数据就绪时间确定,您可将推送频次中的时间设置为数据就绪时间,并选择在该时间点立即推送。智能体会检查数据就绪状态,在数据就绪后立即推送数据。
    • 数据就绪后推送:如果您的数据就绪时间不确定,可选择该选项,智能体在推送前会查询数据就绪状态,在数据就绪后查询并推送数据。

    注意

    如果总结报告生成失败,智能体将每小时重试一次,最多重试24次,过多重试将会产生风暴,因此强烈不建议设置为每小时推送。

    描述

    自定义该推送的备注说明,将仅在配置页面显示。

    推送用户

    设置该卡片推送的目标用户。该用户来源于您在集成飞书端时设置的可用成员,配置详情请参见第三步:添加智能体的可用成员
    按用户推送时,分析Agent将为每位用户单独生成一份报告,报告内容可能存在差异。

    注意

    • 推送用户、共享推送、推送飞书群三种推送方式任选其一设置即可。
    • 按用户推送时,由于智能助手为每位用户单独生成报告,因此,当您设置的推送用户较多时,任务执行时间可能会较长,收到报告的时间将会延迟。

    共享推送

    用于向多个人推送同一份报告。使用共享推送时,分析Agent会将同一份报告推送给您设置的所有用户。
    操作步骤

    1. 单击「添加」,在目标用户群体中搜索飞书用户,单击并添加。
    2. 设置权限依据人,分析Agent将为目标用户授予该权限依据人所拥有的报告权限。

    推送飞书群

    【推荐】向指定飞书群组推送卡片。
    使用飞书群推送时,分析Agent会将同一份报告推送给您设置的飞书群。
    操作步骤

    1. 在飞书群中添加智能体机器人。在飞书群右上角单击「...」,单击设置,单击「群机器人」,单击「添加机器人」,搜索您的智能体名称,单击「添加」。
    2. 在分析Agent内容配置的配置详情中,在推送飞书群中,单击「添加」,输入飞书群名称,从下拉列表中单击并添加该群组。
    3. 设置权限依据人,分析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

    • enablePushImage:设置为 true,表示将在推送卡片中展示报告截图。
    • imageType:设置截图类型,目前支持 htmlmarkdown
    • enablePushUrl:设置为 true,表示将在推送卡片中附上「完整报告」的跳转链接。
    • enablePushSummary:设置为 true,以在卡片中展示一段自动生成的摘要说明。
    • customSummaryPrompt:您可自定义报告总结的Prompt,用于提示大模型生成卡片上的总结内容,例如:
      "customSummaryPrompt": "总结成以下内容:观察期<YYYY-mm-DD>~<YYYY-mm-DD> VS 基准期<YYYY-mm-DD>~<YYYY-mm-DD> \n• 观察期【<指标名>】,对比基准期<上涨/下跌><指标变化值>,变化率 <指标变化率>\n"
      

    agentConfigs

    • enabledMCPServers:添加新增对象,填入 mcpServerNamemcpServerId,二者任选其一。
      • mcpServerName:填写拓展 MCP 名称。您可以在「MCP服务管理」中查看并复制所需的MCP服务名称。
      • mcpServerId:填写拓展 MCP ID。
    • tools
      • tool 数组内将需要启用的工具名称填入 name。您可在智能体的使用界面,单击「拓展」,查看并复制您使用的MCP服务的工具名称,复制下图示例的红框和黄框的值均可。
        Image
        支持配置多个工具,示例如下:

        "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

    必须保留为{}

  3. 配置完成后可发送预览,您可单击「发送预览」,查看配置的推送效果。
    Image
    推送卡片展示效果示例如下:
    Image

最近更新时间:2026.01.14 19:53:18
这个页面对您有帮助吗?
有用
有用
无用
无用