创建与调试侧写助手--数据智能体 DataAgent（私有化）-火山引擎

文档中心

数据智能体 DataAgent（私有化）

管理侧写库

创建与调试侧写助手

使用一客一策功能，需要先创建侧写助手，根据业务需求自定义工作流以及节点，设置好对应的数据源、知识库等模块，这是精准洞察用户，制定个性化营销策略的基础，适用于业务部门（依赖预置模板）和中台 IT 部门（可自定义配置），典型场景包括营销策略生成、用户画像分析、企业侧写生成等。其核心价值在于提升配置灵活性、提高策略生成效率、保护核心知识资产。本文为您介绍如何创建一客一策的侧写助手。

前提条件

已完成准备工作，详情参见准备工作。

创建侧写助手

登录营销Agent控制台，在左侧导航栏选择一客一策引擎。
在页面左侧选择档案生产 > 侧写库。
在侧写助手页签内，单击新建侧写助手。

填写相关参数，单击保存。

参数	说明
助手名称	自定义名称，不能超过 50 个字符。用于在侧写库中快速识别和管理不同的侧写助手。
助手功能描述	自定义描述，不能超过 100 个字符。用于简要说明该助手的功能，方便团队成员快速了解其用途。
行业模板	支持默认、ToC零售、ToB直销、ToC物流。不同的模板后面系统配置侧写助手的流程和节点不同。默认：即内置的节点只有最基础的节点，且未内置侧写助手流程，您可以自行配置。 ToC零售：内置了多种 ToC 零售常用的节点，并配置了侧写助手的流程。 ToB直销：内置了多种 ToB 直销常用的节点，并配置了侧写助手的流程。 ToC物流：内置了多种 ToC 物流常用的节点，并配置了侧写助手的流程。
主体	根据需要选择相应的主体。

在助手的详情页里，配置助手信息。

模块	配置项	说明
助手配置	数据主体	默认为新建助手时选择的主体，支持修改。
应用场景	场景模板	默认为新建助手时选择的模板，支持修改，修改后侧写助手默认配置的节点会改变。
应用场景	场景描述	填写应用场景的描述，该描述用于后续具体执行的效果。
数据与特征	用于构建特征数据	借助特征，助手能从基础数据扩展到更丰富的用户画像，充分理解用户的行为规律与消费习惯。添加数据档案：该数据档案会作为侧写助手的数据源。包括主体属性、明细属性、用户行为等 CDP 数据档案。添加数据标签：该数据标签会作为侧写助手的数据源。
数据与特征	基于数据构建特征	将用户的原始数据通过清洗浓缩提取特征数据后，输入到侧写助手，提高侧写助手的准确度。支持接入结构化数据，包括埋点数据、行为数据，并将数据构建为特征。在添加特征界面，单击创建特征。创建的特征在各个侧写助手之间共用。填写特征指标的名称和描述。点击基于描述生成，系统会根据描述自动生成特征指标的 SQL，您可以基于生成的 SQL 进行优化。点击格式化，系统会规范 SQL 的写法，使其便于系统录入。点击解析，系统会测试该 SQL 是否可用。点击预览，系统会展示该 SQL 的结果。返回添加特征页面，支持批量选择特征。说明您也可以联系火山引擎技术人员帮助您构建特征指标。

配置侧写助手。
不同模板默认配置了不同的节点与流程，您可以根据实际情况进行编辑：支持新增自定义节点（如大模型节点、代码节点）和内置节点（如长期特征画像生成、营销策略生成等），并提供节点配置能力（包括工具选择、模型选择、提示词输入、输入输出配置等）。

点击添加节点，添加内置的节点，不同的应用场景模板内置的节点不一样。
添加节点后，您可以通过拖拽节点间的连线来设置工作流的执行顺序，确保节点能够按照业务逻辑依次运行。

点击节点，可编辑修改该节点的信息，配置工具。
系统集成实体元信息获取工具、实体信息获取工具、知识检索工具、clickhouse SQL 执行工具、思考工具、商品信息查询工具、交叉分析 SQL 执行工具、深度洞察 Deepresearch 工具、商品检索工具等。工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。

各节点介绍如下：

节点名称	描述	配置项
DeepResearch	所有场景都内置该节点。通过深度洞察能力，对输入数据进行深度分析与信息检索，输出分析报告。适用场景：需要对用户数据进行深度挖掘与多维分析时使用，如输出商品分析报告、消费者行为习惯分析报告、用户偏好洞察等。适合在侧写流程早期阶段，为后续节点提供充分的信息支撑。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。输入：选择输入的内容，包括用户属性、手动输入或上游节点。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输出：输出变量名称。
上下文压缩	所有场景都内置该节点。对上游节点输出的长文本内容进行压缩精简，保留关键信息，减少后续节点的上下文长度，提升处理效率。适用场景：当上游节点（如DeepResearch）输出内容过长，超出下游节点的上下文窗口限制时使用。常放置在信息检索节点之后、侧写生成节点之前，确保关键信息被保留的同时减少冗余。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。输入：选择输入的内容，包括用户属性、手动输入或上游节点。输出：输出变量名称。
大模型	所有场景都内置该节点。通用的大语言模型推理节点，支持自定义提示词，可灵活用于各类文本生成、分析、推理任务。适用场景：需要自定义推理逻辑的任何环节，如自定义分析维度、生成特定格式的输出、对数据进行归纳总结、执行复杂的推理判断等。适合对现有模板节点无法覆盖的个性化需求进行补充。	所有场景都内置该节点。模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。提示词：通用大模型推理节点，用于接收输入并调用 LLM 完成文本生成、推理或转换。可编辑修改默认的提示词提高大模型的准确度。输入：选择输入的内容，包括用户属性、手动输入或上游节点。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到 MCP 功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输出：输出变量名称。
代码	所有场景都内置该节点。支持编写自定义代码逻辑，用于数据处理、格式转换、条件判断等场景，提供测试能力，支持多个输出变量。适用场景：需要对数据进行结构化处理时使用，如JSON解析、字段提取与拼接、数值计算、数据格式转换、复杂条件筛选等。适合在数据流转过程中做中间加工处理。	所有场景都内置该节点。模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。代码：点击配置，放大示例代码进行编辑，然后点击保存。提示词：代码执行节点，用于执行用户自定义逻辑。可编辑修改默认的提示词提高大模型的准确度。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：选择输入的内容，包括用户属性、手动输入或上游节点。输出：输出变量名称。
选择器	所有场景都内置该节点。IF条件选择器节点，根据设定的条件对数据进行分支路由，实现工作流的条件分支逻辑。适用场景：当工作流需要根据不同条件执行不同路径时使用，如根据用户类型（新客/老客）走不同的侧写策略，或根据数据完整度选择不同的分析流程。	支持设置条件表达式，根据上游节点输出进行条件判断，选择不同的下游节点执行路径。
工具	所有场景都内置该节点。工具调用节点，可调用系统集成的各类AI应用工具（如实体信息获取、知识检索、商品信息查询、交叉分析SQL执行等），实现数据查询与外部能力对接。适用场景：需要从外部系统获取数据时使用，如查询商品详情、检索知识库内容、执行数据库SQL查询、获取实体元信息等。适合在分析前补充必要的业务数据。	工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。工具参数：不同工具包含不同的参数，您需要根据实际情况完善参数信息。输出：输出变量名称。
长期特征画像生成	ToC零售应用场景模板内置该节点。对输入的长期特征进行整合与总结，滤除无关及冗余信息，构建精准、稳定的长期特征画像。适用场景：需要基于用户长期积累的属性、标签和特征数据，生成稳定的用户画像时使用。如分析用户的长期消费习惯、品类偏好、价格区间等不随短期波动变化的特征。建议输入：用户属性、标签、特征节点输出：用户长期特征画像总结	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
短期特征画像生成	ToC零售应用场景模板内置该节点。对输入的短期特征进行筛选总结、滤除无关信息，快速构建聚焦当下的对象特征画像。适用场景：需要捕捉用户近期行为变化、实时兴趣信号时使用。如分析用户近7天/30天内的浏览偏好、新增关注品类、促销敏感度变化等即时特征。建议输入：用户属性、标签、特征节点输出：用户短期特征画像总结	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
长期侧写生成	ToC零售应用场景模板内置该节点。基于用户长期行为数据与多维度特征，构建动态、全面的用户画像。适用场景：需要对用户进行全面深度刻画时使用，综合长期行为数据生成完整的用户侧写报告，包括消费能力、生活方式、品牌忠诚度、决策模式等维度，为营销策略制定提供全面依据。建议输入：用户属性、标签、特征节点输出：用户长期侧写	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
短期侧写生成	ToC零售应用场景模板内置该节点。捕捉短期行为轨迹中的关键信号，快速构建其短期行为偏好与即时需求画像。适用场景：需要了解用户当前阶段的即时需求与行为偏好时使用，如识别用户近期是否有购买意向、正在关注什么品类、是否处于决策期等，为实时触达提供依据。建议输入：用户属性、标签、特征节点输出：用户短期侧写工具建议：搭配产品信息工具提高分析质量	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
营销建议生成	ToC零售、ToB直销应用场景模板内置该节点。通过匹配客户画像，精准输出适配的产品组合及专属权益策略。适用场景：侧写完成后，需要为用户制定个性化营销方案时使用。根据用户画像匹配合适的产品推荐、优惠券组合、会员权益等，实现千人千策的精准营销。建议输入：用户侧写节点输出：个性化营销策略工具建议：提供必要的产品工具、权益工具	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
企微营销文案生成	ToC零售应用场景模板内置该节点。结合策略中的产品卖点、权益配置及目标客户特征，输出贴合企微场景、具备说服力的文案内容。适用场景：营销策略确定后，需要生成企业微信触达文案时使用。输出适合企微私聊/朋友圈场景的营销话术，语言风格贴近1对1沟通，注重互动性和亲和力。建议输入：用户侧写、个性化营销策略节点输出：企微营销文案	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
短信营销文案生成	ToC零售应用场景模板内置该节点。结合策略中的产品卖点、权益配置及目标客户特征，输出贴合短信场景、具备说服力的文案内容。适用场景：营销策略确定后，需要生成短信触达文案时使用。输出符合短信字数限制、包含关键利益点和行动号召的精简文案，适用于批量短信营销推送。建议输入：用户侧写、个性化营销策略节点输出：短信营销文案	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
企业联网搜索	ToB直销应用场景模板内置该节点。调用公开数据检索能力，针对目标企业进行全网信息采集。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
企业画像生成	ToB直销应用场景模板内置该节点。整合用户属性、特征、标签，以及企业联网搜索结果等数据，生成用户画像报告。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
企业侧写生成	ToB直销应用场景模板内置该节点。基于企业联网搜索、企业画像数据，构建用户行为分析报告、消费意图和偏好报告。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
购买意图生成	ToB直销应用场景模板内置该节点。基于侧写报告，智能挖掘用户潜在的购买意图，输出意图置信度等级、驱动因素、适配产品匹配建议等内容，支持按置信度排序。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
营销文案生成	ToB直销应用场景模板内置该节点。基于侧写报告、购买意图，自动生成个性化营销文案。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
司机侧写生成	ToC物流应用场景模板内置该节点。根据司机特征数据，生成司机行为画像报告。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
候选线路粗筛分析	ToC物流应用场景模板内置该节点。基于司机画像，进行候选线路粗排过滤任务，从候选线路中筛选出10条最适合的线路。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。
订阅线路推荐方案生成	ToC物流应用场景模板内置该节点。在粗筛候选线路的基础上，结合司机画像、路线情况等信息，生成个性化线路推荐方案。	模型：大语言模型，可从企业已配置的模型中进行选择。若选项中的模型无法满足您的需求，可联系火山引擎技术人员。工具：根据您的具体场景选择系统提供的AI应用工具，提高侧写助手对接入数据分析的准确度。点击跳转图标，可以跳转到MCP功能模块添加工具，工具（MCP）的创建等操作说明，请参见营销互动助手的 MCP 介绍。例如您需要输出商品分析报告，可以选择商品召回工具；您需要消费者的行为习惯分析报告，可以选择实体信息查询工具、商品召回工具和商品信息检索工具。输入：默认内置手动输入信息，支持自定义修改输入配置。输出：输出变量名称，模板自带为output。