文档中心

数据智能体 DataAgent（私有化）

营销互动助手

意图规划引擎

意图规划引擎是营销互动助手的核心模块，旨在通过统一的意图配置和路由机制，对用户查询（query）进行智能识别和任务规划。创建意图规划引擎包括编排调试和创建意图的操作，引擎可发布为 API 供外部系统调用，本文为您介绍如何创建意图规划引擎。

新建意图规划引擎

登录营销 Agent 控制台，在左侧导航栏选择营销互动助手。
在营销互动助手左侧导航栏选择意图规划引擎，并在页面右上角单击新建意图规划引擎。

在我的意图规划引擎页面左侧编排 > 智能体配置区域，完成以下配置。

模块	配置项
基础信息配置	在我的意图规划引擎右侧单击编辑图标，可编辑头像、名称与描述。应用名称：必填，可自定义命名，字符限制50。应用描述：必填，可自定义对该意图规划引擎Agent的描述，字符限制200。头像：默认由系统生成，您也可以单击随机选择切换新头像。
模型配置	支持开启多模态识别能力，开启后，将支持图片多模态输入。问题改写模型：用于重写用户Query。 QA匹配模型：用于匹配用户输入的问题。意图识别模型：用于识别用户输入的意图。大模型回复模型：用于生成回复。展开该模型配置，支持开启深度思考功能。多意图自主规划模型：用于根据用户输入的意图，自主规划执行步骤。对话引导问模型：用于生成对话引导问。模型兜底：思考兜底模型：主思考模型不可用时的替代选项。深度思考：开启后模型将使用深度思考模式。通用兜底模型：除思考之外的其他模型不可用时的通用替代选项。人设提示词：默认填充限制规则，可按需进行更改。例如设定人设风格、智能体的回复范围。
知识	知识可以配置术语和QA问答，用于辅助意图规划引擎进行意图识别术语：支持关联知识库中类型为【术语库】的知识库，术语库中维护的是专业名称-名词解释。当用户query中包含术语名词时，会将术语解释召回，给到意图规划引擎辅助意图识别判断。术语不会改写query，也不会给到下游智能体； QA问答：支持关联知识库中类型为【问答库】的知识库，问答库中维护的是标准QA问答对，若意图规划引擎关联了问答库，用户query会同步在问答库中进行相关性检索，若有匹配到对应QA对，则会拦截意图推理，直接以QA对的标准问答进行回复；
记忆	记忆可按需配置用户的对话轮数、短期记忆和长期记忆。短期记忆：开启后，将历史会话原文和历史会话的概述给到智能体作为上下文输入。对话轮数：意图识别时滚动召回的上下文轮数，上下文对话信息在query改写和意图识别时都会作为补充信息。长期记忆：对用户画像、偏好和事件进行自动提取记录，长期记忆暂不支持导入自有画像数据。记忆库：从会话记忆库中指定当前需要使用的记忆库。记忆库使用规则：可选择读取记忆（允许智能体读取该记忆库中的历史记忆）、写入全局记忆（允许智能体将本次对话内容沉淀为全局通用的画像记忆/事件记忆），支持多选。
策略规则	策略规则配置是意图规划引擎的意图识别策略和规划策略问题改写策略：结合上下文对用户问题进行改写，可选择不同策略来平衡识别准确率与耗时。关闭：不改写问题直接进行识别，速度最快，适用于提问标准的场景。先改写后意图识别：意图识别效果更好，会增加识别耗时（约1s）。适用于意图识别准确率要求高的场景同步进行改写和意图识别：意图识别更快，准确率会有一定下降，适用于需要改写query作为下游输入且识别耗时低的场景将改写后问题传入下游整体：问题改写策略非关闭选项需要配置，开启后，下游智能体将接收改写后的新问题，否则接收用户输入的原始问题。智能体轨迹记忆：开启后，需配置记忆有效时长。智能体将会记住所有用户原始问题与对应意图。类似问题直接命中无需重复推理，从而提升速度并节省算力成本。工作流记忆：开启后，规划-行动型智能体将缓存历史规划路径，相似问题可直接命中缓存，无需重新规划。开启后还需要配置工作流泛化记忆开关，该开关开启后，工作流记忆匹配度低的规划，由 LLM 进一步判断是否可以复用。多意图处理策略：关闭：不进行多意图拆解，仅匹配最主要或单一意图。自主规划：当命中多个意图时，由大模型自动编排、串联并合并回复。选择该选项后，需要在下方自主规划回复提示词输入框内，查看或编辑提示词。澄清引导：当命中多个意图且无法确定时，让智能体主动反问用户，进行澄清。实体提取：识别用户问题中的业务对象，并透传给下游智能体运行上下文。可选择开启自动注入开关。单击加号（+），在新增实体弹窗内，完成以下配置，添加实体。实体名称：自定义实体名称，如客户、商品、订单、门店。实体描述：自定义描述信息，如业务含义、可接受表达、识别边界等。提取说明：实体提取的说明信息，如只识别 OD 开头的订单号。绑定术语库：选择一个或多个术语库进行绑定识别，若不绑定则直接通过大模型识别。
语音互动	语音互动包含以下两个功能开关，按需开启。语音转文字：开启后，用户可以通过语音输入与智能体互动。语音合成：开启后，智能体回复支持转换为语音播放。支持自定义音色。支持开启默认自动播报。如遇 API Key 参数缺失或无效的提示，请联系企业超级管理员配置语音识别（ASR）、语音合成（TTS）所需的参数。
对话配置	配置意图规划引擎Agent作为统一回复出口的对话回复策略开场白：非必填，长度限制500字符。开场白问题：默认开关关闭，开启后可增加开场白问题，最多可配置5个开场白问题。对话引导问题：默认开关关闭，开启后可配置引导问提示词，长度限制500字符。当下游Agent返回时以下游返回为准。提示语：固定的提示语，可配置展示在答案输出前或输出后。通常作为风险提示展示在答案输出后。
安全策略配置	支持对接火山引擎的大模型应用防火墙功能，以确保模型输入和输出内容安全、可用和可信。 AK、SK、服务器地址、防火墙 ID、区域等参数配置信息的获取方式，请参见大模型应用防火墙关键参数说明。是否校验请求内容：开启后将校验请求内容是否安全合规。是否校验LLM输出：开启后将校验大模型输出内容是否安全合规。命中风控提示语：使用安全服务的内容生成：使用大模型应用防火墙的内功生成提示语。使用自定义安全提示语：您需要在输入框内自定义提示语。
超时配置	设置调用下游子智能体的超时时间，单位：秒。

调试与预览

在我的意图规划引擎页面右侧调试与预览区域，向意图规划引擎智能体提问，测试意图配置。

支持开关配置仅回复命中意图，开启后调试过程不会真实调用下游Agent或其他执行动作。
点击自定义参数，支持自定义配置参数，包括Header和Body的配置。可配置输入的请求参数，用于模拟真实业务场景的调用。
（可选）若开启了多模态识别能力，则支持上传图片附件，一次请求可上传最多 5 张图片，图片大小不能超过 20 MB。
回复结果系统。
1. 命中意图名称。
2. 重写查询：改写后的query。
3. 选择依据：判定命中该意图的原因。
4. 回复结果：下游智能体的返回结果，若为多意图规划会返回子智能体的思考+回复，以及总结回复。
5. 查看 Trace：回话结尾支持查看 Trace。
  
  点击后跳转至 Trace 页面，在详情页可查看：
  - 调用树：完整的执行链路，单击某一 Span，可查看对应的 Run、Metadata 数据。
  - Run：展示所选 Span 的输入和输出数据，页面右侧展示链路状态、SpanID、类型等详细数据。
  - Metadata：以 JSON 格式展示所选 Span 的所有元数据。

意图管理

在我的意图规划引擎页面左侧编排 > 意图管理区域，管理该意图规划引擎智能体下的所有意图。

意图卡片按更新时间倒序展示，展示信息包含：
- 意图名称：意图名称信息
- 意图 ID：意图的唯一标识
- 业务场景：意图配置的业务场景
- 开启状态：仅开启的意图生效，点击开关可调整意图开启状态，新建后的意图默认为开启。编辑后意图开启状态不变；
- 意图描述：意图配置的描述，注意新建意图时，建议详细写清楚什么场景命中当前意图，大模型会参照该信息进行推理
- 更新时间：意图最后的更新时间
- 创建人：意图创建人信息
- 鼠标悬浮在卡片上之后，支持编辑与删除
  注意
  - 意图一旦被删除无法恢复，请谨慎操作。
  - 兜底意图不支持删除。
意图列表可以按【意图名称】和【业务场景】模糊搜索

新建意图

在意图管理区域的右上角单击新建意图，或点击卡片编辑进入意图编辑页面。

说明

意图分类，尽可能细致，覆盖完整的业务场景。
各意图之间不重不漏，不要有模糊不清的情况。

参数	参数说明
意图名称	意图名称信息。100个字符以内。注意一定要贴近实际的业务划分，大模型会参照这个信息来进行推理。
意图ID	自动生成，用于业务系统规则判定，作为意图的唯一身份。
业务场景	意图配置的业务场景。输入时模糊匹配已有场景，可手动选择，也可输入新的场景，长度限制50字符；业务场景为意图的一级分类，用于快速划分和匹配。
意图匹配方式	一个意图只能选择一种匹配方式，但一个智能体可以存在多个意图，每个意图的匹配方式可以不同。自定义规则的匹配速度会显著高于自然语言推理。自然语言推理：长度限制2000字符。意图描述是进行意图匹配判定的核心配置项，模型会基于该意图描述的语义与用户的问题进行匹配，判定用户问题是否命中该意图。详细教程见意图编写技巧。自定义规则：支持通过代码规则配置的方式配置意图的匹配规则。适用于通过指定参数判定意图或指定正则规则判定意图的场景。例如：某个渠道进来的用户无论提问什么，都命中指定意图。
示例问题	非必填，长度限制200字符，最多可添加30条。建议您配置示例问题，能够让意图识别的更准。
执行动作	配置命中该意图后的执行动作：智能体执行：通过外部智能体注册到总控平台上的外部智能体，或新建的自主规划智能体，具体操作请参见注册外部智能体和新建自主规划智能体；也支持选择官方智能体。知识库检索：可选择知识库中的【通用知识库】和【QA问答库】两种知识类型，命中意图后会按系统提示词设置，从知识库中召回知识进行总结回复；直接回复：配置固定话术，命中意图后直接回复固定话术，长度限制500字符。大模型直接回复：指定提示词，由大模型按提示词直接回复。自主规划：依次设置规划模型、MCP工具、智能体工具、Skills，并自定义模型规划提示词。通过大模型自主进行任务规划拆分，并回复问题。
异常兜底	开启后，当执行动作调用失败时，将自动切换到兜底执行动作。智能体执行：通过外部智能体注册到总控平台上的外部智能体，或新建的自主规划智能体，具体操作请参见注册外部智能体和新建自主规划智能体。知识库检索：可选择知识库中的【通用知识库】和【QA问答库】两种知识类型，命中意图后会按系统提示词设置，从知识库中召回知识进行总结回复；直接回复：配置固定话术，命中意图后直接回复固定话术，长度限制500字符。大模型直接回复：指定提示词，由大模型按提示词直接回复。自主规划：依次设置规划模型、MCP工具、智能体工具、Skills，并自定义模型规划提示词。通过大模型自主进行任务规划拆分，并回复问题。

导出意图

在意图管理区域，支持将所有意图参数配置导出到本地使用。

保存与发布

完成意图规划引擎的编辑与调试后，在页面右上角可选择保存或保存并发布。

保存：仅保存当前意图规划引擎的配置信息，但不发布意图规划引擎。在意图规划引擎列表中，当前意图规划引擎处于未发布状态。
保存并发布：
1. 在发布弹窗中，确认版本号信息（首个版本号为 V1），并添加版本描述。
2. 成功发布后，在意图规划引擎列表中，当前意图规划引擎处于已发布状态。
  
  在意图规划引擎卡片中支持发布或取消发布。