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

新建意图规划引擎 #

1. 登录营销 Agent 控制台，在左侧导航栏选择营销互动。

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

3. 在我的意图规划引擎的编排调试页面，完成以下配置。

   模块	配置项
   意图规划引擎配置	意图规划引擎名称：必填，可自定义命名，字符限制50。 描述：必填，可自定义对该意图规划引擎Agent的描述，字符限制200。 意图识别模型：用于识别用户输入的意图。 大模型回复模型：用于生成回复。展开该模型配置，支持开启深度思考功能。 多意图自主规划模型：用于根据用户输入的意图，自主规划执行步骤。 问题改写模型：用于重写用户Query。 对话引导问模型：用于生成对话引导问。 QA匹配模型：用于匹配用户输入的问题。 兜底通用模型：其他模型异常时，会使用的兜底通用模型。 兜底推理模型：其他模型异常时，会使用的兜底推理模型。展开该模型配置，支持开启深度思考功能。 人设提示词：默认填充限制规则，可按需进行更改。例如设定人设风格、智能体的回复范围。
   知识	知识可以配置【术语】和【QA问答】，用于辅助意图规划引擎进行意图识别 术语：支持关联知识库中类型为【术语库】的知识库，术语库中维护的是专业名称-名词解释。当用户query中包含术语名词时，会将术语解释召回，给到意图规划引擎辅助意图识别判断。术语不会改写query，也不会给到下游智能体； QA问答：支持关联知识库中类型为【问答库】的知识库，问答库中维护的是标准QA问答对，若意图规划引擎关联了问答库，用户query会同步在问答库中进行相关性检索，若有匹配到对应QA对，则会拦截意图推理，直接以QA对的标准问答进行回复；
   记忆	记忆可按需配置用户的对话轮数、短期记忆和长期记忆。 短期记忆：对较短时间周期内的信息进行摘要存储。 对话轮数：意图识别时滚动召回的上下文轮数，上下文对话信息在query改写和意图识别时都会作为补充信息。 长期记忆：对用户画像、偏好和事件进行自动提取记录，长期记忆暂不支持导入自有画像数据。 记忆库：从会话记忆库中指定当前需要使用的记忆库。 记忆库使用规则：可选择读取记忆（允许智能体读取该记忆库中的历史记忆）、写入全部记忆（允许智能体将本次对话内容沉淀为全局通用的画像记忆/事件记忆），支持多选。
   策略规则	策略规则配置是意图规划引擎的意图识别策略和规划策略 问题改写：开启后用户query会结合上下文和记忆信息进行改写，便于模型更好的识别意图。建议开启 问题改写时机：可选择先改写后意图识别、同步进行改写和意图识别 改写后问题作为下游智能体请求query：开启后会将改写后的query而非原始query给到下游智能体作为用户问题进行输入，建议关闭。改写后query可能会丢失原有query的部分情绪信息 自动缓存：开启后意图规划引擎会将用户query和意图进行自动缓存存储，存储的query为改写后query，便于后续进行缓存识别；按需进行开启或关闭 自动缓存有效时长：考虑到业务的变化，可选择自动存储的缓存有效期，有效期截止后会自动清除。可选当天、24小时、48小时、72小时、永久； 多意图识别：关闭则用户query仅能命中一个意图，若命中多个会要求模型在命中意图和兜底意图中选择一个。开启后，用户一个问题命中多个query，且命中原因不同。会按照配置的执行策略进行执行： 澄清：基于用户命中的意图进行引导澄清，引导用户进行选择； 自主规划：基于用户命中的意图进行规划，先生成执行规划后调用对应动作。会将返回的回答进行总结回复。
   对话配置	配置意图规划引擎Agent作为统一回复出口的对话回复策略 开场白：非必填，长度限制500字符。 开场白问题：默认开关关闭，开启后可增加开场白问题，最多可配置5个开场白问题。 对话引导问题：默认开关关闭，开启后可配置引导问提示词，长度限制500字符。当下游Agent返回时以下游返回为准。 提示语：固定的提示语，可配置展示在答案输出前或输出后。通常作为风险提示展示在答案输出后。

编排调试 #

输入query调试意图规划引擎Agent的配置和意图配置

1. 支持开关配置【仅回复命中意图】，开启后调试过程不会真实调用下游Agent或其他执行动作。
   
2. 点击设置图标，支持自定义配置参数，包括Header和Body的配置。可配置输入的请求参数，用于模拟真实业务场景的调用。
   
3. 回复结果
   1. 命中意图名称
   2. 重写查询：改写后的query
   3. 选择依据：判定命中该意图的原因
   4. 回复结果：下游智能体的返回结果，若为多意图规划会返回子智能体的思考+回复，以及总结回复
4. 点击调试输入框的设置按钮，可配置输入的请求参数，用于模拟真实业务场景的调用

意图管理 #

在意图规划页面顶部，单击意图管理，进入意图管理页面，可以管理该意图规划引擎Agent下的所有意图

1. 卡片形式按更新时间倒序展示配置的卡片信息，卡片展示
   • 意图名称：意图名称信息
   • 业务场景：意图配置的业务场景
   • 开启状态：仅开启的意图生效，点击开关可调整意图开启状态，新建后的意图默认为开启。编辑后意图开启状态不变；
   • 意图描述：意图配置的描述，一定要更详尽的写清楚什么场景算命中这个意图，大模型会参照这个信息来进行推理
   • 更新时间：意图最后的更新时间
   • 创建人：意图创建人账号
   • 删除：点击删除弹出二次确认弹窗
2. 意图列表可以按【意图名称】和【业务场景】模糊搜索
   • 意图名称：模糊搜索
   • 业务场景：下拉，多选，默认全部

新建意图 #

点击页面右上角【新建意图】按钮，或点击卡片编辑进入新建意图页面