意图规划引擎是营销互动助手的核心模块，旨在通过统一的意图配置和路由机制，对用户查询（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小时、永久 工作流记忆：开启后，规划-行动型智能体将缓存历史规划路径，相似问题可直接命中缓存，无需重新规划 工作流泛化记忆：开启工作流记忆后需要配置，开启后，工作流记忆匹配度低的规划，由 LLM 进一步判断是否可以复用 多意图识别：关闭则用户query仅能命中一个意图，若命中多个会要求模型在命中意图和兜底意图中选择一个。开启后，用户一个问题命中多个query，且命中原因不同。会按照配置的执行策略进行执行： 澄清：基于用户命中的意图进行引导澄清，引导用户进行选择； 自主规划：基于用户命中的意图进行规划，先生成执行规划后调用对应动作。会将返回的回答进行总结回复。
   对话配置	配置意图规划引擎Agent作为统一回复出口的对话回复策略 开场白：非必填，长度限制500字符。 开场白问题：默认开关关闭，开启后可增加开场白问题，最多可配置5个开场白问题。 对话引导问题：默认开关关闭，开启后可配置引导问提示词，长度限制500字符。当下游Agent返回时以下游返回为准。 提示语：固定的提示语，可配置展示在答案输出前或输出后。通常作为风险提示展示在答案输出后。
   安全策略配置	支持对接火山引擎的大模型应用防火墙功能，以确保模型输入和输出内容安全、可用和可信。 AK、SK、服务器地址、防火墙 ID、区域等参数配置信息的获取方式，请参见大模型应用防火墙关键参数说明。 是否校验请求内容：开启后将校验请求内容是否安全合规。 是否校验LLM输出：开启后将校验大模型输出内容是否安全合规。 命中风控提示语： 使用安全服务的内容生成：使用大模型应用防火墙的内功生成提示语。 使用自定义安全提示语：您需要在输入框内自定义提示语。

调试与预览 #

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

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

意图管理 #

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

1. 意图卡片按更新时间倒序展示，展示信息包含：
   • 意图名称：意图名称信息
   • 意图 ID：意图的唯一标识
   • 业务场景：意图配置的业务场景
   • 开启状态：仅开启的意图生效，点击开关可调整意图开启状态，新建后的意图默认为开启。编辑后意图开启状态不变；
   • 意图描述：意图配置的描述，注意新建意图时，建议详细写清楚什么场景命中当前意图，大模型会参照该信息进行推理
   • 更新时间：意图最后的更新时间
   • 创建人：意图创建人信息
   • 鼠标悬浮在卡片上之后，支持编辑与删除

     注意

     • 意图一旦被删除无法恢复，请谨慎操作。
     • 兜底意图不支持删除。
     
2. 意图列表可以按【意图名称】和【业务场景】模糊搜索
   • 意图名称：模糊搜索
   • 业务场景：下拉，多选，默认全部

新建意图 #

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

保存与发布 #

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

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

在意图规划引擎列表中进入指定意图规划引擎详情页，在页面右上角单击版本号，即可查看当前意图规划引擎的历史版本信息。

• 草稿版本：当前正在编辑的暂未发布的版本。
• 线上版本：已保存配置且已发布的版本。

切换至历史版本后，支持通过复刻功能，回滚历史版本数据。

在意图规划引擎列表中，选中指定卡片，支持以下操作：

• 编辑：进入意图规划引擎详情页，支持修改智能体配置、调试智能体、管理意图。
• 复制：基于当前意图规划引擎的配置，快速复制一个新的意图规划引擎，复制期间支持调整各配置项。
• 删除：不再需要使用的意图规划引擎支持删除。

已发布的意图规划引擎支持以 API 方式接入下游业务平台，使平台用户可以使用意图规划引擎的智能问答功能。

1. 在意图规划引擎列表，选中指定已发布的卡片，并在卡片上单击 API 地址。
   
2. 在发布 API 弹窗中，可获取 API 地址和 API 秘钥，用于接入下游业务平台。
   
   您也可以单击预览，调试当前意图规划引擎的智能问答能力是否符合预期。